Orchestration Agent Example

June 13, 2026 ยท View on GitHub

This example demonstrates how to create an Orchestrator Agent that intelligently decides between using a search tool or a calculator tool based on user input.

Features

  • Intelligent tool selection between search and calculator tools
  • Dynamic input/output schema handling
  • Real-time date context provider
  • Rich console output formatting
  • Final answer generation based on tool outputs

Getting Started

  1. Clone the Atomic Agents repository:

    git clone https://github.com/eigenwise/atomic-agents

  2. Navigate to the orchestration-agent directory:

    cd atomic-agents/atomic-examples/orchestration-agent

  3. Install dependencies using uv:

    uv sync

  4. Set up environment variables: Create a .env file in the orchestration-agent directory with:

    OPENAI_API_KEY=your_openai_api_key

  5. Install SearXNG (See: https://github.com/searxng/searxng)

  6. Run the example:

    uv run python orchestration_agent/orchestrator.py

Components

Input/Output Schemas

  • OrchestratorInputSchema: Handles user input messages
  • OrchestratorOutputSchema: Specifies tool selection and parameters
  • FinalAnswerSchema: Formats the final response

Tools

These tools were installed using the Atomic Assembler CLI (See the main README here for more info) The agent orchestrates between two tools:

  • SearXNG Search Tool: For queries requiring factual information
  • Calculator Tool: For mathematical calculations

Context Providers

  • CurrentDateProvider: Provides the current date in YYYY-MM-DD format