Skip to main content

​
Installation

pip install respan-exporter-openai-agents

​
Classes

​
RespanTraceProcessor

The main trace processor that hooks into the OpenAI Agents SDK tracing system. 
from 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. 
from 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

from agents import Agent, Runner, set_trace_processors
from respan_exporter_openai_agents import RespanTraceProcessor

# Initialize exporter
respan_processor = RespanTraceProcessor(api_key="your-api-key")
set_trace_processors([respan_processor])

# Run agent
agent = Agent(name="Assistant", instructions="You are helpful.")
result = Runner.run_sync(agent, "Tell me a joke")
print(result.final_output)