Sources

Sources are the knowledge content inside a Context Space.

They are not prompts. They are documents that the runtime can read, search, preview in the dashboard, and use as grounding material for an agent run.

File-system sources

The travel guide sample registers local documents from ./Context:

.AddSources(sources => sources.FromFileSystem(
    id: "travel-docs",
    name: "Travel Documents",
    path: "./Context",
    description: "Sample travel planning documents and city guide notes."))

That folder contains files such as:

Context/
  ankara-guide.md
  bursa-guide.md
  istanbul-guide.md
  izmir-guide.md
  london_city_guide.pdf

For another domain, the same structure could be:

SupportDocs/
  refund-policy.md
  account-troubleshooting.md
  escalation-rules.md
  release-notes.json

Supported file types

The current file-system reader supports:

Files larger than the reader limit are skipped. The default file-system reader limit is 5 MB per file.

How source search works

When an agent with an attached Context Space runs, the runtime searches source documents using the user message.

The current implementation is deterministic text search, not a vector database. That makes the behavior simple to inspect and predictable for the sample runtime.

Grounding behavior

Source excerpts are added under Runiq Retrieved Source Context when relevant results are found.

The generated instruction text tells the model to prefer retrieved excerpts over general knowledge when they directly answer the request.

If no source excerpts are retrieved, the instructions explicitly tell the model not to claim it has read source contents.

Dashboard preview

The sources view groups readable documents by source and lets you preview the selected file content used for deterministic context search.

The dashboard can list source document groups and preview supported documents. Preview protects against unsafe paths and blocks common app settings/secrets file names.