OpenAI Agents SDK

from agents import Agent, function_tool

import agentos
from agentos.adapters import openai_agents

ORDERS = {"A-1001": {"status": "delivered", "total": "49.90", "currency": "EUR"}}


@function_tool
def lookup_order(order_id: str) -> dict:
    """Look an order up by its id, e.g. A-1001."""
    return ORDERS.get(order_id, {"error": f"no order {order_id}"})


@function_tool(needs_approval=True)
def refund(order_id: str, amount: str) -> str:
    """Refund an order. The amount is text, e.g. "49.90". A person approves every refund first."""
    return f"refunded {amount} for order {order_id}"


async def support(inv: agentos.Invocation):
    agent = Agent(
        name="support",
        instructions=inv.config["prompts"]["system"],
        tools=[lookup_order, refund],
        model=openai_agents.model(inv),  # config.models.main, through the gateway with the run token
    )
    try:
        result = await openai_agents.run(inv, agent, inv.input["message"], intent="Approve a refund")
    except Exception as error:
        if block := agentos.guardrail_block(error):  # a guardrail refused a model call
            raise block from error
        raise
    return {"answer": str(result.final_output)}


if __name__ == "__main__":
    agentos.serve({"support": support}, port=8080)

name: support-openai-agents
title: Support agent (OpenAI Agents SDK)
description: Answers order questions with a lookup tool; refunds go through a person first.
runtime: stateless
port: 8080
capabilities:
  support:
    description: Handles a customer's message. A refund the model wants to issue waits for a person's approval.
    input:
      type: object
      properties: {message: {type: string, minLength: 1}}
      required: [message]
    output:
      type: object
      properties: {answer: {type: string}}
      required: [answer]
    timeout: 120s
config:
  models:
    main: anthropic/claude-sonnet-4-5    # a model from your Models page: <provider slug>/<model ID>
  prompts:
    system: >-
      You are a support agent for an online shop. Look orders up with lookup_order before you
      answer anything about an order. Refund only with the refund tool. Never refund more than the order's total.

FROM python:3.13-slim
WORKDIR /app
COPY vendor/ vendor/
COPY requirements.txt .
RUN pip install --no-cache-dir "$(ls vendor/*.whl)[openai-agents]" -r requirements.txt
COPY app.py .
USER nobody
EXPOSE 8080
CMD ["python", "-u", "app.py"]

openai-agents==0.23.1