Skip to main content
The Knowledge Base Search tool (roat_retrieval) is a mAItion Workspace Tool. It lets the LLM decide, on its own, when to call the knowledge base to answer a question. Use it for questions about internal documents, company processes, or organization-specific topics. Skip it for general knowledge questions (math, programming syntax, public facts) that don’t need internal data. The knowledge base is powered by ROAT (rag-of-all-trades), mAItion’s RAG backend.

Valves

Valves can be edited after install from Workspace → Tools in mAItion.

Configuration via ENV

Knowledge Base Search is always installed — there is no opt-in flag. The ENV variables below only affect what it connects to, and only apply during first-start initialization (the setup that runs only once, the first time the container boots, gated on a marker file). On an already-running instance, configure the resulting valves manually from the admin UI instead.
Example .env:
If you configure rag_service_url manually later (for example after changing ROAT_API_URL post-install), remember to include the /api/v1/query path — the bare host URL alone will not work.

Troubleshooting