Knowledge sources
Attach maintained web pages to an agent, control fetch frequency, validate ingestion, and recover from stale or failed sources.
Knowledge sources are URLs fetched on a schedule and added to an agent’s working context. Use them for maintained handbooks, product documentation, policies, and other evidence the agent should cite or summarize.
Before you add a source
The page should be accessible without an interactive sign-in, stable at one URL, and written so its important facts exist as text. Do not attach a page that exposes secrets or information the agent’s audience should not receive.
Prefer several narrow sources over one unbounded site root. A source is evidence, not a permission system.
Add a source
- Open the agent card on the Agents page.
- In Knowledge sources, enter the source URL.
- Choose a fetch frequency:
- Every 5 minutes for actively edited, operational material;
- Every hour for documentation that changes throughout the day;
- Every 24 hours for stable reference.
- Select Add source.
- If you need the content immediately, select the circular-arrow control labeled Fetch now.
Read the source state
| State | Meaning | Next action |
|---|---|---|
| Never fetched | The source exists but has not completed a fetch. | Wait for its schedule or use Fetch now. |
| OK | The latest fetch completed. | Test a question whose answer appears only in this source. |
| Error | The latest fetch failed. | Check the URL, authentication, redirects, availability, and page format. |
The last fetch timestamp tells you when Infra One last observed the page. A green state does not prove that the page contains the answer you expect; it proves the fetch succeeded.
Maintain sources
- Disable a source before a major rewrite if serving stale content would be harmful.
- Use Fetch now after publishing an urgent correction.
- Retest a representative question after every substantial source change.
- Remove sources that duplicate or contradict an authoritative page.
- Keep the fetch frequency proportional to how often the source genuinely changes.
Success check
The source shows OK, its latest fetch time is newer than your edit, and the agent can answer a question that depends on the new text. When asked beyond that text, it still follows the uncertainty behavior in the system prompt.