What Is a Topic Graph?
The breadth layer. Continuously indexes code, repos, PRs, tickets, docs, owners. The substrate the Decision Graph sits on top of.
What a Topic Graph is
A Topic Graph is the substrate layer beneath Naboo's Reasoning Layer. It continuously indexes the customer's enterprise dataset across every connected source system (code, tickets, PRs, docs, Slack, monitoring), links documents to each other through explicit references (foreign keys, ticket IDs, PR numbers) and implicit references (Slack mentions, branch-name conventions), resolves identities across tools (one person maps to one node everywhere), and enforces document-level permissions on every node at retrieval time.
What it is not
A Topic Graph is not a vector database - it does not retrieve by semantic similarity. It is not a knowledge graph in the traditional entities-and-relationships sense - it does not require an ontology design before ingestion. It is not enterprise search - it does not return ranked document lists for human consumption. It is infrastructure for AI agents that need to traverse a connected corpus while respecting source-system permissions.
How the Topic Graph supports the Decision Graph
The Decision Graph (decisions as first-class nodes with owners, triggers, blockers) is built on top of the Topic Graph (the corpus, linked and ranked). Decisions reference evidence - a PR, a ticket, a Slack thread - and the Topic Graph is what makes those references retrievable. When an agent asks 'what's blocking checkout v2,' the Decision Graph returns the chain of decisions; the Topic Graph supplies the supporting evidence each decision points at. The two are different layers solving complementary problems.
Implicit-reference linking - the part RAG misses
Most decisions in an enterprise are joined by references no schema captures: a branch name that carries a ticket ID, a flag key hard-coded in a PR, a Slack thread that references both. RAG indexes each source independently and finds documents by content similarity; the implicit join between them is invisible. A Topic Graph reads these implicit references as first-class edges in the graph, so an agent traversing from 'this stack trace' can reach 'the PR that introduced the regression' and 'the Slack thread where the team debugged it' through their actual relationship - not through coincidental word overlap.
FAQ
Is a Topic Graph a knowledge graph?
Topologically yes - it's a graph of nodes (documents, entities, people) and edges (references between them). Architecturally it's different: a knowledge graph typically requires an ontology designed up-front by a data engineering team, while a Topic Graph bootstraps from the customer's tools without an ontology project. The Decision Graph layer adds the typed, decision-shaped semantics on top.
How is permission-aware retrieval enforced?
Source-system ACLs (GitHub teams, Jira projects, Slack channels, Confluence spaces, internal RBAC) are mirrored into the graph and checked at every traversal. Documents whose ACL excludes the requesting user are not retrievable for that user - not 'retrieved and then filtered out,' but never included in the candidate set. This is the architectural difference from RAG's typical post-retrieval permission filtering.
What's the ingestion cadence?
Continuous. Naboo connects via APIs, webhooks, and event streams - CDC where supported, polling at the right cadence elsewhere. New PRs, ticket updates, Slack messages flow into the graph in near-real-time. Stale-snapshot freshness (daily, weekly) is a non-starter for production AI agents.
Do customers need to model their data first?
No. The Topic Graph layer bootstraps from the customer's existing tools without a data-modeling project. The Decision Graph layer (the typed semantic overlay) is where the elicitation happens - typically 2-4 weeks via Forward Deployed Agent.
Related reading
Reasoning Layer for Enterprise AI Agents
Definition, architecture, and the two tiers - Topic Graph and Decision Graph.
Read moreDefinitionWhat is a Decision Graph for AI Agents?
Decisions as first-class nodes - owners, triggers, blockers, evidence. The primitive AI agents need to act.
Read moreHow-toHow to Build a Decision Graph
Seven concrete steps from elicitation to a queryable graph. Two to four weeks via Forward Deployed Agent.
Read moreCFO briefHow to Reduce LLM Token Costs
Don't meter the waste, cut the cause. Reasoning Layer vs observability and caching, compared.
Read moreGuideImprove AI Agent Accuracy
Accuracy is upstream of evals. Four causes of enterprise AI inaccuracy and how a Reasoning Layer fixes them.
Read moreArchitectureConnect Enterprise Data Sources
Live joins vs stale copies. Warehouse, ETL, knowledge graphs, and Reasoning Layer compared.
Read moreGuideOvercome GenAI Hallucinations
Hallucinations are a context-handoff problem, not a model problem. Four causes, one upstream fix.
Read moreROIHow Naboo Saves Cost
Five places Naboo cuts cost in enterprise AI deployments. Four-minute explainer video.
Read moreHubCompare Naboo
Every category enterprise AI buyers weigh against the Reasoning Layer - in one place.
Read moreComparisonNaboo vs Helicone
Reasoning Layer cuts the cause; Helicone measures the waste. Composable.
Read moreComparisonNaboo vs Langfuse
Different layers. Langfuse versions + traces; Naboo grounds the agent.
Read moreComparisonNaboo vs LlamaIndex
RAG framework vs Reasoning Layer. When to use each.
Read moreComparisonNaboo vs LangChain
Orchestration vs substrate. Compose them.
Read moreBackgroundWhy retrieval was the wrong foundation
How enterprise AI agents got built on RAG, why it falls short, and what a reasoning layer fixes.
Read moreComparisonNaboo vs RAG
Retrieval vs reasoning - head-to-head benchmarks, architecture, and when to use each.
Read moreComparisonNaboo vs Glean
Enterprise search vs reasoning layer - when each fits.
Read moreConceptAI Search vs Reasoning Layer
Search returns links; the reasoning layer returns the chain. When to use which.
Read moreCase studyGlobal-E case study
How Global-E (NASDAQ: GLBE) gave AI agents secure access to customer data.
Read moreComparisonCompare alternatives
Naboo vs other enterprise AI agent infrastructure platforms.
Read moreGo deeper
The full architecture and customer story live on the dedicated page.