simulate_conversation
Run a simulated text conversation between your AI agent and a user persona to test behavior, evaluate prompts, and catch failure modes without a live call.
Instructions
Simulate a text conversation between a conversational AI agent and a simulated user. Runs the full conversation and returns the transcript plus analysis.
Use this to test agent behaviour, evaluate prompts, and catch failure modes without
a live call. The simulated user follows the persona you describe.
⚠️ COST WARNING: This tool makes an API call to ElevenLabs which may incur costs.
Only use when explicitly requested by the user.
Args:
agent_id: ID of the agent to test. Use list_agents to find IDs.
simulated_user_prompt: Instructions for how the simulated user should behave.
Example: "You are a frustrated customer who cannot find the cancel button."
first_message: Optional opening message to kick off the conversation.
extra_evaluation_criteria: Optional list of dicts, each with:
- id (str): unique key e.g. "issue_resolved"
- name (str): human label e.g. "Issue Resolved"
- conversation_goal_prompt (str): the assertion to check
e.g. "The agent fully resolved the user's issue."
- use_knowledge_base (bool, optional): whether the evaluator should
reference the agent's knowledge base when judging. Defaults to False.
max_turns: Maximum conversation turns. Defaults to 10.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | ||
| max_turns | No | ||
| first_message | No | ||
| simulated_user_prompt | Yes | ||
| extra_evaluation_criteria | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| type | Yes | ||
| _meta | No | ||
| annotations | No |