anosys-sdk-openai-agents 1.0.3

AnoSys SDK for OpenAI Agents - Automatic instrumentation and logging for OpenAI Agents

AnoSys SDK for OpenAI Agents

Automatically capture and send OpenAI Agents SDK traces to AnoSys for monitoring, analytics, and observability.

Features

✨ Automatic Agent Tracing - Captures all agent runs, tool calls, and handoffs
✨ TracingProcessor Integration - Native integration with OpenAI Agents SDK
✨ Structured Span Data - Captures agent, function, guardrail, and generation spans
✨ User Context Support - Associate traces with user sessions

Installation

pip install anosys-sdk-openai-agents

Quick Start

import os
from agents import Agent, Runner, set_tracing_processor
from anosys_sdk_openai_agents import AnosysOpenAIAgentsLogger

os.environ["OPENAI_API_KEY"] = "your-openai-key"
os.environ["ANOSYS_API_KEY"] = "your-anosys-key"

# Set up the tracing processor
set_tracing_processor(AnosysOpenAIAgentsLogger())

# Create and run an agent
agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant."
)

result = Runner.run_sync(agent, "Hello!")
print(result.final_output)

User Context

Associate traces with user sessions:

def get_user_context():
    return {
        "session_id": "user-123",
        "token": "auth-token"
    }

processor = AnosysOpenAIAgentsLogger(get_user_context=get_user_context)
set_tracing_processor(processor)

Span Types Captured

• agent - Agent execution spans
• function - Tool/function calls
• generation - LLM generation calls
• guardrail - Guardrail checks
• handoff - Agent handoffs
• response - Response spans
• custom - Custom spans

Environment Variables

Variable	Required	Description
ANOSYS_API_KEY	Yes	Your AnoSys API key
OPENAI_API_KEY	Yes	Your OpenAI API key

License

Apache 2.0