> For the complete documentation index, see [llms.txt](https://help.tellius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tellius.com/settings/kaiya-and-ai/kaiya-configuration.md). # Kaiya Configuration Under **Settings → Intelligence → Kaiya & AI → Kaiya Configuration**, this page is the master control panel for Kaiya across your workspace. It decides whether Kaiya runs, which capabilities are switched on, how Kaiya behaves when a question is ambiguous, how much data a single query can return, and whether Kaiya's activity is traced to LangSmith. Settings here apply workspace-wide, not per user. The page is a single form split into six sections. Changes anywhere on the page activate **Save** at the top right; **Cancel** discards everything and restores the saved state.
### General **Enable Kaiya:** The master switch. Turning it on activates Kaiya, Tellius's AI-powered assistant. Enabling it also constitutes acceptance of Tellius's terms and conditions, so read those before switching it on. **Position of Kaiya Summaries in Search:** Where Kaiya's generated summary sits relative to the chart in the Search module. Three choices: **No Summary** (suppress it), **Above The Chart**, or **Below The Chart**. **Deep Insights layout:** The order of content in a Deep Insights result. Step details, when present, always come first; this setting decides what follows. Three choices: **Summary before charts**, **Charts before summary**, or **No charts**. **Kaiya Charts - New declarative renderer:** When enabled, Kaiya renders charts through the declarative Highcharts path, using a chart configuration plus precomputed table data. When disabled, charts fall back to the legacy Vizpad-style renderer. Leave this on unless you're troubleshooting a rendering difference against older behavior. ### Conversation & Capabilities **Kaiya Conversational AI:** Turns data analytics into a conversational experience. Enabling it adds the Kaiya tab above **Explore** in the left pane, where users type questions directly. **Hide Kaiya from UI Only:** Keeps the Kaiya module running while removing it from the interface. Useful when Kaiya needs to stay available to other services or embedded surfaces but shouldn't be visible to users in the main platform. **Enable Kaiya Auto Business View Assistant:** Lets Kaiya auto-select which Business View a question relates to. With this on, users start typing a question in Kaiya Conversational AI without first choosing a Business View manually. **Enable Kaiya Agentic:** Unlocks agentic workflows (and scheduled automated recurring analysis) where you can build, customize, and trigger multi-agent workflows that run inside the conversational AI. Steps are defined in natural language and can be set to fire on smart triggers. **Enable KaiyaClaw:** Kaiya's agentic assistant for Slack. Once enabled, the team can chat with Kaiya inside Slack to ask questions, run deep insights, build and run workflows, and schedule recurring analysis. ### Voice Assistant **Enable Voice Assistant:** Switches on voice input and voice output for Kaiya. Turning it on reveals three fields. **Voice Assistant Type:** The speech provider that handles voice for Kaiya. Three options: **DeepGram**, **OpenAI**, and **ElevenLabs**. **API Key:** The key issued by whichever provider you selected. Masked once saved. **Provider Configuration:** Config parameters for the selected provider or model, written as JSON. Leave it as `{}` when no overrides are needed. The last two fields follow your provider choice. * Selecting DeepGram labels the field **Deepgram Configuration** and asks for a Deepgram API key. * Selecting OpenAI labels it **OpenAI Configuration** and asks for an OpenAI key. ### Compliance **Enable Kaiya Conversation Terms and Conditions:** Displays terms and conditions inside Kaiya Conversational AI. Turn this on where your organization needs users to see custom usage terms before interacting with the assistant. * **Enter the Terms Heading:** The title users see. Defaults to *Terms and Conditions*. * **Enter the URL of the terms and conditions:** The link that heading points to. Use your organization's custom hosted terms page. ### Answers & Retrieval **SQL Row Limit:** The maximum number of rows any single SQL query returns. Higher values let more data through but can slow responses. The accepted range is 100 to 500,000, and values are auto-adjusted to stay in range. Use the stepper arrows or type a number directly.
**Clarification Mode:** Controls how often Kaiya stops to ask the user a clarifying follow-up question. The options are: | Mode | Behavior | | -------- | --------------------------------------------------------------------------------------------------------------------------------- | | **None** | Never asks. Kaiya proceeds using whatever context it has. | | **Low** | Asks only when the query cannot run at all without more input. For example, when no measure has been specified. | | **High** | Resolves every ambiguity before answering. Asks about any low-confidence or defaulted choice, even when the query could have run. | Lower settings favor speed and fewer interruptions; higher settings favor precision at the cost of extra back-and-forth. **Enable Kaiya Unstructured:** Adds support for unstructured data sources. **Implicit Semantic Cache for Analytics:** When enabled, Text2SQL outputs are cached automatically, so similar later questions resolve faster. When off, a result is only cached if a user gives it a thumbs-up. **Enable Kaiya Web Search:** Allows Kaiya to run real-time web searches for questions that need external or current information. Turning it on displays a field labeled **Enter the Exa API key required for performing web search**. Tellius uses Exa as its web search provider, so this key is required for the feature to work. **Enable Help/Unknown Questions Handling:** Governs what Kaiya does with off-topic, help-related, or unanswerable questions — weather, requests to convert a chart, or a bare "Hi." With this on, Kaiya responds gracefully and offers guidance instead of failing, keeping the conversation on track. ### LangSmith **Enable Kaiya LangSmith Integration:** Switches on telemetry, tracing, and evaluation through LangSmith. This is a diagnostic and quality-monitoring integration, useful when you need visibility into how Kaiya arrived at an answer.
Turning the toggle on reveals three required fields; turning it off hides them again. * **Endpoint:** The API endpoint used to reach LangSmith. * **API Name:** The LangSmith project name where traces and telemetry are stored. * **Project Key:** The API key that authenticates Kaiya with LangSmith. The value is masked once saved. ### Saving Click **Save** to apply changes across the workspace, or **Cancel** to discard them. Save stays inactive until something on the page changes. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.tellius.com/settings/kaiya-and-ai/kaiya-configuration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.