> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruby.ad/llms.txt
> Use this file to discover all available pages before exploring further.

# Ruby Live

> Talk with your agents in real time, switch agents by voice, and respond to tool requests.

Ruby Live lets you have real-time voice conversations with your agents, powered by ElevenLabs. Speak your request and listen to the agent's reply. Your messages and the agent's answers also appear in the conversation so you can read them later.

## Start a session

1. Open a conversation, or start a new one.
2. Click **Talk live**, the headphones button beside the conversation input.
3. Allow microphone access if your browser asks.
4. Wait for **Listening**, then say what you want the agent to do.

The live bar shows whether Ruby is listening, working, speaking, or waiting for your approval or answer. It also shows captions as you speak and listen.

> [!NOTE]
>
> If **Talk live** is missing or Ruby says voice conversations aren't enabled, ask your workspace admin about availability. If your microphone is blocked, allow microphone access in your browser and try again.

## Mute and unmute

Click **Mute microphone** in the live bar to stop sending microphone audio. The bar shows **Microphone muted**. Click **Unmute microphone** when you're ready to speak again.

Muting keeps the session open. To finish the session, use **End**.

## Switch agents by voice

Say the name of the agent you want to talk to. For example, say **“Switch to Research”**, using the name of an agent available to you. Ruby confirms the switch, and your next request goes to that agent.

You can also name the agent in a request, such as **“Research, summarize the latest project notes.”** If Ruby can't find that agent, check its name in **Agents** and try again.

## Approve tool use by voice

When an agent needs permission to use a tool, Ruby tells you which agent and tool are waiting. Listen to the request, then say **“Approve it”** or **“Reject it.”** A spoken approval applies to that pending action.

Some actions require approval on screen. Ruby tells you when this is needed; review the request in the conversation and use its approval controls. Connecting an account also requires the button on screen.

You can answer an agent's follow-up question aloud when Ruby asks it.

## End a session

Click **End** in the live bar, or ask Ruby to end the session by voice, for example **“End this session.”** Your conversation remains available to read or continue by typing.

If you navigate to another page while a session is running, **Back to Ruby Live** takes you back to its conversation. You can also end the session from that floating control.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.