# Voice Agent

This feature enables users to interact with the AI Agent via voice input. Users can speak directly using their microphone, and the agent transcribes the speech into text to generate responses. Replies can optionally be delivered in spoken form.

* Browser-based microphone support for voice input
* Real-time speech-to-text transcription for a natural dialogue experience
* Agent responses can be both displayed as text and played back as audio
* Full history of both text and voice interactions is retained

You can personalize your Voice Agent to better interact with your users. Adjust the following settings:

* **Startup mode** — Decide whether the chatbot initially communicates via **text**, **voice**, or **voice-only** mode.
* **Agent color** — Choose the color or visual theme of the voice interface.
* **Voice Tone** — Set the voice tone to be friendly, professional, or any style suitable for your audience.
* **Language** — Select the language the Voice Agent will speak in.
* **Voice Agent Status** — Update the status messages to match your users’ language.

<figure><img src="/files/Q114Aon8coOlsjxoNC0A" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Voice Agent and Code Interpreter cannot be used at the same time. Please disable Code Interpreter to use the Voice Agent.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.aicado.ai/creating-ai-agent/features/voice-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
