Swarm Project Structure Example

🌟 Swarm Project - Intelligent Tour Management System

📝 Description

An advanced tour management system using multiple specialized agents to handle availability queries, cancellations, and reviews through a conversational interface.

✨ Key Features

• 🤖 Specialized multi-agent system
• 📅 Availability and booking management
• ❌ Cancellation processing
• ⭐ Reviews and feedback system
• 🔄 Automatic request triage

📁 Project Structure

swarm/
├── configs/
│ ├── agents/
│ │ └── types.py # Specialized agent definitions
│ ├── data/
│ │ └── context_variables.py # Context variables
│ ├── tools/
│ │ ├── tools.py # Core tools and functions
│ │ └── switchers.py # Agent switching functions
│ └── prompts.py # Agent instructions
└── main.py # Application entry point

🤖 Specialized Agents

Agent	Function
Triage	Evaluates and routes requests to appropriate agent
Availability	Handles calendar queries and bookings
Cancellation	Processes cancellation requests
Reviews	Manages feedback and ratings

🛠️ Core Functionality

📅 Availability Management

• Date availability verification
• Available time slots querying
• Calendar information
• Operating hours
• Booking process

❌ Cancellation Management

• Request processing
• Cancellation policies
• Refund handling
• Reason documentation

⭐ Review System

• Review submissions
• Feedback management
• Rating system
• Opinion collection

🚀 Environment Setup

1. Clone repository
2. Install Swarm package:

pip install git+https://github.com/openai/swarm.git

1. Install other dependencies
2. Configure environment variables (.env)
3. Run python main.py

🔄 Context Variables

The system uses two types of context:

• Customer Context: User-specific information
• General Context: System-wide information

🛠️ Available Tools

• Availability checking
• Schedule querying
• Calendar management
• Tour booking
• Agent switching syste