Travel Booking Assistant — AGNT5 Template

A conversational travel agent that searches real flights and hotels, builds itineraries, and remembers every detail across a multi-turn chat session.

What it does

• Search flights and hotels in real time using SerpAPI (Google Flights / Hotels data).
• Build complete itineraries with day-by-day plans, cost estimates, and recommendations.
• Maintain conversation state across turns — the agent never asks for information you've already given.

Key concepts

• Single agent with tools — One context-aware agent orchestrates three tools: search_flights, search_hotels, and create_itinerary.
• Durable conversation history — Passing context=ctx into agent.run(...) loads and saves conversation history through the workflow's own checkpointed context, so it survives worker restarts without a separate entity.
• Multi-turn chat — The agent builds context incrementally across messages within a session.

Setup

1. Install uv (Python package manager):

   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone or create from template:

   agnt5 create --template python/travel_booking_customer_service my-travel-agent
   cd my-travel-agent

3. Install dependencies:

   uv sync

4. Set up environment variables:

   cat > .env << EOF
   OPENAI_API_KEY=your_openai_api_key_here
   SERPAPI_KEY=your_serpapi_key_here
   EOF

   Get a SerpAPI key at: https://serpapi.com (free tier available)

5. Start the AGNT5 dev server:

   agnt5 dev