The Knowledge Base lets you feed custom documentation into the IaC AI assistant. Add your internal runbooks, architecture docs, module READMEs, or any reference material — the AI will retrieve and cite relevant content when generating code or answering questions in the IaC editor chat.
Provide a URL or paste markdown content in Settings → IaC → Knowledge Sources.
ops0 fetches and processes the content in the background. Status moves from Pending → Indexing → Indexed.
Content is split into chunks and stored as vector embeddings using OpenAI text-embedding-3-small.
When you ask the AI assistant a question, relevant chunks are retrieved from your knowledge base and included in the AI's context automatically.
Navigate to Settings → IaC → Knowledge Sources to manage your knowledge base.
Click the + Add Source button.
Select URL (fetch from a web page) or Markdown (paste content directly).
For URLs: enter the full URL (e.g. https://docs.mycompany.com/platform/networking).
For Markdown: paste your content into the text area.
Give the source a descriptive name and optional tags for organization.
Click Save. Ingestion begins immediately in the background.
| Status | Meaning |
|---|---|
| Pending | Queued for ingestion |
| Indexing | Currently fetching and embedding content |
| Indexed | Ready — the AI will use this source |
| Failed | Ingestion failed (check URL accessibility or content format) |
| Disabled | Source exists but is excluded from retrieval |
| Action | Description |
|---|---|
| Edit | Update name, tags, or scope |
| Reindex | Re-fetch and re-embed the source (use after content updates) |
| Disable / Enable | Toggle whether the source is used in retrieval |
| Delete | Remove source and all its embeddings |
ops0 fetches the page at the provided URL and extracts the readable text content. Useful for:
The URL must be publicly accessible or reachable from the ops0 backend. Password-protected pages and pages that require JavaScript rendering may not ingest correctly. Use the Markdown source type for those.
Paste raw Markdown content directly. Useful for:
Sources can be scoped to control which projects can use them:
| Scope | Behaviour |
|---|---|
| Organization | Available to all projects in the org |
| Project | Available only to a specific IaC project |
Set scope when creating or editing a source.
When you ask a question in the IaC editor chat, the assistant:
This means questions like "How should we configure our internal VPC module?" or "What's the company standard for tagging?" can be answered using your own docs rather than generic provider documentation.
Knowledge Base requires an OpenAI API key configured in Settings → API Configuration. Without it, sources can be saved but ingestion will fail.
If the source content has changed (e.g. you updated your wiki page), reindex the source to pick up the changes:
Reindexing re-fetches the URL or re-processes the markdown and rebuilds all embeddings for that source.
The ingestion job may have timed out. Click Reindex to retry.
Common causes:
