Sources
Sources are the backbone of answer quality. If the agent cannot retrieve the right material, no prompt tweak will save it.
Sources
Sources are the backbone of answer quality. If the agent cannot retrieve the right material, no prompt tweak will save it.
What You Can Add
The Sources page supports:
- website URLs
- sitemaps
- file uploads
- image uploads
- ZIP archives for bulk upload
What The Page Is For
Use the main Sources page to:
- add new sources
- search across sources
- watch live ingestion progress
- bulk-select and delete sources
- expand ZIP uploads to inspect child files
Use live status first
If a source is still processing, wait for the job to finish before you evaluate the agent in the playground.
Source Lifecycle
Every source moves through one of these states:
| State | Meaning |
|---|---|
| Pending | The source was created but processing has not started yet. |
| Processing | A job is currently ingesting, chunking, or reindexing content. |
| Ready | Documents and chunks are available for retrieval. |
| Error | The ingest job failed and needs review. |
Source Detail Page
Open any source to see more than the list view shows.
The detail page includes:
- a status summary with counts and timestamps
- a configuration panel showing the original source setup
- a Documents tab with chunk counts and metadata
- a Jobs tab with a job timeline, progress, and errors
- a Raw Config tab for exact source configuration
- a Re-ingest action when you need to refresh content
Bulk Uploads
ZIP uploads behave differently from single files:
- the parent source shows overall processing progress
- child files can be expanded under the source row
- processed and failed child counts help you spot bad files quickly
Best Practices
- start with your highest-value pages, not your entire internet footprint
- prefer clean, current help-center content over marketing pages with weak detail
- re-ingest after major content changes
- use source detail pages to inspect failed jobs before retrying blindly
- remove stale or duplicate content if retrieval keeps surfacing the wrong answer
Common Problems
The agent gives outdated answers
- check whether the source is stale
- re-ingest the source
- remove conflicting older files or pages
A source is stuck in error
- open the source detail page
- review the latest job error
- fix the original source content or configuration
- try re-ingesting after the root cause is fixed
Retrieval quality is still weak
- add more focused content instead of more generic content
- review Interceptors for hard rules
- test in Playground with debug panels open
Related Docs
Playground
Test answers, retrieval, prompts, and overrides before production.
Interceptors
Rules for escalation, blocking, tagging, and guaranteed replies.
API Reference
Programmatic source management via the Sources API.