Skip to main content
Docs/Architecture

System Architecture

Interactive overview of the AaaS Knowledge Index infrastructure

System Layers

Click each layer to expand and see details. Data flows top to bottom from client requests through the API and service layers into persistent storage.

Agent Ecosystem

31 agents organized into 10 categories. Each agent runs autonomously on a schedule and logs results to Firestore.

Core

5 agents
Audit AgentHealth AgentHeal AgentEnrich AgentSummary Agent

Freshness

3 agents
Freshness AgentChangelog AgentValidate Links Agent

Ranking

3 agents
Rank AgentViews AgentTrending Agent

Classification

2 agents
Categorize AgentSimilarity Agent

Intelligence

3 agents
Embedding AgentClustering AgentDiscovery Agent

Comparison

1 agent
Comparison Agent

Media

4 agents
Media AgentAudio AgentVideo AgentMetadata Agent

Pipeline

3 agents
Ingest AgentAuto Review AgentWebhook Agent

Analytics

3 agents
Search Analytics AgentAnomaly AgentReporting Agent

Engagement

4 agents
Subscription AgentDigest AgentDigest Email AgentAlerting Agent

Data Flow


  User Request                    Agent Scheduler
       |                                |
       v                                v
  +---------+                    +------------+
  | Next.js |                    | 32 Agents  |
  |  Route  |                    | (cron)     |
  +----+----+                    +-----+------+
       |                               |
       v                               v
  +---------+    +---------+    +------------+
  | Service |<-->| Search  |<-->| Pinecone   |
  |  Logic  |    | Engine  |    | (Vectors)  |
  +----+----+    +---------+    +------------+
       |
       v
  +---------+    +---------+    +------------+
  |Firestore|<-->|Webhooks |<-->| Consumers  |
  | (38 col)|    | Engine  |    | (HTTP)     |
  +---------+    +---------+    +------------+
       |
       v
  +---------+
  | Events  |----> SSE Stream ---> Client
  | Timeline|
  +---------+

Integration Points

External systems connect to the knowledge index through these integration mechanisms.

Webhooks

Event-driven HTTP callbacks for entity changes, agent completions, and system events

  • Configurable event filters
  • Automatic retries with exponential backoff
  • HMAC signature verification
  • Delivery logs and debugging

Plugins

Workspace-scoped integrations for extending platform capabilities

  • Custom data sources
  • Third-party tool connectors
  • Workspace-level configuration
  • Permission-scoped access

SDK

JavaScript/TypeScript SDK for programmatic access to the knowledge index

  • Type-safe API client
  • Auto-generated from OpenAPI spec
  • Search and entity operations
  • Webhook management helpers

Embeds

Embeddable widgets for displaying entities, leaderboards, and badges

  • Entity card embeds
  • Leaderboard widgets
  • Badge images (SVG)
  • Customizable themes

By the Numbers

40+

API Endpoints

32

Agents

38

Firestore Collections

6

Entity Types