Skip to content

ref(ai-agents-sdks): Document input truncation #16548

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dingsdax merged 3 commits into from
Feb 24, 2026
+7 −2
Merged

ref(ai-agents-sdks): Document input truncation #16548

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2f54e98
ref(ai-agents-sdks): Document input truncation
alexander-alderman-webb Feb 24, 2026
5f3d509
fix typos
alexander-alderman-webb Feb 24, 2026
bc6448e
wording
alexander-alderman-webb Feb 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions develop-docs/sdk/telemetry/traces/modules/ai-agents.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Additional attributes on the span:

| Attribute | Type | Requirement Level | Description | Example |
| :--------------------------------- | :----- | :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- |
| `gen_ai.input.messages` | string | optional | List of dictionaries describing the messages (prompts) given to the agent. **[0]**, **[1]** | `'[{"role": "user", "parts": [{"type": "text", "content": "..."}]}]'` |
| `gen_ai.input.messages` | string | optional | List of dictionaries describing the messages (prompts) given to the agent. **[0]**, **[1]**, **[6]** | `'[{"role": "user", "parts": [{"type": "text", "content": "..."}]}]'` |
| `gen_ai.tool.definitions` | string | optional | List of dictionaries describing the available tools. **[0]** | `'[{"name": "random_number", "description": "..."}, ...]'` |
| `gen_ai.system_instructions` | string | optional | The system instructions passed to the model. | `"You are a helpful assistant."` |
| `gen_ai.request.max_tokens` | int | optional | Model configuration parameter. | `500` |
Expand Down Expand Up @@ -112,7 +112,7 @@ Additional attributes on the span:

| Attribute | Type | Requirement Level | Description | Example |
| :--------------------------------- | :----- | :---------------- | :----------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- |
| `gen_ai.input.messages` | string | optional | List of dictionaries describing the messages (prompts) sent to the LLM. **[0]**, **[1]** | `'[{"role": "user", "parts": [{"type": "text", "content": "..."}]}]'` |
| `gen_ai.input.messages` | string | optional | List of dictionaries describing the messages (prompts) sent to the LLM. **[0]**, **[1]**, **[6]** | `'[{"role": "user", "parts": [{"type": "text", "content": "..."}]}]'` |
| `gen_ai.tool.definitions` | string | optional | List of dictionaries describing the available tools. **[0]** | `'[{"name": "random_number", "description": "..."}, ...]'` |
| `gen_ai.system_instructions` | string | optional | The system instructions passed to the model. | `"You are a helpful assistant."` |
| `gen_ai.request.max_tokens` | int | optional | Model configuration parameter. | `500` |
Expand Down Expand Up @@ -238,3 +238,8 @@ Some attributes are common to all AI Agents spans:
| `"openai"` | OpenAI |
| `"perplexity"` | Perplexity |
| `"xai"` | xAI |

**[6]**

The input list should include the most recent messages up to and including the most recent previous model response. The previous model response is identified with an "assistant" or "model" role in common frameworks. If there is no previous model response in the input list, then all input items which are not system instructions should be included. System instructions must be added in `gen_ai.system_instructions`, and are not included in the `gen_ai.input.messages` list.

Loading