⚡ Production-Grade Architecture

AI-Powered Business Intelligence

An agentic system that orchestrates Power BI and Snowflake through governed, multi-stage pipelines — from natural-language question to validated insight.

Five-Layer Architecture

Each layer has a single responsibility and communicates only with its immediate neighbors.

1

Chat UI

VS Code · Web · Teams

2

Orchestration

Intent → Route → Build → Validate

3

MCP Tools

List · Metadata · Generate · Validate · Execute · Export

4a

Power BI

Semantic Models · DAX

4b

Snowflake

SQL API · Governed Execution

5

Presentation

Markdown · Tables · Charts · Reports · Exports

Four-Stage Processing

Every user question flows through a governed, multi-stage pipeline.

01

Classify Intent

Parse the user's natural-language question to determine intent type — KPI lookup, trend analysis, data exploration, or report generation.

02

Route to Source

Decide whether to query Power BI semantic models or Snowflake based on the intent and available metadata.

03

Build & Validate

Construct a source-specific prompt with metadata, few-shot examples, and business glossary. Validate all generated queries before execution.

04

Execute & Present

Run the validated query against the data source, format results with interpretation, and return actionable output.

10 Production Additions

Beyond the core pipeline — the capabilities that make this production-grade.

🔑

Auth & Token Exchange

Short-lived user tokens exchanged for service credentials. No raw secrets in the extension.

🛡️

Query Validation

Every generated query is validated against a policy engine before execution.

📋

Audit Trail

Full logging of every request — who asked, what ran, what was returned.

Caching Layer

Metadata and frequent queries cached to reduce latency and API calls.

🗺️

Semantic Routing

Embedding-based routing maps questions to the right data source automatically.

📖

Business Glossary

Domain terms resolved to exact column references — "PMPM" becomes the right measure.

🧠

Few-Shot Examples

Curated question→query pairs injected into prompts for higher accuracy.

🚦

Human-in-the-Loop

Dangerous or ambiguous operations require explicit user approval before execution.

📊

Multi-Format Output

Plain English, query, data table, chart suggestion, and export — all in one response.

🔄

Session Memory

Conversation context maintained so follow-up questions resolve correctly.

Deep Dives

Explore each layer in detail.