Skip to content

Add semantic conventions for GenAI agent planning operation#3594

Open
Krishnachaitanyakc wants to merge 1 commit intoopen-telemetry:mainfrom
Krishnachaitanyakc:plan-operation
Open

Add semantic conventions for GenAI agent planning operation#3594
Krishnachaitanyakc wants to merge 1 commit intoopen-telemetry:mainfrom
Krishnachaitanyakc:plan-operation

Conversation

@Krishnachaitanyakc
Copy link
Copy Markdown

@Krishnachaitanyakc Krishnachaitanyakc commented Apr 2, 2026

Partially addresses #2664

area:gen-ai

Summary

Clarify plan span naming based on the immediate parent span.

For span.gen_ai.plan.internal, this change specifies that the span name SHOULD be:

  • plan {gen_ai.agent.name} when the parent is invoke_agent
  • plan {gen_ai.workflow.name} when the parent is invoke_workflow
  • plan otherwise

Rationale

This removes ambiguity when both gen_ai.agent.name and gen_ai.workflow.name are available, and makes span naming more consistent across instrumentations.

Scope

Updates the normative guidance in model/gen-ai/spans.yaml and the generated GenAI agent span documentation.

No new attributes or operations are introduced.

@github-actions github-actions bot added the enhancement New feature or request label Apr 2, 2026
@Krishnachaitanyakc Krishnachaitanyakc marked this pull request as ready for review April 2, 2026 21:58
@Krishnachaitanyakc Krishnachaitanyakc requested review from a team as code owners April 2, 2026 21:58
@lmolkova lmolkova moved this from Untriaged to Awaiting codeowners approval in Semantic Conventions Triage Apr 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:gen-ai enhancement New feature or request

Projects

Status: Awaiting codeowners approval

Development

Successfully merging this pull request may close these issues.

3 participants