Skip to content

Agentic Workflow Architecture¶

Planned Architecture (Future Phases)

The agentic system is implemented in Phase 5 (Weeks 17–19). This document describes the planned design.

Overview¶

FinSight's agent layer uses LangGraph to orchestrate a multi-agent system. When a user submits a query through the chat interface, the supervisor agent routes it to the appropriate specialist tool — RAG retrieval, SQL generation, or direct LLM analysis.

Agent Graph¶

stateDiagram-v2
    [*] --> SupervisorAgent
    SupervisorAgent --> RAGAgent : semantic question
    SupervisorAgent --> SQLAgent : structured data query
    SupervisorAgent --> AnalysisAgent : summary or comparison
    RAGAgent --> ResponseFormatter
    SQLAgent --> ResponseFormatter
    AnalysisAgent --> ResponseFormatter
    ResponseFormatter --> [*]

Agents¶

Supervisor Agent¶

RAG Agent¶

SQL Agent¶

Analysis Agent¶

MCP Tools¶

Observability with Langfuse¶

Safety and Guardrails¶