> 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/kaiya/kaiya-voice-mode.md).

# Kaiya Voice Mode

Talk with Kaiya out loud in Kaiya chat. Ask questions by voice, hear a short spoken summary, and find the full written answer saved in the conversation.

{% hint style="info" %}
**Using DeepGram or ElevenLabs?** Since Tellius 6.4, voice mode in Kaiya chat needs the **OpenAI** voice provider. The earlier voice window, which **DeepGram** and **ElevenLabs** used, was retired in Tellius 6.4. See [Voice window before Tellius 6.4](https://help.tellius.com/kaiya/kaiya-voice-mode/voice-window-before-tellius-6-4).
{% endhint %}

In Tellius 7.0, voice mode lets you have a spoken conversation with Kaiya. You ask out loud, and Kaiya answers out loud with a short summary of the key facts and numbers. At the same time, Kaiya writes the full answer into the conversation, with its charts, citations and **How Kaiya got this**. When you leave voice mode, everything you said and every answer is there to read.

{% hint style="info" %}
**Voice mode or Dictate?** Both use your microphone, but they work differently.

* **Dictate** (the microphone icon) turns what you say into text in the message box. It keeps listening through short pauses, so you can stop to think mid-sentence. Nothing is sent until you select **Send**, so you can check and edit the words first. Kaiya answers in writing only. Use it when you want a written question but don't want to type, or when the wording must be exact.
* **Use voice mode** (the round icon with sound waves) starts a back-and-forth conversation. Kaiya listens, answers out loud and keeps listening for your next request. Use it when you want to work hands-free, for example while you look at a dashboard or step away from the keyboard.
  {% endhint %}

### In this section

* [Voice window before Tellius 6.4](https://help.tellius.com/kaiya/kaiya-voice-mode/voice-window-before-tellius-6-4): the earlier voice window, used with **DeepGram** or **ElevenLabs** in releases before Tellius 6.4. It was retired in Tellius 6.4.

### Before you start

* **Voice must be turned on.** In Kaiya chat, the **Use voice mode** button appears in the message box only when an administrator has turned on the voice assistant with OpenAI as the provider. See [Turn on voice (administrators)](#turn-on-voice-administrators) below.
* **Pick your data first.** Kaiya answers voice questions from the Business View selected in the message box, in the same way as typed questions. Choose the Business View before you start, or leave **Auto detect BV** so Kaiya picks one. Kaiya can also answer from documents.
* **Allow the microphone.** If your browser asks whether Tellius can use your microphone, allow it. Voice mode can't hear you without it.

### Start voice mode

1. In the message box, on the home page or in a conversation, select **Use voice mode**. It sits beside **Dictate**, to the left of **Send**.

   <figure><img src="https://content.gitbook.com/content/bUaRGOhtNPAFbdFWcv5G/blobs/SREkJMHfpd4mVWelsZVx/vm-message-box-voice.png" alt="The Kaiya message box with the Dictate and Use voice mode buttons highlighted" width="563"><figcaption></figcaption></figure>
2. Voice mode opens over the chat, and the chat behind it is blurred. The status under the Kaiya logo reads **Connecting...** and then **Listening...** once voice mode is ready.
3. Kaiya greets you out loud. Ask your question in your own words.

If you start voice mode from a new chat, your first request creates a new conversation. It is saved in your conversation list like any other.

On the home page, you can select **App** or **Mission** below the message box before you start voice mode. Your first spoken request then builds an App or a Mission. Voice mode isn't available while **Deep Insight** is selected.

### While you talk with Kaiya

* **The transcript.** A panel under the status shows the conversation as you go. Your words appear on the right, under **You**, and Kaiya's reply appears on the left, under **Kaiya**, as it is spoken, the same way round as in the chat. Older turns scroll up inside the panel.
* **Progress on longer work.** When longer work starts, such as an App build, a Mission or an export, Kaiya asks once how you want to hear about it:

  * **Each step:** an update as each step finishes.
  * **Every so often:** an update at the interval you name, from 10 seconds to 10 minutes, and only when something new has happened.
  * **When it's done:** only the result.

  Say which you want, for example *"Update me every 30 seconds"* or *"Just tell me when it's done"*. You can change your choice at any time by saying so. Updates name real milestones only, and Kaiya never talks over you, or over audio that is still playing.
* **Several requests at once.** You can ask for up to three things in one go, for example *"Build an App on weekly sales, then export it as a PDF and email me a summary"*. Each request becomes its own turn in the conversation, and Kaiya works through them in the order you asked. A request you add while longer work is running waits its turn, and Kaiya tells you so. If you ask for a fourth, or repeat a request already in hand, Kaiya says it can't take it on yet.
* **The spoken answer.** Kaiya speaks a short summary that leads with the key numbers, and it only says numbers that come from a result or from the conversation. If a step failed or didn't finish, for example in a Mission run, Kaiya says so first, then gives the findings. It often ends by offering to go deeper, for example into one region or one product.
* **Approvals.** When something needs your approval, such as publishing a Mission or a change in a connected system, Kaiya tells you what to confirm on screen.
* **Follow-up questions.** Answer the offer, or ask your next question. Kaiya keeps the context of the whole conversation, so you can say "Now break that down by region" without repeating the first question. The context carries over when you switch from typing to voice partway through a conversation, when you mute the microphone or start voice mode again, and when the connection drops and comes back.
* **If the connection drops.** Kaiya tells you once the connection is back, and speaks any answer that arrived while it was down.
* **The status.** It keeps reading **Listening...** for the whole session, including while Kaiya speaks and while your microphone is muted.

{% hint style="success" %}
**Get better spoken answers.** Name the measure and the period, for example "What were total sales last quarter by region?". The spoken answer is a summary. For a table, a chart or the exact figures, read the full written answer after you leave voice mode. While an App or a Mission is being built, choose **When it's done** if you want a quiet session, or **Each step** if you want to follow along.
{% endhint %}

### Voice mode controls

* **Microphone.** Select it to mute your microphone. Its tooltip reads **Mute** while Kaiya can hear you. When muted, the button turns red with a line through the microphone, and its tooltip reads **Unmute**. Muting doesn't stop Kaiya. It still answers the question you already asked. Unmute when you want to ask the next one.
* **X (Exit Voice Mode).** Closes voice mode and takes you back to the conversation.

{% hint style="info" %}
**When to mute.** If you are in a noisy room or talking to someone else, mute after you finish your question. The microphone then can't pick up other speech while Kaiya works on your answer.
{% endhint %}

### After you leave voice mode

When you select **Exit Voice Mode**, voice mode closes and you are back in the same conversation. Every voice question and answer is saved there as ordinary messages:

* your questions, as you said them
* Kaiya's full written answers, with charts, tables and citations, which are longer and more detailed than what Kaiya said out loud
* **How Kaiya got this** on each answer, and the **Based on** line that names the Business View

You can carry on by typing, select a follow-up question, share the conversation, or start voice mode again. An answer from a voice session you have closed is not spoken in your next one. See [Kaiya responses](https://help.tellius.com/kaiya/kaiya-conversational-ai/kaiya-responses).

### What you can do by voice

In Kaiya chat, voice mode can do the same work as typing:

* **Ask questions** about your Business Views and documents.
* **Build and change an App.** See [Kaiya Apps](https://help.tellius.com/kaiya/kaiya-apps).
* **Create, publish and run a Mission.** See [Kaiya Missions](https://help.tellius.com/kaiya/kaiya-missions).
* **Export** an analysis as a file, such as a PDF report or a PowerPoint deck. See [Exporting Kaiya conversations](https://help.tellius.com/kaiya/kaiya-conversational-ai/exporting-kaiya-conversations).

Voice mode in Kaiya chat works only with the OpenAI voice provider.

{% hint style="success" %}
**Ask by voice, check on screen.** You can ask for an App or a Mission out loud, but its plan, steps and preview are on screen. Look them over in the conversation, or after you leave voice mode, before you publish.
{% endhint %}

### Turn on voice (administrators)

Voice is set up under **Settings → Intelligence → Kaiya & AI → Kaiya Configuration**, in the **Voice Assistant** section.

1. Turn on **Enable Voice Assistant**. The provider fields appear below it.
2. Under **Voice Assistant Type**, choose **OpenAI**. The list also offers **DeepGram** and **ElevenLabs**, but voice mode in Kaiya chat appears only when **OpenAI** is selected.

   <figure><img src="https://content.gitbook.com/content/bUaRGOhtNPAFbdFWcv5G/blobs/75jnAKUJDg6zMRER6kn8/vm-settings-voice-assistant.png" alt="The Voice Assistant section of Kaiya Configuration with Voice Assistant Type highlighted" width="563"><figcaption></figcaption></figure>
3. Enter an OpenAI **API Key** that has access to OpenAI's Realtime API. Voice mode uses it to listen and speak.
4. Select **Save**. To leave without changing anything, select **Cancel**.

Once voice is on, users see **Use voice mode** in the message box, on the home page and in conversations. See [Kaiya Configuration](https://help.tellius.com/settings/kaiya-and-ai/kaiya-configuration).

{% hint style="warning" %}
**Don't see Use voice mode?** Check all three: **Enable Voice Assistant** is on, **Voice Assistant Type** is **OpenAI**, and the API key has Realtime access. If any one is missing, the button doesn't appear.
{% endhint %}


---

# 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/kaiya/kaiya-voice-mode.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.
