How dumindi18/tripsupervisor works
TripSupervisor is a runnable multi-agent trip-booking scenario designed to exercise workflow, verification, concurrency and hallucination failures. A customer request is initialized by the supervisor, then flight, hotel and activity agents search and book in parallel; a verifier and checkout produce a ground-truth record, and Trip Digest summarizes it for a final hallucination check. The sampled source shows these stages and shared-state interactions; other documented failure toggles are retained as configuration capability, without inferring their internal wiring.
Main entry points: blackboard.py Shared blackboard · run_trip_supervisor.py Scenario runner · trip_workflow.py Flight agent · trip_mock_apis.py Booking APIs
Components 18
Workflow orchestration
- Scenario runner
run_trip_supervisor.py - DAG engine
workflow.py - LLM agent
agent.py
Trip booking stages
- Trip supervisor
trip_workflow.py - Flight agent
trip_workflow.py - Hotel agent
trip_workflow.py - Activity agent
trip_workflow.py - Booking APIs
trip_mock_apis.py - Budget verifier
trip_workflow.py - Checkout
trip_workflow.py - Trip Digest
trip_workflow.py
Shared state and failure controls
- Shared blackboard
blackboard.py - Failure controls
trip_failure_config.py - JSON response parser
trip_json.py
Result checking
- Hallucination checker
trip_hallucination.py
Other components
- Trip requester
- Ollama service
- Trip result
Connections 24
- Trip requester → Scenario runner: submits request
run_trip_supervisor.py - Scenario runner → Failure controls: configures failures
run_trip_supervisor.py - Scenario runner → DAG engine: runs workflow
run_trip_supervisor.py - Scenario runner → Trip supervisor: builds stages
run_trip_supervisor.py - DAG engine → LLM agent: runs agents
workflow.py - LLM agent → Ollama service: sends prompts
agent.py - Trip supervisor → Shared blackboard: writes brief
trip_workflow.py - Flight agent → Shared blackboard: reads and writes
trip_workflow.py - Hotel agent → Shared blackboard: reads and writes
trip_workflow.py - Activity agent → Shared blackboard: reads and writes
trip_workflow.py - Flight agent → Booking APIs: searches and books
trip_workflow.py - Hotel agent → Booking APIs: searches and books
trip_workflow.py - Activity agent → Booking APIs: searches and books
trip_workflow.py - Flight agent → JSON response parser: parses response
trip_workflow.py - Hotel agent → JSON response parser: parses response
trip_workflow.py - Activity agent → JSON response parser: parses response
trip_workflow.py - Budget verifier → Shared blackboard: reads and writes
trip_workflow.py - Checkout → Shared blackboard: reads and writes
trip_workflow.py - Trip Digest → Shared blackboard: reads and writes
trip_workflow.py - Scenario runner → Hallucination checker: checks digest
run_trip_supervisor.py - Scenario runner → Shared blackboard: reads result
run_trip_supervisor.py - Shared blackboard → Trip result: provides record
- Trip Digest → Trip result: produces summary
trip_workflow.py - Scenario runner → Trip result: prints results
run_trip_supervisor.py