How cuiyuheng/multi-agent-orchestrator works
Multi-Agent Orchestrator is a Python and TypeScript framework for routing multi-turn conversations among specialized AI agents. The principal workflow loads conversation context, classifies the user’s intent against available agents, dispatches the request, and saves the exchange before returning the response. The graph preserves both language implementations, built-in agent and classifier families, retrieval, and pluggable conversation storage. Relationships follow the README’s workflow and the shown orchestrator calls or imports; unsampled agent details are represented at their existing directories rather than inferred individually.
Main entry points: orchestrator.ts TS orchestrator · orchestrator.py Python orchestrator · chatStorage.ts TS chat storage · chat_storage.py Python chat storage
Components 21
Orchestration
- TS orchestrator
typescript/src/orchestrator.ts - Python orchestrator
python/src/multi_agent_orchestrator/orchestrator.py - Streaming helpers
typescript/src/utils/helpers.ts
Intent routing
- TS classifier base
typescript/src/classifiers/classifier.ts - TS classifier variants
typescript/src/classifiers - Python classifier base
python/src/multi_agent_orchestrator/classifiers/classifier.py - Python classifier variants
python/src/multi_agent_orchestrator/classifiers - Agent overlap analysis
typescript/src/agentOverlapAnalyzer.ts
Agent execution
- TS agent contract
typescript/src/agents/agent.ts - TS agent implementations
typescript/src/agents - Python agent contract
python/src/multi_agent_orchestrator/agents/agent.py - Python agent implementations
python/src/multi_agent_orchestrator/agents
Context and retrieval
- TS chat storage
typescript/src/storage/chatStorage.ts - TS memory storage
typescript/src/storage/memoryChatStorage.ts - TS DynamoDB storage
typescript/src/storage/dynamoDbChatStorage.ts - Python chat storage
python/src/multi_agent_orchestrator/storage/chat_storage.py - Python memory storage
python/src/multi_agent_orchestrator/storage/in_memory_chat_storage.py - Python DynamoDB storage
python/src/multi_agent_orchestrator/storage/dynamodb_chat_storage.py - TS knowledge retrieval
typescript/src/retrievers - Python knowledge retrieval
python/src/multi_agent_orchestrator/retrievers
Other components
- User
Connections 23
- User → TS orchestrator: submits request
- User → Python orchestrator: submits request
- TS orchestrator → TS chat storage: loads history
typescript/src/orchestrator.ts - TS orchestrator → TS classifier base: classifies intent
typescript/src/orchestrator.ts - TS orchestrator → TS agent implementations: dispatches request
typescript/src/orchestrator.ts - TS orchestrator → TS chat storage: saves exchange
typescript/src/orchestrator.ts - TS orchestrator → TS memory storage: defaults to
typescript/src/orchestrator.ts - TS orchestrator → Agent overlap analysis: analyzes overlap
typescript/src/orchestrator.ts - TS classifier base → TS agent contract: uses agent descriptions
typescript/src/classifiers/classifier.ts - TS classifier variants → TS classifier base: extends classifier
typescript/src/classifiers/bedrockClassifier.ts - TS agent contract → Streaming helpers: uses stream accumulator
typescript/src/agents/agent.ts - TS agent implementations → TS knowledge retrieval: retrieves knowledge
typescript/src/agents/bedrockLLMAgent.ts - TS chat storage → TS memory storage: implemented by
typescript/src/storage/memoryChatStorage.ts - TS chat storage → TS DynamoDB storage: implemented by
typescript/src/storage/dynamoDbChatStorage.ts - Python orchestrator → Python chat storage: uses storage
python/src/multi_agent_orchestrator/orchestrator.py - Python orchestrator → Python classifier base: uses classifier
python/src/multi_agent_orchestrator/orchestrator.py - Python orchestrator → Python agent implementations: dispatches request
python/src/multi_agent_orchestrator/orchestrator.py - Python classifier base → Python agent contract: uses agent descriptions
python/src/multi_agent_orchestrator/classifiers/classifier.py - Python classifier variants → Python classifier base: extends classifier
python/src/multi_agent_orchestrator/classifiers/__init__.py - Python agent contract → Python agent implementations: implemented by
python/src/multi_agent_orchestrator/agents/__init__.py - Python agent implementations → Python knowledge retrieval: retrieves knowledge
python/src/multi_agent_orchestrator/agents/bedrock_llm_agent.py - Python chat storage → Python memory storage: implemented by
python/src/multi_agent_orchestrator/storage/in_memory_chat_storage.py - Python chat storage → Python DynamoDB storage: implemented by
python/src/multi_agent_orchestrator/storage/dynamodb_chat_storage.py