用途:创建 simulation 类型的智能体测试,驱动模拟用户与智能体进行完整多轮对话,再按成功条件评判转录。适合 DOM 或 Architect 风格智能体,因为其首个动作通常是启动流程,单轮 LLM 或工具测试只能评判首个动作。
主要能力:通过 API 创建、附加并运行模拟测试,支持模拟场景、成功条件、最大轮数、工具 mock 配置、动态变量与预置对话历史。
使用方式:先读取智能体配置、工具列表与已有测试,再调用 POST https://api.elevenlabs.io/v1/convai/agent-testing/create,请求头为 xi-api-key: $API_KEY。type 必须为 "simulation";simulation_scenario 写给模拟用户,success_conditions 写评判语句;tool_mock_config 是对象,mocking_strategy 只能为 all、selected 或 none;dynamic_variables 为字符串键值对;chat_history 留空表示新对话。创建后用 attach-test 附加,再用 run-tests 运行,并轮询 GET /v1/convai/test-invocations/{suite_id} 直到状态离开 pending。
限制:模拟测试无就地编辑,修改需删除后重建;PUT 不接受 type: simulation。mocking_strategy 为 all 时忽略逐工具覆盖;mocked_tool_ids 必须是真实工具 id;部分 SYSTEM 工具如 RAG 无法 mock。运行耗时数分钟。资料未提供收费、价格与平台支持信息。