8000 Workflow root span for openai agents by nagkumar91 · Pull Request #3825 · open-telemetry/opentelemetry-python-contrib · GitHub
[go: up one dir, main page]
Skip to content

Workflow root span for openai agents #3825

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

Jump to bottom
Open
wants to merge 22 commits into
base: main
Choose a base branch
from
Open

Workflow root span for openai agents #3825

wants to merge 22 commits into from

Conversation

nagkumar91
Copy link
Contributor
@nagkumar91 nagkumar91 commented Oct 9, 2025 •
edited
Loading

Description

Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.

Fixes # (issue)

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

  • Unit tests: pytest opentelemetry-instrumentation-openai-agents/tests/test_tracer.py
  • Why: Covers span-kind assignment with the new workflow root span, attribute propagation for generation/response/agent/function spans, and the various overrides.
  • Repro steps:
    1. cd instrumentation-genai/opentelemetry-instrumentation-openai-agents
    2. python3 -m pytest tests/test_tracer.py

Manual verification (optional but recommended)

  • Run the multi-agent handoff sample: Shows the emitted workflow SERVER span plus multiple invoke_agent and execute_tool spans.
    1. cd instrumentation-genai/opentelemetry-instrumentation-openai-agents/examples/handoffs
    2. python3 -m venv .venv && source .venv/bin/activate
    3. pip install "python-dotenv[cli]" and pip install -r requirements.txt
    4. Copy .env.example → .env, set OPENAI_API_KEY, adjust OTLP settings if needed
    5. dotenv run -- python main.py (or export the vars and run python main.py)

Does This PR Require a Core Repo Change?

  • Yes. - Link to PR:
  • No.

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

  • Followed the style guidelines of this project
  • Changelogs have been updated
  • Unit tests have been added
  • Documentation has been updated

nagkumar91 and others added 20 commits October 7, 2025 13:02
@nagkumar91
Implement OpenAI Agents span processing
4830f59
@nagkumar91
Merge branch 'main' into tracers-and-spans
e279865
@nagkumar91
Update OpenAI Agents changelog with PR references
44b91e8
@nagkumar91
Add OpenAI Agents manual and zero-code examples
1d78868
@nagkumar91
Load dotenv in OpenAI Agents examples
f0154ea
@nagkumar91
Update the tracer and finalize tests
ed61f0d
@nagkumar91
Capture spans from zero code sample
9633585
@nagkumar91
Merge branch 'main' into tracers-and-spans
eefc31b
@nagkumar91
Default OpenAI agent trace start to now
ba45d16
@nagkumar91
Annotate OpenAI trace provider helper
20e80a3
@nagkumar91
Remove OpenAI Agents system env override
5165bad
Use gen_ai.provider.name for OpenAI Agents spans
fd707d3
@nagkumar91
Support new SDK InMemorySpanExporter import in tests
523e7e2
@nagkumar91
Ensure OpenAI agent span names include model when available
3c5fd9a
@nagkumar91
Handle agent creation spans in OpenAI Agents instrumentation
c032131
@nagkumar91
Allow overriding OpenAI agent name via environment variable
b3cc03a
@nagkumar91
Define span type constants for OpenAI Agents instrumentation
c813d08
@nagkumar91
Add OpenAI Agents response and completion span tests
0ec1c82
@nagkumar91
Match response finish reasons tuple in tests
407fdfb
@nagkumar91
Add workflow root span support and handoff example
0125626
@nagkumar91 nagkumar91 marked this pull request as ready for review October 9, 2025 18:02
@nagkumar91 nagkumar91 requested a review from a team as a code owner October 9, 2025 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@codefromthecrypt codefromthecrypt

@nirga nirga

@lzchen lzchen

@karthikscale3 karthikscale3

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@nagkumar91 @codefromthecrypt @nirga @lzchen @karthikscale3
0