> ## Documentation Index > Fetch the complete documentation index at: https://heimdall.gg/docs/llms.txt > Use this file to discover all available pages before exploring further. # Odin AI > AI-powered assistant with configurable conversation context, a knowledge base, and the /ask command. Odin is Heimdall's AI assistant. Members ask questions and receive answers informed by your server's knowledge base - documentation, FAQs, rules, or any other content you upload. Odin maintains conversation context within a session, so follow-up questions work naturally without repeating background information. ![AI Overview](https://mintcdn.com/bifrost-77/VcxrSvJOJIBwPfOg/images/AI_Overview.png?fit=max\&auto=format\&n=VcxrSvJOJIBwPfOg\&q=85\&s=95cdcf854fd5e9a3726cddcd44199578) ## Asking a question ```text theme={null} /ask ``` Members ask any question in plain language. Odin answers from your knowledge base and cites the entries it used. By default `/ask` answers only from the knowledge base: if the knowledge base does not cover the question, Odin says so instead of guessing and offers the member a way to reach staff (a ticket or modmail button, depending on how your server takes support requests). To let `/ask` also answer general questions from Odin's own knowledge, turn on **Allow general knowledge** in [**AI > Q\&A Bot**](https://bot.bifrost.gg/go/ai/feature-qa_bot). Facts about your server (links, rates, commands, staff) still only come from the knowledge base. By default, `/ask` is available to all members. Access can be restricted in the permissions configuration. ## Knowledge base The knowledge base is the set of documents Odin uses to answer questions. Navigate to [**AI > Knowledgebase**](https://bot.bifrost.gg/go/ai/knowledgebase) in the dashboard to manage it. ### Adding documents Click **Add Document** and paste in the content or upload a file. Each document should cover a specific topic - server rules, a FAQ, integration guides, or any structured content you want Odin to reference. Supported formats: * Plain text * Markdown * PDF * Common document formats Once uploaded, the document is processed and indexed. Odin begins referencing it in answers within a few minutes. ### Importing from the web Instead of pasting content, you can bring pages in straight from a website: * **Import URLs** fetches the pages you list, one per line, and tidies each into its own entry. * **Deep Crawl** follows the links on a site, up to the page limit you set, and imports every page with real content. Both use AI tokens to tidy up each page. A site that publishes markdown versions of its pages (most documentation platforms do) is stored as written and costs nothing to tidy. Importing a page that is already in the knowledge base does not create a second copy. Pages are matched by address: an unchanged page is skipped without using any tokens, and a changed page updates its existing entry, keeping the title and tags you gave it. **Preview Pages** shows how many pages are new, changed and unchanged before you commit, so re-crawling a site you already imported only costs tokens for what changed. ### Keeping entries up to date Odin re-checks every imported page once a week. If the page has not changed, nothing happens and no tokens are used. If it has, the entry is updated from the page, using this server's AI tokens for the pages that need tidying. If the AI cannot tidy the new version, for example because the server is out of AI tokens, the entry is left exactly as it was and tried again later, rather than replaced with untidied page text. The [**AI > Usage**](https://bot.bifrost.gg/go/ai/usage) page lists this separately as **Knowledgebase Upkeep**. Turn it off with **Keep imported pages up to date** at the bottom of the [**AI > Knowledgebase**](https://bot.bifrost.gg/go/ai/knowledgebase) page. * **Your edits are kept.** Once you edit an entry's content by hand, Odin never copies the page over it. If the page changes afterwards, the entry is marked **Page changed since your edit**, and you choose **Replace with new version** or **Keep my version**. * **Removed pages are flagged, never deleted.** An entry whose page returns "not found" is marked **Page missing**. After two weekly checks in a row it is left out of answers, so Odin stops quoting a page the site took down. It comes back on its own if the page returns. To keep using it anyway, edit the entry and clear its source URL. * **Watch a site for new pages.** Every deep-crawled site is listed under **Crawled sites**. Turn on its watch toggle and Odin crawls it weekly and imports up to 25 pages that are not in the knowledge base yet. Finding pages costs no tokens; tidying up each new one does. A page the AI finds nothing worth keeping on, such as a login page, is remembered and not looked at again until its content changes. * **Pages that change on every visit are checked less often.** Some pages change every time they are loaded, for example because they show the current time. After three weekly checks in a row that found a change, the gap between checks doubles each time, up to every eight weeks, so such a page does not cost tokens every week. Use the **Needs attention** filter to see every entry with a missing page, a page that changed since your edit, or the same page imported twice. > [!NOTE] > > An entry the AI built out of several pages at once is marked **Not updated automatically**, because re-reading one of its pages would replace it with a fraction of itself. Re-crawl the site to update it. ### Managing documents The [**AI > Knowledgebase**](https://bot.bifrost.gg/go/ai/knowledgebase) page lists all documents with their creation date and status. You can: * **Edit** a document's content if information changes * **Delete** a document to stop Odin referencing it * **Preview** how Odin interprets and summarises the document ## Conversation context Odin maintains context within a conversation session. When a member asks a follow-up question, Odin uses the previous exchanges in the same session to understand the reference. Context is scoped to the individual member and expires after a period of inactivity. Staff can read past conversations in [**AI > Conversations**](https://bot.bifrost.gg/go/ai/conversations), which is useful for debugging an unexpected response. ## Configuration Navigate to [**AI > Setup & Context**](https://bot.bifrost.gg/go/ai/setup) in the dashboard to set: | Setting | Description | | - | - | | **Identity** | Odin's name, personality, brand voice and primary language | | **Server context** | A description of your server and its niche, so answers fit your community | | **Channel context** | What each channel is for, so Odin can point members to the right place | | **Rules and guidelines** | Your server rules, do's and don'ts, forbidden topics and required disclosures | | **Branding** | The colour, logo and footer text on Odin's replies | To limit which channels `/ask` works in, or set its cooldowns, use [**AI > Q\&A Bot**](https://bot.bifrost.gg/go/ai/feature-qa_bot). ## Features Navigate to [**AI > Features**](https://bot.bifrost.gg/go/ai/features) to see and enable the individual AI capabilities available on your server. Each feature is a distinct behaviour that Odin can perform. ### Text Moderation Odin can evaluate every message in configured channels and flag or remove content that violates your rules. Unlike regex-based automod, text moderation understands context - it can distinguish between discussing a topic and actually violating a rule about it. Configure which channels are monitored, what the AI looks for, and what action to take (flag for review, delete, or warn) in [**AI > Text Moderation**](https://bot.bifrost.gg/go/ai/feature-text_moderation). #### Recommended settings Text moderation starts from a set of recommended settings that we maintain and improve over time. Every setting you leave alone follows the recommendation, so when we publish a better version your server picks it up automatically. A setting you change becomes yours and is marked **Custom**. It keeps your value when the recommendations change. Press **Use recommended** next to it to go back to following the recommendation. When a new version changes a setting you have customised, the **New recommendations** card lists it. For each one you can **Use recommended** or **Keep mine**. Heimdall also posts a one-time notice in your escalation channel so the change does not go unnoticed. #### Feedback and improving the recommendations Every AI escalation in your log channel has 👍 and 👎 buttons, plus a comment button. Use them to tell Odin when a decision was right or wrong. That feedback is how the recommended settings get better. To improve the recommendations for every server, feedback is collected centrally together with the decision it is about. Before anything leaves your server, mentions, user IDs and the author's names are removed from the message, and the author is identified only by a one-way code that cannot be turned back into a Discord ID. Messages that raise a wellbeing or self-harm concern are never sent. Feedback is kept for up to 24 months. > [!NOTE] > > Servers using their own OpenRouter key can opt out under **Improving recommended settings** on the [**AI > Text Moderation**](https://bot.bifrost.gg/go/ai/feature-text_moderation) page. Opting out also deletes the feedback your server has already sent. Servers on Heimdall's managed AI cannot opt out, because the recommendations they rely on are built from this feedback. ### Image Moderation When enabled, Odin analyses images attached to messages in monitored channels. Configure sensitivity thresholds and the action to take when a rule violation is detected in [**AI > Image Moderation**](https://bot.bifrost.gg/go/ai/feature-image_moderation). ### Ticket Auto-Reply When a ticket is opened, Odin reads the opening message against your knowledge base and posts a suggested answer in the thread for staff to review before sending. This reduces the number of tickets staff need to respond to manually and cuts response times for common questions. Enable and configure this in [**AI > Ticket Auto-Reply**](https://bot.bifrost.gg/go/ai/feature-ticket_auto_reply) or in the [**Tickets > AI**](https://bot.bifrost.gg/go/tickets/ai) section. ### Modmail Assistant The same capability as ticket auto-reply, applied to incoming modmail conversations. When a member opens a modmail thread, Odin suggests a reply based on the opening DM and your knowledge base. Enable and configure this in [**AI > Modmail Assistant**](https://bot.bifrost.gg/go/ai/feature-modmail_assistant) or in the [**Modmail > AI**](https://bot.bifrost.gg/go/modmail/ai) section. ### Q\&A Bot The Q\&A Bot monitors configured channels and responds to questions automatically without requiring members to use the `/ask` command. When a message looks like a question, Odin evaluates it against your knowledge base and replies if it finds a confident answer. This is distinct from auto-responses - the Q\&A Bot uses full AI reasoning rather than pattern matching, and only replies when sufficiently confident. Configure the channels it monitors and the confidence threshold in [**AI > Q\&A Bot**](https://bot.bifrost.gg/go/ai/feature-qa_bot). ### Conversation Modes Conversation modes let you configure how Odin behaves in specific channels - for example, setting up a channel where Odin maintains ongoing conversation context and acts as a persistent assistant. Configure available modes and the channels they apply to in [**AI > Conversation Modes**](https://bot.bifrost.gg/go/ai/feature-conversation_modes). Each mode has two settings that decide how it answers: * **Allow general knowledge** (on by default). Odin answers general questions, such as the game or topic your community is about, from its own knowledge, and uses your knowledge base for anything about your server. It says when it is unsure, and points out where your server may differ from the general case. Facts about your server itself, such as links, rates, commands and staff, still only come from the knowledge base. Turn this off to make the mode answer only from the knowledge base, like `/ask` does by default. * **Handoff action**. What happens when a member asks for a human or needs something only staff can do. Ordinary questions are always answered, never handed off. * **No hand-off** (default): Odin says it cannot help and stops there. * **Open a ticket**: Odin shows your server's ticket button, or modmail's if you use modmail instead. * **Ping a staff role**: Odin mentions the role you choose. Each member can ping it at most once every 10 minutes, and the role is pinged at most once a minute; later hand-offs name the role without notifying it. The role must be mentionable, or Heimdall needs the **Mention @everyone, @here, and All Roles** permission. Otherwise the mode behaves as **No hand-off**. Odin replies in the language the member writes in. The fixed hand-off line and button labels follow the **Primary Language** set on [**AI > Setup & Context**](https://bot.bifrost.gg/go/ai/setup). ## Moderation Logs [**AI > Moderation Logs**](https://bot.bifrost.gg/go/ai/moderation-logs) shows a log of AI moderation actions - text and image moderation events, what was flagged, and what action was taken. Use this to review the AI's decisions and tune your configuration if it is being too aggressive or too permissive. ## Conversations [**AI > Conversations**](https://bot.bifrost.gg/go/ai/conversations) is a log of members' conversations with Odin. Staff can open a conversation to read it, flag it or mark it reviewed, add a good answer to the knowledge base, or restrict the member from AI features. ## Restrictions [**AI > Restrictions**](https://bot.bifrost.gg/go/ai/restrictions) lists members who are banned or timed out from using AI features, and lets staff add or lift those restrictions. Limiting `/ask` to specific channels, and its cooldowns, is on [**AI > Q\&A Bot**](https://bot.bifrost.gg/go/ai/feature-qa_bot) instead. Without a channel limit, `/ask` is available in every channel. ## Usage and billing [**AI > Usage**](https://bot.bifrost.gg/go/ai/usage) shows your server's AI token consumption over time - broken down by feature (Q\&A, moderation, ticket auto-reply, etc.) and by day. This is useful for understanding which features are consuming the most tokens. [**AI > Billing**](https://bot.bifrost.gg/go/ai/billing) shows your current AI credit balance and allows purchasing additional credits. AI features consume credits per token processed; the exact cost depends on which underlying model is configured for your deployment. > [!NOTE] > > Usage and Billing are only visible if your Heimdall deployment uses token-based AI credits. Self-hosted deployments using a local model or their own API key will not see these sections. ## AI in other plugins Odin integrates with tickets, modmail, and suggestions: * [**Tickets > AI**](https://bot.bifrost.gg/go/tickets/ai) - enable ticket auto-reply for specific ticket categories * [**Modmail > AI**](https://bot.bifrost.gg/go/modmail/ai) - enable the modmail assistant for specific modmail categories * **Suggestions** - Odin automatically generates a concise title when a member submits a suggestion, if **AI Titles** is on for the suggestion's category in [**Suggestions > Categories**](https://bot.bifrost.gg/go/suggestions/categories). A suggestion with no category never gets one. On Heimdall's managed AI, **Suggestion Titles** must also be on in [**AI > Features**](https://bot.bifrost.gg/go/ai/features) ## Required permissions | Action | Permission key | | - | - | | Using `/ask` | `ai.qa.use_ask` (default allow) | | Viewing conversation context | `ai.context.view_context` | | Managing conversation context | `ai.context.manage_context` | | Viewing configuration | `ai.config.view_config` | | Managing configuration | `ai.config.manage_config` | | Viewing the knowledge base | `ai.knowledgebase.view_knowledgebase` | | Managing the knowledge base | `ai.knowledgebase.manage_knowledgebase` | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.