mkurman Overview
OpenAI Agents SDK provides a lightweight framework for building agentic AI workflows. Supports tool use, handoffs (agent-to-agent routing), guardrails, and tracing — built on the OpenAI API's native agent primitives.
Installation
uv pip install openai-agents
Basic Agent
from agents import Agent, Runner
agent = Agent(name="Helper", instructions="You are a helpful assistant.")
result = Runner.run_sync(agent, "What is the capital of France?")
print(result.final_output)
Tool Use
from agents import Agent, Runner, function_tool
@function_tool
def get_weather(city: str) -> str:
return f"Weather in {city}: sunny, 22°C"
agent = Agent(name="WeatherBot", instructions="Use tools to answer weather queries.", tools=[get_weather])
result = Runner.run_sync(agent, "What's the weather in London?")
print(result.final_output)
Handoffs
from agents import Agent, Runner
triage = Agent(name="Triage", instructions="Route to the right specialist.")
billing = Agent(name="Billing", instructions="Handle billing questions.")
triage.handoffs = [billing]
result = Runner.run_sync(triage, "My invoice didn't arrive")