OpenInference OpenAI Agents Instrumentation

Python auto-instrumentation library for OpenAI Agents python SDK.

The traces emitted by this instrumentation are fully OpenTelemetry compatible and can be sent to an OpenTelemetry collector for viewing, such as Arize Phoenix or Arize AX.

Compatibility

`openinference-instrumentation-openai-agents`	`openai-agents`	Python
`>=2.0`	`>=0.11.0`	`>=3.10, <3.15`
`>=1.4.1, <2.0`	`>=0.2.6`	`>=3.10, <3.15`
`>=1.2.0, <1.4.1`	`>=0.2.6`	`>=3.9, <3.14`
`>=1.0.0, <1.2.0`	`>=0.1.0`	`>=3.9, <3.14`
`<1.0.0`	`>=0.0.3`	`>=3.9, <3.14`

Instrumentor >=2.0 requires openai-agents>=0.11.0. Three things changed below that floor which the instrumentor no longer accommodates: the run internals moved out of agents._run_impl into agents.run_internal in 0.8.0, openai-agents moved from openai<2 to openai>=2.9 in the same release, and tool namespaces (agents.tool_namespace) arrived in 0.11.0. Tools grouped by a namespace report tool.description and tool.parameters only on instrumentor >=2.0.

Installation

pip install openinference-instrumentation-openai-agents

Quickstart

In this example we will instrument a small program that uses OpenAI and observe the traces via arize-phoenix.

Install packages.

pip install openinference-instrumentation-openai-agents arize-phoenix opentelemetry-sdk opentelemetry-exporter-otlp

Start the phoenix server so that it is ready to collect traces. The Phoenix server runs entirely on your machine and does not send data over the internet.

phoenix serve

In a python file, set up the OpenAIAgentsInstrumentor and configure the tracer to send traces to Phoenix.

from agents import Agent, Runner
from openinference.instrumentation.openai_agents import OpenAIAgentsInstrumentor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk import trace as trace_sdk
from opentelemetry.sdk.trace.export import ConsoleSpanExporter, SimpleSpanProcessor

endpoint = "http://127.0.0.1:6006/v1/traces"
tracer_provider = trace_sdk.TracerProvider()
tracer_provider.add_span_processor(SimpleSpanProcessor(OTLPSpanExporter(endpoint)))
# Optionally, you can also print the spans to the console.
tracer_provider.add_span_processor(SimpleSpanProcessor(ConsoleSpanExporter()))

OpenAIAgentsInstrumentor().instrument(tracer_provider=tracer_provider)


agent = Agent(name="Assistant", instructions="You are a helpful assistant")
result = Runner.run_sync(agent, "Write a haiku about recursion in programming.")
print(result.final_output)

Since we are using OpenAI, we must set the OPENAI_API_KEY environment variable to authenticate with the OpenAI API.

export OPENAI_API_KEY=your-api-key

Now simply run the python file and observe the traces in Phoenix.

python your_file.py

Realtime audio

OpenAIAgentsInstrumentor().instrument(...) also traces agents.realtime.RealtimeSession (the OpenAI Agents SDK's voice/audio runtime) when the realtime extras are installed. No additional setup is required — instrument(...) applies the realtime patches whenever agents.realtime is importable.

For each turn the instrumentor produces this span tree:

AUDIO   "conversation.turn"     ← parent; aggregated input/output transcripts, llm.model_name, llm.invocation_parameters
├─ USER  "user"                 ← input.audio.url (WAV data URI), input.audio.transcript, or input.value for text input
├─ LLM   "assistant"            ← output.audio.url, output.audio.transcript, token counts, time_to_first_token_ms
│  └─ TOOL "<tool_name>"        ← one per function call within the turn
└─ ...                          ← additional USER / LLM siblings for split input or tool round-trips

A runnable mic/speaker example with two function tools lives at examples/realtime_with_tools.py.

Audio redaction

The realtime instrumentor recognizes three environment variables for redacting captured audio:

OPENINFERENCE_HIDE_INPUT_AUDIO — when truthy (1 / true / yes / on), drops input.audio.url, input.audio.mime_type, and input.audio.transcript from USER spans. Default: false.
OPENINFERENCE_HIDE_OUTPUT_AUDIO — same shape, drops the output.audio.* attributes from LLM spans. Default: false.
OPENINFERENCE_BASE64_AUDIO_MAX_LENGTH — caps the base64 payload length of audio data: URIs. The data:audio/wav;base64, prefix is always preserved. Default: 32000.

TraceConfig(hide_inputs=True) and TraceConfig(hide_outputs=True) also cascade to the corresponding audio attributes.

More Info

Metadata

Release files for openinference-instrumentation-openai-agents 2.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openinference-instrumentation-openai-agents 2.0.2
File	Size	Uploaded
openinference_instrumentation_openai_agents-2.0.2.tar.gz	31.4 kB	Aug 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for openinference-instrumentation-openai-agents 2.0.2
File	Interpreter	ABI	Platform	Reset
openinference_instrumentation_openai_agents-2.0.2-py3-none-any.whl 34.4 kB Aug 25, 2026	Python 3	none	any	Details

Total release size: 65.7 kB

Release files / openinference_instrumentation_openai_agents-2.0.2.tar.gz

Download URL	openinference_instrumentation_openai_agents-2.0.2.tar.gz
Size	31.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`516c6c486bc75de9e58f80ac014d80b0f90e3696393ed1fd4c9e79e1dfe16a17`
BLAKE2b-256 checksum How to use checksums	`b50a2df88292e4cf8e5ea613c1c0f822c5da915f8cf555fb79064b4e06358eba`
Upload date	Aug 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Arize-ai/openinference
Publishing commit: github.com/Arize-ai/openinference/tree/d4b7c075700a2884328393f6d4a140d14cab03a7

Workflow

Publishing configuration: github.com/Arize-ai/openinference/blob/d4b7c075700a2884328393f6d4a140d14cab03a7/.github/workflows/publish.yaml
Publishing logs: github.com/Arize-ai/openinference/actions/runs/32813206395/attempts/1

Artifact

Subject: openinference_instrumentation_openai_agents-2.0.2.tar.gz
SHA-256 checksum: 516c6c486bc75de9e58f80ac014d80b0f90e3696393ed1fd4c9e79e1dfe16a17 Verifying attestations

Release files / openinference_instrumentation_openai_agents-2.0.2-py3-none-any.whl

Download URL	openinference_instrumentation_openai_agents-2.0.2-py3-none-any.whl
Size	34.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a6ae861841a2fe5967de1bb8752468baa052a007a6f776bab0c6e9fa05bf9d00`
BLAKE2b-256 checksum How to use checksums	`2c11d9e04bc3d334c90a2b2b6392b075b780a793d4d6da211372fb86709e4a6b`
Upload date	Aug 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Arize-ai/openinference
Publishing commit: github.com/Arize-ai/openinference/tree/d4b7c075700a2884328393f6d4a140d14cab03a7

Workflow

Publishing configuration: github.com/Arize-ai/openinference/blob/d4b7c075700a2884328393f6d4a140d14cab03a7/.github/workflows/publish.yaml
Publishing logs: github.com/Arize-ai/openinference/actions/runs/32813206395/attempts/1

Artifact

Subject: openinference_instrumentation_openai_agents-2.0.2-py3-none-any.whl
SHA-256 checksum: a6ae861841a2fe5967de1bb8752468baa052a007a6f776bab0c6e9fa05bf9d00 Verifying attestations