Skip to content

Travel Agent

The maintained travel showcase is examples/pydantic/travel_agent.py.

It is the main example for:

  • Hooks capability introspection rendered through HookProjectionMap
  • approval-gated read/write diff projection in a local workspace
  • prompt-model override behavior for image and audio prompts
  • a direct module-level Agent(...), AdapterConfig(...), and configured acp_agent surface without example-only factories

Run It

uv run python -m examples.pydantic.travel_agent

Without ACP_TRAVEL_MODEL, the example uses TestModel so the demo remains credential-free. Set ACP_TRAVEL_MODEL and optionally ACP_TRAVEL_MEDIA_MODEL when you want live-model behavior.

Key Patterns

  • the module exports agent, config, acp_agent, and main; use acp_agent for configured CLI or remote hosting
  • HookProjectionMap relabels and hides selected hook lifecycle events
  • TravelPromptModelProvider shows how a host can supply an explicit media-model override
  • generated trip files keep the example self-contained instead of relying on tracked demo fixtures
  • FileSystemProjectionMap turns travel file reads and writes into ACP-visible diffs