> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delphina.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Flywheel Agents

> The four agents that keep your knowledge base honest, what they do on their own, and what you can change

Four agents keep the [knowledge flywheel](https://docs.delphina.ai/context-layer.md) turning. They read your conversations, check the knowledge base against your warehouse, fix what has only one right answer, and bring the rest to your team as a question. You can see all four, and when each last ran, from the **Context Factory** page.

| Agent | Cadence | What it does |
| - | - | - |
| [**Validation**](#validation) | Weekly and daily | Checks the knowledge base against the live warehouse, and reviews recent additions for duplication and misplacement. |
| [**Chat review**](#chat-review) | Daily | Files an issue for each knowledge gap a real conversation exposed. |
| [**Issue triage**](#issue-triage) | Daily | Researches each new issue and ends it: fixed, closed, snoozed, or needing an answer. |
| [**Questions to your team**](#questions-to-your-team) | Weekdays | Asks the people who know, in Slack, and reminds them. |

Everything they find lands in the [Inbox](https://docs.delphina.ai/knowledge-agent/inbox.md) as an issue carrying the research behind it.

> [!NOTE]
>
> You don't need to build a workflow to find knowledge gaps from chat history,
> or to validate SQL and wiki links on a schedule. Those run for you. Reach for
> a [workflow](https://docs.delphina.ai/analytics-agent/workflows.md) only for a recurring job specific to
> your organization that none of the agents covers.

## Validation

Validation runs two passes on different cadences.

**Knowledge validation**, weekly, checks the knowledge base against your live warehouse and reports:

* SQL that fails or times out
* Tables and columns that no longer exist, or that exist but are undocumented
* Broken wiki links between documents
* Empty documents

Critical findings become issues in the Inbox.

**Organization review**, daily, looks at the last day's additions for content that is duplicated, contradictory, or in the wrong place — the drift that comes from several people documenting the same area in the same week.

Validation is the one agent whose schedule you don't set; it runs on Delphina's. Its settings — which parts of the knowledge base a run focuses on, how far back the organization review looks, and the column-name patterns that need no documentation — are visible on the Context Factory page but changed by Delphina. Ask your contact to adjust one.

To run knowledge validation ahead of its schedule, for example right after a large warehouse change, see [Making a change now](https://docs.delphina.ai/knowledge-agent/maintenance.md#making-a-change-now).

## Chat review

Chat review reads every conversation from the past day and files an issue for each gap in the knowledge base it exposed, ranked by how often the gap comes up. A term the agent had to guess at twice is a stronger signal than one it guessed at once.

This is the agent that makes real usage drive documentation, rather than someone deciding up front what to write. It takes no settings beyond its schedule.

## Issue triage

Triage picks up each new issue, researches it, and ends it in one of four places: **fixed**, **closed**, **snoozed** until whatever it waits on changes, or moved to **needs input** with a specific question for a specific person.

You can set:

* **Issues per run** — the most issues one run researches. 50 by default.
* **Additional fixes** — kinds of change Delphina may make in your workspace without asking, on top of the standard set below.

Delphina sets the rest: whether triage takes every issue or only the ones Delphina filed, and how long an issue waits for its answer before triage re-checks that it still holds.

### What Delphina fixes without asking

Triage applies a deliberately narrow set of changes on its own — the kind where there is only one right answer:

* **Mechanical fixes:** broken wiki links, typos in prose, outdated column lists, a table name that isn't fully qualified.
* **Reorganization:** restructuring a document, or deduplicating a concept stated in several places by keeping one copy and linking to it.
* **Filling gaps from the live schema:** adding a table document the knowledge base is missing, or the columns a table document lacks, marking anything the evidence doesn't establish as unknown.
* **Removing a column** the live schema no longer has, leaving a warning on each document that still uses it rather than editing the logic.

It never changes a formula, a filter, or an identifier on its own. Those go to your team as a question.

## Questions to your team

When triage decides something needs a person, this agent asks them — in Slack, by mention, so the question reaches someone rather than sitting in a queue. It follows up on questions that go unanswered.

Answers are recorded against the question on the issue, not lost in a thread, and an answer returns a needs-input issue to open. See [Comments and questions](https://docs.delphina.ai/knowledge-agent/inbox.md#comments-and-questions).

You can set **questions per run** — the most new questions one run asks, 3 by default, so a quiet week doesn't turn into a flood. Who gets asked is set by Delphina, from what it can infer about who owns an area.

## Changing what they do

Schedules for chat review, issue triage, and questions are yours to set from the **Context Factory** page, along with the per-agent settings above. Everything else shown there — routing, re-check intervals, and any instructions specific to your organization — is set by Delphina; ask your contact to change one.

## Related

* [Context Factory](https://docs.delphina.ai/context-layer.md) — the flywheel these agents turn
* [Inbox](https://docs.delphina.ai/knowledge-agent/inbox.md) — where their findings land
* [Knowledge Base](https://docs.delphina.ai/knowledge-agent/knowledge-base.md) — browsing the knowledge base and its version history
* [Maintenance](https://docs.delphina.ai/knowledge-agent/maintenance.md) — editing knowledge by hand


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.