from runtype import Runtype
import httpx

Runtype.configure(api_key="your-api-key")

# Define tools the AI can call — they run on YOUR machine
async def lookup_order(params):
    async with httpx.AsyncClient() as client:
        resp = await client.get(f"https://api.mystore.com/orders/{params['orderId']}")
        return resp.json()

async def create_ticket(params):
    async with httpx.AsyncClient() as client:
        resp = await client.post(
            "https://api.mystore.com/tickets",
            json={"subject": params["subject"], "body": params["body"]},
        )
        return resp.json()

result = await (
    Runtype.flows.virtual(name="Support Agent")
    .prompt(
        name="Agent",
        model="claude-sonnet-4-5",
        system_prompt="You are a support agent. Use tools to look up orders and create tickets.",
        user_prompt="Order #1234 arrived damaged. Look it up and file a ticket.",
        tools={
            "runtimeTools": [
                {
                    "name": "lookup_order",
                    "description": "Look up an order by ID",
                    "toolType": "local",
                    "parametersSchema": {
                        "type": "object",
                        "properties": {"orderId": {"type": "string"}},
                        "required": ["orderId"],
                    },
                },
                {
                    "name": "create_ticket",
                    "description": "Create a support ticket",
                    "toolType": "local",
                    "parametersSchema": {
                        "type": "object",
                        "properties": {
                            "subject": {"type": "string"},
                            "body": {"type": "string"},
                        },
                        "required": ["subject", "body"],
                    },
                },
            ],
        },
    )
    .with_local_tools({
        "lookup_order": lookup_order,
        "create_ticket": create_ticket,
    })
    .stream()
)
See what you can build

Shopify Fraud Analyzer
