OpenAI Agents SDK Basics

python -m venv .venv && source .venv/bin/activate
pip install openai-agents
export OPENAI_API_KEY="sk-..."

import asyncio
from agents import Agent, Runner
 
agent = Agent(
    name="History Tutor",
    instructions="You answer history questions clearly and concisely.",
)
 
async def main():
    result = await Runner.run(agent, "When did the Roman Empire fall?")
    print(result.final_output)
 
asyncio.run(main())

from agents import Agent, Runner
 
agent = Agent(
    name="Assistant",
    instructions="Reply in one short sentence.",
)
 
result = Runner.run_sync(agent, "Name one benefit of tool-using agents.")
print(result.final_output)

import asyncio
from agents import Agent, Runner, function_tool
 
@function_tool
def history_fun_fact() -> str:
    """Return a short history fact."""
    return "Sharks are older than trees."
 
agent = Agent(
    name="History Tutor",
    instructions=(
        "Answer history questions clearly. "
        "Use history_fun_fact when it helps."
    ),
    tools=[history_fun_fact],
)
 
async def main():
    result = await Runner.run(
        agent,
        "Tell me something surprising about ancient life on Earth.",
    )
    print(result.final_output)
 
asyncio.run(main())

from agents import Agent, Runner, function_tool
 
@function_tool
def get_weather(city: str) -> str:
    """Return a demo weather string for a city."""
    # Replace with a real weather API in production.
    demo = {"paris": "sunny, 22C", "tokyo": "cloudy, 19C"}
    return demo.get(city.lower(), f"No data for {city}")
 
agent = Agent(
    name="Weather Assistant",
    instructions="Use get_weather for weather questions. Be brief.",
    tools=[get_weather],
)
 
result = Runner.run_sync(agent, "What is the weather in Paris?")
print(result.final_output)

import asyncio
from agents import Agent, Runner
 
history_tutor = Agent(
    name="History Tutor",
    handoff_description="Specialist agent for historical questions",
    instructions="You answer history questions clearly and concisely.",
)
 
math_tutor = Agent(
    name="Math Tutor",
    handoff_description="Specialist agent for math questions",
    instructions="You explain math step by step with worked examples.",
)
 
triage = Agent(
    name="Triage Agent",
    instructions="Route each homework question to the right specialist.",
    handoffs=[history_tutor, math_tutor],
)
 
async def main():
    result = await Runner.run(
        triage,
        "Who was the first president of the United States?",
    )
    print(result.final_output)
    print("Answered by:", result.last_agent.name)
 
asyncio.run(main())

import asyncio
from agents import Agent, Runner
 
agent = Agent(
    name="Coach",
    instructions="You are a concise writing coach.",
)
 
async def main():
    r1 = await Runner.run(agent, "My topic is remote work culture.")
    print("Turn 1:", r1.final_output)
 
    follow_up = r1.to_input_list() + [
        {"role": "user", "content": "Give me three outline bullets only."}
    ]
    r2 = await Runner.run(agent, follow_up)
    print("Turn 2:", r2.final_output)
 
asyncio.run(main())

from pydantic import BaseModel, Field
from agents import Agent, Runner
 
class TicketDraft(BaseModel):
    title: str = Field(description="Short issue title")
    priority: str = Field(description="low, medium, or high")
    summary: str
 
agent = Agent(
    name="Ticket Writer",
    instructions="Turn the user complaint into a support ticket object.",
    output_type=TicketDraft,
)
 
result = Runner.run_sync(
    agent,
    "My card was charged twice and I need this fixed today.",
)
print(result.final_output)
# TicketDraft(...)
print(result.final_output.priority)

from agents import Agent, Runner, function_tool
 
@function_tool
def ping() -> str:
    """Health check tool for demos."""
    return "pong"
 
agent = Agent(
    name="Ops Bot",
    instructions="Use ping if asked about health.",
    tools=[ping],
)
 
result = Runner.run_sync(agent, "Run a health check.")
print("final:", result.final_output)
print("last agent:", result.last_agent.name)
# Explore result attributes in your installed version (items, usage, etc.)