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

# Knowledge

> The sources an agent answers from, grounded so it doesn't make things up.

**Knowledge** is what your agent draws on to answer accurately. You add sources — your help
center URL, uploaded documents, FAQs, or plain text — and the platform indexes them so the
agent retrieves the right passage at answer time instead of guessing.

## Adding a source

Ingestion is **asynchronous**: after you add a source it moves through `pending` → `indexed`.
Poll the source until it's `indexed` before relying on it. You can preview what the agent would
retrieve for a question to sanity-check coverage.

## Knowledge gaps

When callers ask things your knowledge doesn't cover, those questions surface as **knowledge
gaps** so you can close them — the loop that makes the agent better over time.

## In the API

| Action              | Endpoint                                  |
| ------------------- | ----------------------------------------- |
| Add a source        | `POST /agents/{id}/knowledge/sources`     |
| Check ingest status | `GET /agents/{id}/knowledge/sources/{id}` |
| Preview retrieval   | `POST /agents/{id}/knowledge/preview`     |
| Review gaps         | `GET /agents/{id}/knowledge-gaps`         |