elevenlabs-agent-simulator

ElevenLabs Agent Simulator

A Chrome extension that brings SDK-level conversation testing capabilities directly into the ElevenLabs web interface. Simulate realistic dialogues to test your conversational AI agents before production deployment.

Features

• Side Panel UI: Persistent side panel that stays open while you work
• Auto-Detection: Automatically detects Agent ID from the current page URL
• Dynamic Variables: Add custom variables required by your agent (e.g., user_name, order_id)
• Load Defaults: Auto-fetch placeholder values from your agent configuration
• Conversation View: Clean, readable transcript showing the dialogue flow
• Persistent State: All inputs are saved and restored when you reopen the extension
• Full API Response: Complete JSON output for debugging and analysis

Installation

1. Install dependencies and build:

   npm install
   npm run build
   

2. Load the extension in Chrome:
   • Open chrome://extensions/
   • Enable “Developer mode”
   • Click “Load unpacked”
   • Select the dist folder

Usage

1. Navigate to your agent page: https://elevenlabs.io/app/agents/agents/[your-agent-id]
2. Click the extension icon to open the side panel
3. Enter your ElevenLabs API key (get it from your profile settings)
4. The Agent ID will be auto-populated from the URL
5. Enter a prompt describing how the simulated user should behave:

   You are a customer calling about a product inquiry.
   You are polite but want to know about pricing and availability.
   

6. (Optional) Click “Load Defaults” to auto-fetch dynamic variable placeholders
7. (Optional) Add or modify dynamic variables as needed
8. Click “Start Simulation” to run the test
9. View the conversation transcript and full JSON response

Dynamic Variables

If your agent requires dynamic variables (e.g., customer names, order IDs), you can:

• Click “Load Defaults” to auto-populate placeholder values from your agent config
• Manually add variables using the “Add Variable” button
• Each variable has a key-value pair (e.g., user_name = Javier Perez)

Development

Scripts

• npm run build - Build for production
• npm run dev - Build and watch for changes
• npm run lint - Lint TypeScript files
• npm run type-check - Check TypeScript types

Architecture

See IMPLEMENTATION_PLAN.md for detailed implementation details.

The extension uses direct REST API calls to the ElevenLabs API:

• POST /v1/convai/agents/{agent_id}/simulate-conversation - Run simulations
• GET /v1/convai/agents/{agent_id} - Fetch agent configuration

Requirements

• Chrome 114+ or Edge (Chromium-based)
• ElevenLabs API key (get one here)

Privacy

All data (API keys, prompts, variables) is stored locally on your device using Chrome’s storage API. Nothing is synced to the cloud or shared with third parties.