Skip to content

docs: explain task and turn tracing spans#3546

Closed
nima20002000 wants to merge 1 commit into
openai:mainfrom
nima20002000:docs/3182-trace-task-turn-spans-a
Closed

docs: explain task and turn tracing spans#3546
nima20002000 wants to merge 1 commit into
openai:mainfrom
nima20002000:docs/3182-trace-task-turn-spans-a

Conversation

@nima20002000
Copy link
Copy Markdown

Summary

Document the default task_span() and turn_span() hierarchy that wraps Runner workflows, so users can interpret the newer trace shape discussed in #3182.

This adds guidance for:

  • how task, agent, and turn spans nest
  • how guardrail span parentage can vary by run path
  • how custom trace processors can identify task/turn spans before and after export

Test plan

  • git diff --check
  • make build-docs (passes; emits existing MkDocs/griffe/autoref warnings in generated reference and translated docs)

Issue number

Closes #3182

Checks

  • I've added new tests (if relevant)
  • I've added/updated the relevant documentation
  • I've run make lint and make format
  • I've made sure tests pass

@seratch seratch added documentation Improvements or additions to documentation feature:tracing labels Jun 4, 2026
@seratch
Copy link
Copy Markdown
Member

seratch commented Jun 4, 2026

Thanks for the suggestion. This is not the changes we would like to apply to the docs for now

@seratch seratch closed this Jun 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation feature:tracing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Did something changed with traces implementation?

2 participants