provider Agents Platform POST /v1/convai/agents/{agent_id}/simulate-conversation
@utdk/elevenlabs /v1/convai/agents/{agent_id}/simulate-conversation
Simulates A Conversation
Run a conversation between the agent and a simulated user.
agent_id path required
The id of an agent. This is returned on agent creation.
string
xi-api-key header
Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Try it

Authentication
Configure credentials for ElevenLabs API Documentation
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

runConversationSimulationRoute
POST/v1/convai/agents/{agent_id}/simulate-conversation
Run a conversation between the agent and a simulated user.

Parameters

required

The id of an agent. This is returned on agent creation.

Input

required

A specification that will be used to simulate a conversation between an agent and an AI user.

A list of evaluation criteria to test

Maximum number of new turns to generate in the conversation simulation

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import elevenlabs from '@utdk/elevenlabs';

await elevenlabs.runConversationSimulationRoute({
  "new_turns_limit": 10000
})