> ## Documentation Index
> Fetch the complete documentation index at: https://docs.calibrate.artpark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Traces

> Operations for traces

## Create trace

Store a production agent turn and its conversation history for later review

```bash theme={null}
calibrate traces create [flags]
```

**Options**

| Option                  | Type       | Description                                                                                                   |
| ----------------------- | ---------- | ------------------------------------------------------------------------------------------------------------- |
| `-a, --agent-id`        | string     | **Required.** ID of the agent that produced the turn. Must be an agent in your workspace                      |
| `-c, --conversation-id` | string     | Your own ID for the conversation this turn belongs to, stored for reference only. Omit if you have none       |
| `-i, --input`           | string     | JSON value (one of: string \| array of \{ role: string, content: string, AdditionalProperties: object })      |
| `--message-id`          | input      | Your own ID for the last user message in input, stored for reference only. Omit if you have none              |
| `--metadata`            | gen\_ai.\* | Key-value pairs stored with the trace. Prefer OTel gen\_ai.\* key names where they fit. Omit if you have none |
| `--output-param`        | string     | **Required.**                                                                                                 |

**Examples**

```bash theme={null}
calibrate traces create --agent-id <id> --input '[]' --output-param '{}'
```