> 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/tellius-6.3/settings/advanced/kaiya-prompts.md).

# Kaiya - Prompts

This page is for admins who want to see or edit the actual system prompts Kaiya uses.

<figure><img src="https://content.gitbook.com/content/M1pa9Nct9EmVU4Ol8Mol/blobs/o25Cni88dKOe18BAJyOj/image.png" alt="" width="563"><figcaption></figcaption></figure>

You can pick a prompt set from a dropdown, such as **“Agentic Insights – Planner”** or **“Text to SQL – Clarification Checker (Medium)”**. The large text area shows the full instruction that is sent to the LLM, which you can edit and save.

<figure><img src="https://content.gitbook.com/content/M1pa9Nct9EmVU4Ol8Mol/blobs/vukl60SHjSq2YPInhV6c/image.png" alt="" width="375"><figcaption></figcaption></figure>

Use this page when you want to standardize the way Kaiya answers across the company, when you want to enforce fiscal time, or when you are switching models and need slightly different phrasing. Avoid deleting the shipped prompts. Edit or duplicate them instead so you can roll back if needed.

#### What it does

1. **Agentic Insights – Planner**
   * This controls how Kaiya creates the step-by-step plan for Deep Insights.
   * It tells the model: “You are the planning orchestrator. Output only JSON with steps \[…]. Users expect deep-dive analysis, not a shallow answer.”
   * If you change this, you change how Kaiya *plans* the steps: SQL → Python → viz → summary → reflection.
   * Use this to add org-specific requirements: “always list assumptions”, “always create a driver table”, “always check sample size”.
2. **Text-to-SQL – Query Planner / Clarification Checker**
   * These prompts control how Kaiya turns natural language into SQL and *when* it decides to ask the user for a missing detail.
   * This is where the **Clarification Mode** dropdown in ***Settings → Kaiya*** maps to: **Low/Medium/High** correspond to different clarification prompts.
3. **Model-specific packs**
   * If your deployment uses a different LLM family, you can keep separate prompt versions and then select them via **Prompt Variation** in the main settings.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.tellius.com/tellius-6.3/settings/advanced/kaiya-prompts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.