How ahmedsheikh27/air-travel-agent works
Air Travel Agent is a web-based airline assistant: passengers open the chat, send requests to the FastAPI backend, and receive answers or booking details and a ticket. Backend triage delegates questions to FAQ or seat-booking agents; booking updates shared passenger context, then the API saves confirmed bookings and serves ticket PDFs. The README documents MongoDB and LLM-provider configuration. Frontend chat-to-API details and some backend implementation are not shown, so those connections are limited to documented relationships.
Main entry points: main.py FastAPI routes · triage_agent.py Triage agent · faq_agent.py FAQ agent · seat_booking_agent.py Seat booking agent
Components 14
Chat frontend
- Chat entry
airline-chatbot-frontend/app/page.tsx - Chat interface
airline-chatbot-frontend/components/ChatInterface.tsx
API and conversation
- FastAPI routes
air-backend/main.py - Conversation processing
air-backend/main.py
Assistant agents
- Triage agent
air-backend/airline_agents/triage_agent.py - FAQ agent
air-backend/airline_agents/faq_agent.py - FAQ lookup
air-backend/tools/faq_tools.py - Seat booking agent
air-backend/airline_agents/seat_booking_agent.py
Booking and tickets
- Seat update tool
air-backend/tools/booking_tools.py - Ticket generation
air-backend/tools/booking_tools.py
Passenger state
- Passenger context
air-backend/models/context.py - MongoDB
Other components
- Passenger
- Gemini API
Connections 22
- Passenger → Chat entry: opens
airline-chatbot-frontend/app/page.tsx - Chat entry → Chat interface: renders
airline-chatbot-frontend/app/page.tsx - Passenger → Chat interface: sends requests
- Chat interface → FastAPI routes: calls backend
README.md - FastAPI routes → Conversation processing: processes messages
air-backend/main.py - Conversation processing → Triage agent: runs agent
air-backend/main.py - Triage agent → FAQ agent: hands off
air-backend/airline_agents/triage_agent.py - Triage agent → Seat booking agent: hands off
air-backend/airline_agents/triage_agent.py - FAQ agent → Triage agent: returns control
air-backend/airline_agents/triage_agent.py - Seat booking agent → Triage agent: returns control
air-backend/airline_agents/triage_agent.py - FAQ agent → FAQ lookup: calls lookup
air-backend/airline_agents/faq_agent.py - Seat booking agent → Seat update tool: calls tool
air-backend/airline_agents/seat_booking_agent.py - Seat update tool → Passenger context: updates
air-backend/tools/booking_tools.py - Conversation processing → Passenger context: uses
air-backend/main.py - FastAPI routes → MongoDB: saves bookings
air-backend/main.py - FastAPI routes → Seat update tool: generates ticket
air-backend/main.py - FastAPI routes → Ticket generation: serves PDF
air-backend/main.py - Ticket generation → Passenger context: renders details
air-backend/tools/booking_tools.py - FastAPI routes → MongoDB: reads bookings
air-backend/main.py - FAQ agent → Gemini API: queries model
- Seat booking agent → Gemini API: queries model
- Triage agent → Gemini API: queries model