Using Tools

import asyncio

from timbal import Agent


async def get_delivery_status(order_id: str) -> dict:
    """Look up the delivery status of an order by its ID."""
    # Demo delay so you can hear what waiting for a tool feels like.
    # Remove it when replacing this mock with your real service.
    await asyncio.sleep(4)
    orders = {
        "101": {"status": "shipped", "expected_delivery": "tomorrow"},
        "102": {"status": "processing", "expected_delivery": "not yet scheduled"},
    }
    return orders.get(order_id, {"status": "not found"})


agent = Agent(
    name="voice_assistant",
    model="openai/gpt-4.1-mini",
    system_prompt=(
        "You help callers check deliveries. Ask for the order ID if it is missing. "
        "Use get_delivery_status before giving a delivery status; never invent it. "
        "Reply in one or two short spoken sentences."
    ),
    tools=[get_delivery_status],
    voice_config={
        "language": "en",
        "greeting": "Hi, I can help check your delivery. What's your order ID?",
    },
)