Chat Sources
Give Chat extra context by uploading documents and links from the dashboard.
Chat Sources are documents and links you attach from the dashboard so the Chat capability can answer questions your Application Knowledge Graph doesn't cover, such as pricing details, an FAQ, or help-center content.
Chat Sources is distinct from the Knowledge Graph: the Knowledge Graph describes your product's structure (routes, entities, flows), generated by arcy analyze and edited by your team. Chat Sources is free-form reference material you attach directly, with no code changes and no redeploy.
Adding a source
From your app's dashboard page, open Knowledge Base > Sources.
- Upload a document. PDF, TXT, or MD, up to 10MB per file.
- Add a link. Any public URL. ARCY fetches the page and extracts its text content.
Each app can have up to 20 Chat Sources.
Ingestion status
A newly added source starts Pending while ARCY extracts, chunks, and embeds its content in the background. This does not block the dashboard — you can keep working while it processes.
| Status | Meaning |
|---|---|
pending | Still processing. Not yet usable by Chat. |
ready | Available to Chat. Chat may draw on this source's content. |
failed | Processing failed (for example, a link that couldn't be fetched, or unreadable file content). Remove it and try again. |
How Chat uses a source
When answering a question, Chat retrieves the most relevant passages across your Chat Sources, ranked by relevance to the question, and includes them in its context alongside your Knowledge Graph. If Chat Sources retrieval is unavailable for any reason, Chat still answers from the Knowledge Graph — a Chat Sources issue never breaks Chat.
Consent
Chat Sources ingestion is gated by the same enrichment consent your workspace already uses for Knowledge Graph enrichment (Organization.enrichment). If your workspace requires consent and hasn't granted it, adding a source fails clearly in the dashboard rather than silently doing nothing.
Removing a source
Delete a source from Knowledge Base > Sources at any time. Chat stops drawing on it immediately.
See also
- AI Modes: how Chat, Copilot, and Autopilot work
- Element Targeting: how ARCY finds elements on your page (used by Copilot and Autopilot, not Chat)