1
from agents import Agent, Runner
2

3
agent = Agent(
4
    name="Support Agent",
5
    instructions="You are a customer support agent. Be helpful and concise.",
6
    tools=[get_order_status, process_refund]
7
)
8

9
result = Runner.run_sync(agent, "Where is my order #12345?")
10
print(result.final_output)

1
from agents import Agent, Guardrail, handoff
2

3
agent = Agent(
4
    name="billing_agent",
5
    instructions="You handle billing inquiries. Transfer to escalation when needed.",
6
    model="gpt-4o",
7
    tools=[lookup_invoice, process_payment, refund_order],
8
    handoffs=[escalation_agent],  # Can transfer to other agents
9
    input_guardrails=[pii_check, budget_check],  # Check input before processing
10
    output_guardrails=[validation_check],  # Check output before returning
11
    output_type=BillingResponse,  # Structured output
12
)

1
from agents import Agent, handoff, Runner
2

3
# Define specialized agents
4
triage_agent = Agent(
5
    name="triage",
6
    instructions="Route to the right specialist",
7
    handoffs=["billing", "technical", "account"],
8
)
9

10
billing_agent = Agent(
11
    name="billing",
12
    instructions="Handle billing and payments",
13
    tools=[process_refund, lookup_invoice],
14
)
15

16
tech_agent = Agent(
17
    name="technical",
18
    instructions="Handle technical issues",
19
    tools=[run_diagnostics, check_logs],
20
)
21

22
# Handoff configuration with customization
23
billing_handoff = handoff(
24
    agent=billing_agent,
25
    tool_name_override="transfer_to_billing",
26
    tool_description_override="Transfer to billing for payment issues",
27
    on_handoff=lambda ctx: log_transfer(ctx, "billing"),
28
)
29

30
triage_agent.handoffs = [billing_handoff, tech_agent]

1
from agents import Guardrail, Runner
2

3
class PIIGuardrail(Guardrail):
4
    """Check for personally identifiable information"""
5

6
    async def check_input(self, agent, input_data):
7
        if contains_pii(input_data):
8
            return GuardrailResult(
9
                passed=False,
10
                message="Input contains PII. Please remove personal information.",
11
                transformed=redact_pii(input_data)  # Auto-redact
12
            )
13
        return GuardrailResult(passed=True)
14

15
    async def check_output(self, agent, output_data):
16
        if contains_pii(output_data):
17
            return GuardrailResult(
18
                passed=False,
19
                message="Output must not contain PII",
20
                transformed=redact_pii(output_data)
21
            )
22
        return GuardrailResult(passed=True)
23

24
agent = Agent(
25
    name="safe_agent",
26
    input_guardrails=[PIIGuardrail()],
27
    output_guardrails=[PIIGuardrail()]
28
)

1
from pydantic import BaseModel
2
from agents import Agent, Runner
3

4
class SupportResponse(BaseModel):
5
    summary: str
6
    resolution: str | None
7
    requires_escalation: bool
8
    category: str
9

10
agent = Agent(
11
    name="support",
12
    instructions="Resolve support tickets",
13
    output_type=SupportResponse,  # Agent must return this shape
14
)
15

16
result = Runner.run_sync(agent, "My payment failed")
17
print(result.final_output)  # SupportResponse instance
18
# SupportResponse(summary='Payment declined', resolution='Try different card', requires_escalation=False, category='billing')

1
from agents import Runner, trace
2

3
# Automatic tracing in the dashboard
4
with trace("Support Workflow"):
5
    triage_result = Runner.run_sync(triage_agent, user_message)
6
    if triage_result.requires_handoff:
7
        specialist_result = Runner.run_sync(specialist_agent, user_message)