🤖 AskFora Multi-Agent Swarm Architecture

Intelligent Coordination of Specialized AI Agents

🔄 Agent Swarm Coordination Flow
1
User Message
Message received via WebSocket
2
Theme Analysis
Intent analysis & agent selection
3
Parallel Processing
Multiple agents generate responses
4
Reconciliation
Eliminate conflicts & duplicates
5
Specialist Referral
Automated handoff when needed
6
Orchestrated Delivery
Timed, coherent response delivery
💻 User Interface Layer
Web Client React frontend with real-time updates
WebSocket Bidirectional real-time connection
Session Manager User state & authentication
🔄 Communication & Routing Layer
Message Router Route messages to appropriate services
Message Queue DBOS queue system for reliable delivery
Notification Dispatcher Multi-client message delivery
Streaming Service Real-time message streaming
🧠 Core Agent Processing Layer (The Brain)
Theme Analysis Analyzes user intent & conversation context
Character Service Fora, Jan, Lou response generation
Reconciliation Engine Eliminates duplicates & improves flow
Conversation Manager Cycle management & pacing control
Sequential Engine Multi-round conversation orchestration
Onboarding Service Private to group transition flow
💬 Conversation Types
Private Chat 1:1 onboarding with Fora for user assessment
Group Chat Main conversations with Fora, Jan & Lou
Specialist Chat Expert referrals for deep expertise
👥 Specialist Agent System
Main Characters
F
Fora
Leadership Coach - Onboarding & Guidance
J
Jan
Practical Advisor - Direct Solutions
L
Lou
Empathetic Supporter - Emotional Intelligence
Specialist Agents (8)
💼
Nat - Expert Negotiator
Salary negotiation, promotions, resources
🎤
Irv - Interview Prep Expert
Interview prep, behavioral questions, narratives
📄
Ren - Resume Perfectionist
Resume/cover letters, LinkedIn, personal branding
🤝
Des - Conflict De-escalation
Conflict resolution, difficult conversations
🛡️
Bon - Boundary Setting
Saying no, boundaries, workload management
🎯
Pri - Presentation Wizard
Presentation skills, storytelling, public speaking
📊
Eva - Analysis Expert
Excel, data analysis, pivot tables, spreadsheets
📅
Mit - Meeting Maven
Meeting prep, agendas, facilitation, follow-ups
💾 Data & Persistence Layer
Conversations Full conversation history
Messages Individual message storage
Sessions User session tracking
User Profiles User context & preferences
Cycle State Conversation pacing state
Referral Context Specialist handoff data
🔌 External Services Layer
LLM Service AI model orchestration
Gemini API Google's AI capabilities
DBOS Runtime Durable execution framework
PostgreSQL Primary data store
WebSocket Server Real-time connection infrastructure