Knowledge

The knowledge base is the primary source Ogma searches when answering tickets and Playground questions.

What counts as knowledge

• Uploaded files (Markdown, plain text, HTML, JSON, CSV — not PDF)
• Pasted text blocks with an optional title
• Synced URLs that Ogma re-fetches on a schedule

All content is chunked, embedded, and stored per server. Nothing is shared across servers.

Adding content

Upload

Drop one or more documents (max 5 MB each). Ogma extracts text and indexes it. Re-upload a file to refresh it.

Supported formats include .txt, .md, .markdown, .html, .htm, .json, and .csv (not PDF).

Paste

Paste documentation, answers, or notes directly. Give it a title so you can find it later. Good for internal runbooks or short procedures.

URL

Add a publicly accessible page. Ogma will fetch it and re-sync on a schedule based on your plan.

Plan	Minimum interval	Default for new URL sources	Max sources
Free	24 hours	24 hours	1
Plus	1 hour	3 hours	5
Enterprise	15 minutes	1 hour	50

You can set a custom refresh interval per source (minimum depends on plan).

If a URL fails to sync, the status column shows an error. Common causes:

• The page requires login or is behind a firewall.
• The site blocks scrapers or returns non-HTML content.
• The URL redirects through pages that require auth.

Fix the URL or visibility, then trigger Sync now from the source detail view.

Source health

The Knowledge page surfaces source health — problems that cause bad answers before users hit them:

Status	Meaning
Healthy	Synced recently, no errors
Stale sync	Content may be outdated
Sync overdue	Scheduled refresh has not run
Sync failed	Last fetch or index failed
Never synced	URL added but not yet indexed
Never retrieved	Indexed but not used in recent ticket or Playground searches

The Overview page also shows a knowledge sync summary. Fix sync errors and stale sources proactively.

Freshness alerts

Sources flagged as stale or never retrieved in search appear under freshness alerts. These are candidates for update, removal, or Playground testing — content that exists but may not help users.

Duplicate and overlap detection

Ogma scans tips against knowledge docs to find:

• Tips that overlap long-form KB content
• Near-duplicate tips
• Conflicting answers between tips

Review overlaps periodically and merge or delete redundant tips. Last scan time and next available scan are shown on the Knowledge page.

The ingest command

Add short notes from Discord:

/ingest content:Your text here title:Optional title

Handy for capturing something from a live ticket. For larger content, use the dashboard.

Editing and version history

For pasted and uploaded documents, open Edit content on the Knowledge page to change title and body in a VS Code-style editor (Monaco) with syntax highlighting for Markdown, JSON, HTML, and plain text. Use the pencil icon in the folder sidebar to create a new document in the current folder. Each content change:

1. Snapshots the previous version (deduplicated by content hash — identical re-syncs skip new versions and re-embedding).
2. Re-chunks and re-embeds the updated text.

Use Version history in the editor to compare a past version against the current content and Revert when needed. Ogma keeps the last 50 versions per document. URL- and Git-managed docs sync through their normal pipelines; manual edits are for paste/upload sources.

Playground

Playground tests real support behavior:

• Type a question the way a user would.
• See the answer Ogma would give.
• See which chunks were retrieved and their scores.
• See agentic tool calls and results.

Use Playground to validate new docs, debug weak answers, and verify agentic tools. Do not use /ask or /ogma askgpt for this — those ignore your knowledge base.

On a free trial, the dashboard warns before Playground runs that consume AI quota beyond included limits.

Tips vs long-form knowledge

Knowledge is for reference material. Tips are for short, repeated answers. Both are searched together.

See Tips and Auto-learn.

Background jobs

URL syncs and tip backfill batch jobs appear on Background jobs while running. See Background jobs.

Keeping knowledge healthy

• Remove or update stale content when freshness alerts fire.
• Split very long documents when answers are weak.
• Watch Insights → Knowledge gaps for escalations with nothing to retrieve.
• Use Playground after every significant add or edit.

Related: Tips, Auto-learn, Insights, Commands (/ingest), Billing (indexing limits and overage).