Skip to content

Update documentation for ElevenLabs User Simulator #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fanny-riols merged 3 commits into from
Apr 1, 2026
Merged

Update documentation for ElevenLabs User Simulator #39

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
bfe8b28
Update documentation for ElevenLabs User Simulator
fanny-riols Mar 31, 2026
b1690e6
Apply pre-commit
fanny-riols Mar 31, 2026
c515d87
Add the first step to create the agent
fanny-riols Apr 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 21 additions & 14 deletions docs/experiment_setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,20 +114,25 @@ EVA_MODEL_LIST='[

## ElevenLabs User Simulator

The user simulator is an ElevenLabs Agent with the following configuration:

| Parameter | Value |
|---|---|
| LLM | GPT-4.1 |
| Voice (female) | Natalee Champlin |
| Voice (male) | Eric |
| Input audio | μ-law telephony, 8000 Hz |
| Turn detection silence | 15ms |
| Max conversation duration | 600s |
| Interruptions | Disabled |
| First message | None (agent speaks first) |
| Default personality | Disabled |
| Tools | end_call (user ends the call once task is complete or conversation cannot be advanced) |
We created 2 ElevenLabs Agents for the user simulator, one with a female and one with a male voice. When you create a new agent, create a "Blank Agent".
Then, use the following configuration:

| Parameter | Value |
|--------------------------------------|-----------------------------------------------------------------------------------|
| Voice (female) | Natalee Champlin |
| Voice (male) | Eric - Smooth, Trustworthy |
| TTS model family | V3 Conversational |
| Expressive mode | Enabled (no tags selected) |
| Language | English |
| LLM | GPT-5.1 |
| System prompt | {{prompt}} |
| Default personality | Disabled |
| First message | None (remove the default first message, as the agent speaks first) |
| Interruptible | Disabled |
| Advanced > Input audio | μ-law telephony, 8000 Hz |
| Advanced > Take turn after silence | 15ms |
| Advanced > Max conversation duration | 600s |
| Tools > System tools | Enable "End conversation" (Name is `end_call`, and Description is provided below) |

The simulator is prompted with a specific user goal and is instructed to stay on task, communicate all required named entities clearly, and terminate when the goal is accomplished or the task is clearly unlikely to succeed.

Expand All @@ -146,3 +151,5 @@ Call this function when any ONE of the following is true:

Before calling this tool, always say a brief goodbye first.
```

You can then get your `agent-id` from the Widget tab of your agent.
Loading