Knowledge

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

What counts as knowledge

• Uploaded files (PDF, Markdown, plain text)
• Pasted text blocks with an optional title
• Synced URLs that Thoth 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. Thoth extracts text and indexes it. Re-upload a file to refresh it.

Paste

Paste documentation, answers, or notes directly. Give it a title so you can find it later. Good for internal runbooks or short procedures that are not in a public doc.

URL

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

Plan	Max URL sources	Refresh frequency
Free	1	Every 24 hours
Plus	5	Every hour
Enterprise	50	Every 15 minutes

If a URL fails to sync, the status column will show 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 intermediate pages that eventually require auth.

Fix the URL or the page's visibility, then trigger a manual re-sync from the row actions.

The ingest command

You can also add short notes straight from Discord:

/ingest content:Your text here title:Optional title

This is handy for capturing something that just came up in a ticket that you want available immediately. For larger or structured content, prefer the dashboard.

Playground

Playground is the place to test how Thoth will actually behave.

• Type a question the way a user would.
• See the answer Thoth would give.
• See exactly which chunks were retrieved and their scores.
• See any custom tool calls and their results.

Use Playground to:

• Validate that new docs produce good answers before you rely on them.
• Debug why a certain question is not answered well.
• Test the effect of rephrasing or splitting docs.
• Verify that a custom tool is invoked when it should be.

Do not use /thoth askgpt for this. askgpt is a general chat with the model; it ignores your knowledge base and consumes AI quota.

Tips vs long-form knowledge

Knowledge is for reference material and procedures. Tips (from auto-learn or manual entry) are for short, repeated answers. Both are searched together.

See Tips and Auto-learn.

Keeping knowledge healthy

• Remove or update stale content.
• Split very long documents into focused sections when answers are weak.
• Watch Insights → Knowledge gaps for escalations where Thoth had nothing relevant to retrieve.
• Use Playground regularly when you add or change docs.

Related: Tips, Auto-learn, Insights (especially Knowledge gaps), Commands (/ingest).