Skip to content

ref(ai-agents-sdks): Add fallback span description when there is no agent name #16645

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

Open
alexander-alderman-webb wants to merge 2 commits into
base: master
Choose a base branch
from
Open

ref(ai-agents-sdks): Add fallback span description when there is no agent name #16645

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
31e19df
ref(ai-agents-sdks): Add fallback span description when there is not …
alexander-alderman-webb Mar 2, 2026
6ee93b1
.
alexander-alderman-webb Mar 2, 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
7 changes: 6 additions & 1 deletion 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 @@ -35,7 +35,7 @@ Describes AI agent invocation.
Agent invocations represent operations that can include multiple model calls, or some auxiliary work that goes beyond transforming the model input and output.

- Span `op` SHOULD be `"gen_ai.invoke_agent"`.
- Span `name` SHOULD be `"invoke_agent {gen_ai.agent.name}"`. (e.g. `"invoke_agent Weather Agent"`)
- Span `name` SHOULD be `"invoke_agent {gen_ai.agent.name}"`. (e.g. `"invoke_agent Weather Agent"`) **[8]**
- Attribute `gen_ai.operation.name` MUST be `"invoke_agent"`.
- Attribute `gen_ai.agent.name` SHOULD be set to the agents name. (e.g. `"Weather Agent"`)
- If provided, the attribute `gen_ai.request.model` MUST be the agent's default request model. (e.g. `"gpt-4o"`)
Expand Down Expand Up @@ -247,3 +247,8 @@ The input list should include the most recent messages up to and including the m
**[7]**

Binary blobs in the input list should be replaced with the string `"[Blob substitute]"` in positions where binary data is expected in a given schema. Only binary blobs in positions where binary data is explicitly expected must be redacted. For example, in OpenAI Completions schema, only binary blobs in content blocks with type `image_url`, `input_audio` or `file` should be redacted.

**[8]**

In some agent libraries, the agent name is optional, and some do not provide an option to name your agents.
In these cases, the span name SHOULD be `"invoke_agent {call_id}"`, where `call_id` is some user-provided identifier for the agent invocation. For example, `functionId` in Vercel AI.
Loading