OpenAI Agents SDK Integration

pip install 'sentrial[openai-agents]'
# The extra installs openai-agents>=0.1.0,<1.0.0 — the tested/supported window

npm install @sentrial/sdk @openai/agents
# @openai/agents is an optional peer dependency (supported range: >=0.1.0 <1.0.0)

import sentrial
from agents import Agent, Runner
from sentrial.openai_agents import instrument_openai_agents

sentrial.configure(api_key="sentrial_live_xxx")
instrument_openai_agents(user_id="user_123")

agent = Agent(name="Assistant", instructions="You are a helpful assistant")
result = Runner.run_sync(agent, "Write a haiku about recursion.")
# The run is now a Sentrial session with LLM events, tool calls, handoffs.

import { Agent, run, addTraceProcessor } from '@openai/agents';
import { sentrial, instrumentOpenAIAgents } from '@sentrial/sdk';

sentrial.configure({ apiKey: process.env.SENTRIAL_API_KEY });
instrumentOpenAIAgents({ addTraceProcessor }, { userId: 'user_123' });

const agent = new Agent({ name: 'Assistant', instructions: 'Be helpful.' });
const result = await run(agent, 'Write a haiku about recursion.');
// The run is now a Sentrial session with LLM events, tool calls, handoffs.

instrument_openai_agents(
    client=my_client,           # optional — explicit SentrialClient;
                                # defaults to the module-level client from sentrial.configure()
    default_agent="my-agent",   # optional — explicit agent/event name
                                # (defaults to the root agent span's name per run)
    user_id="user_123",         # optional — default "anonymous"
    extra_metadata={"env": "prod"},  # optional — merged into every session
)

instrumentOpenAIAgents(agents, {
  client: myClient,           // optional — explicit SentrialClient;
                              // defaults to an env-configured client (SENTRIAL_API_KEY)
  defaultAgent: 'my-agent',   // optional — explicit agent/event name
                              // (defaults to the root agent span's name per run)
  userId: 'user_123',         // optional — default 'anonymous'
  extraMetadata: { env: 'prod' },  // optional — merged into every session
});

from sentrial import SentrialClient
from sentrial.openai_agents import SentrialTraceProcessor
from agents import add_trace_processor

client = SentrialClient(api_key="sentrial_live_xxx", batching=True)
add_trace_processor(SentrialTraceProcessor(client=client, user_id="user_123"))

import { addTraceProcessor } from '@openai/agents';
import { SentrialClient, SentrialOpenAIAgentsProcessor } from '@sentrial/sdk';

const client = new SentrialClient({
  apiKey: process.env.SENTRIAL_API_KEY,
  batching: { enabled: true },
});
addTraceProcessor(new SentrialOpenAIAgentsProcessor({ client, userId: 'user_123' }));