OpenAI Agents Exporter

Installation

$pip install respan-exporter-openai-agents

Classes

RespanTraceProcessor

The main trace processor that hooks into the OpenAI Agents SDK tracing system.

1from respan_exporter_openai_agents import RespanTraceProcessor
ParameterTypeDefaultDescription
api_keystr | NoneNoneRespan API key. Falls back to RESPAN_API_KEY env var.
endpointstr | NoneNoneIngest endpoint URL.

RespanSpanExporter

Exports individual spans to Respan.

1from respan_exporter_openai_agents import RespanSpanExporter

Helper functions

FunctionDescription
convert_to_respan_log(item)Convert an OpenAI Agents Trace or Span to Respan log format.

Usage

1from agents import Agent, Runner, set_trace_processors
2from respan_exporter_openai_agents import RespanTraceProcessor
3
4# Initialize exporter
5respan_processor = RespanTraceProcessor(api_key="your-api-key")
6set_trace_processors([respan_processor])
7
8# Run agent
9agent = Agent(name="Assistant", instructions="You are helpful.")
10result = Runner.run_sync(agent, "Tell me a joke")
11print(result.final_output)