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

# Knowledge sources

> Choose the repositories, pages, drives and channels Synapse indexes for search, who can find each one, and what each status and action means

**Knowledge sources**, under **Admin** at [synapse.synheart.ai](https://synapse.synheart.ai), are the repositories, pages, drives and channels whose text Synapse indexes. Their text is what [Ask Synapse](https://docs.synheart.ai/synapse/search.md) and your agents' `recall` find.

This is separate from [Connectors](https://docs.synheart.ai/synapse/connectors.md). Connecting a tool collects activity, never its text. Text is indexed only from the sources chosen here.

Synapse Admins choose and change knowledge sources.

![The Knowledge sources page, with an Add source button, filter chips, and a GitHub group listing repositories with their status and document counts](https://mintcdn.com/synheartai/bIbSKNEqulE95GhK/images/synapse/knowledge-sources.png?fit=max\&auto=format\&n=bIbSKNEqulE95GhK\&q=85\&s=c6feb06ac07fcb3ba4a76c48d2757eb2)

Knowledge sources, grouped by provider

## Adding a source

Choose **Add source**, then pick the kind:

* **GitHub**: a repository's Markdown docs, RFCs and ADRs. The GitHub app must be able to see the repository.
* **Notion**: pages shared with Synapse.
* **Google Drive**: a shared drive.
* **Slack**: a public channel.

The provider has to be connected under **Admin → Connectors** first. Each kind says who will be able to search it before you add it. OneDrive folders are chosen by members themselves. See [OneDrive as a knowledge source](https://docs.synheart.ai/synapse/microsoft-365.md#onedrive-as-a-knowledge-source).

## Who can find what

Each document keeps the audience it has at its source, and every search filters on it.

| Source | Who can find it |
| - | - |
| **GitHub**, **GitLab** | Everyone in your organization |
| **Notion** | Members who shared the page |
| **Google Drive** | Members who linked Google Drive and can open the file |
| **Slack** | Everyone in your organization, from public channels, for the last 90 days |

More on this in [Ask Synapse: who sees what](https://docs.synheart.ai/synapse/search.md#who-sees-what).

## Statuses

Use the chips at the top to show one group at a time.

| Filter | Means |
| - | - |
| **Needs review** | Indexed before admins chose sources. Keep each one or stop indexing it. |
| **Needs attention** | Failed, not indexed yet, partly read, or waiting on members to link an account. Each row says what to do. |
| **In progress** | Queued, indexing or syncing, or paused and resuming on its own. |
| **Indexed** | Has searchable text, and nothing to do. |
| **No documents** | Nothing searchable reported yet. |

Each row shows how many documents are indexed and when it last finished.

## Row actions

* **Index now** or **Retry**: start indexing a source that hasn't been indexed, or try again after a failure.
* **Keep**: keep a source from **Needs review**. It stays searchable.
* **Sync now**: re-read a source straight away, rather than waiting for the next scheduled sync.
* **Stop indexing**: asks you to confirm first. Its indexed text is deleted from Synapse and it stops being searchable. Nothing in the source tool is touched, and adding it again re-indexes it.

## Who can do what

| Action | Who |
| - | - |
| Search indexed knowledge | Everyone with a seat, within each source's audience |
| Add, keep, sync and stop indexing sources | Synapse Admins |


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