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

# Agents

> How to create, configure, and manage Agents in OpenHome.

At the heart of the OpenHome ecosystem are **Agents**—customizable AI voice characters designed for specific tasks and applications. Each Agent is characterized by several key attributes, including:

* **Description and Purpose**: Defines the Agent’s role and how it behaves within the chosen LLM.

* **Voice**: You can tailor the voice to best represent the Agent, aligning with your preferences or project needs.

* **Dynamic Feedback**: Agents evolve based on user interactions, learning from conversations to provide more personalized responses over time. OpenHome's **DynamicAgentConstructor** enables Agents to evolve with every conversation. They adapt to your conversation history, preferences, and personal style, creating an ever-improving interaction experience. This ensures that the conversation isn’t just accurate but also deeply personalized, making every interaction feel more intuitive.

### How Agents Work

The core architecture revolves around three key modules: **STT Transcription** (Speech-to-Text), **TTT Processing** (Text-to-Text), and **Voice TTS** (Text-to-Speech). These modules work together to create rich, adaptive experiences powered by customizable "Agents".

#### Workflow

1. **Speech Input:** The system listens for voice commands, initiated by a cold start message.
2. **STT Transcription:** The Speech-to-Text (STT) module converts speech into text.
3. **LLM Processing:** The transcribed text is processed by the designated LLM (the “brains” of the assistant, the large language model), which generates a relevant response based on the user's input and conversation history. OpenHome supports over 20 different LLMs.
4. **TTS Synthesis:** Once a response is generated, it’s converted back into speech using customizable voices, creating a natural, interactive experience. This module brings the conversation to life with fluent, human-like speech.

## How to Create & Manage Agents

The **Agents dashboard** allows you to view, manage, and create custom AI Agents. You can also customize the interaction experience by adding new voices.

<img src="https://mintcdn.com/algoryc/DHf_m0ZL8j38qpe6/openhome_icons/dashboard_icons/my-personalities.png?fit=max&auto=format&n=DHf_m0ZL8j38qpe6&q=85&s=ee9581aa986b6a59682a4076e7a41949" alt="agents_page" width="1866" height="949" data-path="openhome_icons/dashboard_icons/my-personalities.png" />

### Creating New Agent

To get started, visit the Agents dashboard and select the <img src="https://mintcdn.com/algoryc/GGeODhG37dHsQeAa/openhome_icons/dashboard_icons/create-personality.png?fit=max&auto=format&n=GGeODhG37dHsQeAa&q=85&s=088a2a6ec059281d0600ff69c0edabc8" alt="Create Button" width="100" height="30" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_icons/create-personality.png" /> button at the top-right.

By default, **Create Personality** opens in **Quick Creation** mode.

* In **Quick Creation**, fill in:
  * **Avatar** (upload or **Generate with AI**)
  * **Name**
  * **Starting Message**
  * **Description**
  * **Personality Category**
  * **Voice Identity** (you can use **Clone voice** and preview)
* Click `Save Personality` to create the new personality.

<p align="center">
  <img src="https://mintcdn.com/algoryc/mGXEA0vBOuyBqfMn/openhome_icons/dashboard_icons/agent_quick_creation.png?fit=max&auto=format&n=mGXEA0vBOuyBqfMn&q=85&s=833b477cf6daa349dace9f9304ed83bb" alt="agent_quick_creation" width="807" height="855" data-path="openhome_icons/dashboard_icons/agent_quick_creation.png" />
</p>

* Need advanced options? Click **Switch to PRO Mode** and follow the full Pro flow in [Quickstart: Create New Agent](/quickstart#create-new-agent).

### Managing Agents

The **Agents page** allows you to view, manage, and organize all the Agents you have created or installed from the Marketplace. Each Agent is displayed as a card, showing key details such as its description, last updated timestamp, and options for further customization or interaction.

<p align="center">
  <img src="https://mintcdn.com/algoryc/GGeODhG37dHsQeAa/openhome_icons/dashboard_icons/manage-personality.png?fit=max&auto=format&n=GGeODhG37dHsQeAa&q=85&s=47de25c5a146b91206a6f1effb4bdf6c" alt="alan_watts" width="471" height="231" data-path="openhome_icons/dashboard_icons/manage-personality.png" />
</p>

* **Search**: Use the search bar at the top to quickly find a specific Agent by name.

<p align="center">
  <img src="https://mintcdn.com/algoryc/nIjKmDT8_yYOKqOt/openhome_icons/dashboard_icons/search_bar.png?fit=max&auto=format&n=nIjKmDT8_yYOKqOt&q=85&s=30c37cb6ebdd21614402b42cf9662b8f" alt="search_bar" width="324" height="37" data-path="openhome_icons/dashboard_icons/search_bar.png" />
</p>

* **Status Filter**: The dropdown menu in the top right allows you to filter Agents by status, including Published, Unpublished, Default, and Installed.

<p align="center">
  <img src="https://mintcdn.com/algoryc/nIjKmDT8_yYOKqOt/openhome_icons/dashboard_icons/personality-filter-dropdown.png?fit=max&auto=format&n=nIjKmDT8_yYOKqOt&q=85&s=44949759980b992e590a938add5ad0fb" alt="listings" width="135" height="188" data-path="openhome_icons/dashboard_icons/personality-filter-dropdown.png" />
</p>

* <img src="https://mintcdn.com/algoryc/nIjKmDT8_yYOKqOt/openhome_icons/dashboard_icons/start-button.png?fit=max&auto=format&n=nIjKmDT8_yYOKqOt&q=85&s=a8169bbea3373105235e30b1680790f4" alt="play_icon" width="40" height="30" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_icons/start-button.png" /> **Start Conversation**: Open a conversation with the selected Agent.
* <img src="https://mintcdn.com/algoryc/DLQlUOpaWgaRxWsd/openhome_icons/dashboard_icons/share_button.png?fit=max&auto=format&n=DLQlUOpaWgaRxWsd&q=85&s=d8827e5ff164b537a5b195e778a227b2" alt="share_icon" width="60" height="30" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_icons/share_button.png" /> **Share**: Share this Agent with someone, allowing them to interact with it.
* <img src="https://mintcdn.com/algoryc/GGeODhG37dHsQeAa/openhome_icons/dashboard_icons/edit-personality-button.png?fit=max&auto=format&n=GGeODhG37dHsQeAa&q=85&s=c6e860e8cf5131dbd875e2f2234d19d4" alt="edit_icon" width="40" height="30" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_icons/edit-personality-button.png" /> **Edit**:Click the Edit button to modify your Agent.
* <img src="https://mintcdn.com/algoryc/GGeODhG37dHsQeAa/openhome_icons/dashboard_icons/delete_button.png?fit=max&auto=format&n=GGeODhG37dHsQeAa&q=85&s=023a7d1980d6255b5beb97a736b9c9f2" alt="delete_icon" width="40" height="30" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_icons/delete_button.png" /> **Delete**: Delete any created or installed Agents.
* <img src="https://mintcdn.com/algoryc/nIjKmDT8_yYOKqOt/openhome_icons/dashboard_icons/personality-review.png?fit=max&auto=format&n=nIjKmDT8_yYOKqOt&q=85&s=5c3e9746bb4c572e238381ef914acc17" alt="rating_and_review" width="40" height="30" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_icons/personality-review.png" /> **Ratings & Review**: Review and rate the Agent on the marketplace.

### Adding a New Voice

To add your own custom voice, visit the Agents dashboard, and select the <img src="https://mintcdn.com/algoryc/nIjKmDT8_yYOKqOt/openhome_icons/dashboard_images/add_new_voice_id_button.png?fit=max&auto=format&n=nIjKmDT8_yYOKqOt&q=85&s=52dd44d694d9ce2b33545bfd5d7a45ae" alt="add_new_voice_id_button" width="100" height="40" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_images/add_new_voice_id_button.png" />button at the top right of the page and input the following information:

* **Name**: Enter the name of the new voice you want to create. This helps identify the voice within your list of options.
* **Description**: Provide a brief description of the voice, including details like its tone, accent, or intended use. This helps others understand what the voice is designed for when interacting with it.
* **Voice ID**: Input the Voice ID provided by your chosen TTS (Text-to-Speech) provider. This ID links the voice you've uploaded to the provider.
* Select <img src="https://mintcdn.com/algoryc/ENB4lpC7dyVy6FYf/openhome_icons/dashboard_images/save_button.png?fit=max&auto=format&n=ENB4lpC7dyVy6FYf&q=85&s=2a563b22bfc0218c83ee816a5ff3ad81" alt="save_button" width="60" height="40" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_images/save_button.png" /> to finalize and add the new voice.
* If you change your mind, select <img src="https://mintcdn.com/algoryc/GGeODhG37dHsQeAa/openhome_icons/dashboard_icons/add-voice-cancel-button.png?fit=max&auto=format&n=GGeODhG37dHsQeAa&q=85&s=4e6a3eb99db5db8799da65e47c0efb51" alt="cancel_button" width="60" height="40" style={{ display: 'inline-block', marginRight: '8px', verticalAlign: 'middle' }} data-path="openhome_icons/dashboard_icons/add-voice-cancel-button.png" /> to discard your voice.

<p align="center">
  <img src="https://mintcdn.com/algoryc/GGeODhG37dHsQeAa/openhome_icons/dashboard_icons/add-new-voice.png?fit=max&auto=format&n=GGeODhG37dHsQeAa&q=85&s=5b45676815d166bbbdde5655c04c2ae8" alt="add_new_voice_id_form" width="551" height="488" data-path="openhome_icons/dashboard_icons/add-new-voice.png" />
</p>

### Uploading Your Voice

* **Generating a Voice ID**: Before adding a new voice in OpenHome, you’ll need to upload your custom voice to your preferred TTS provider (e.g., Eleven Labs). Once uploaded, you’ll receive a Voice ID from the provider, which you can enter in the Voice ID field here.
* **Updating API Key**: Ensure your API key for the TTS provider is up to date. This key is necessary for OpenHome to communicate with the TTS service and use your custom voice for Agents. You can update or manage your API key in the **API Keys settings** section.