用途:在模拟测试中把智能体可触达的工具全部 mock,避免测试打到真实系统导致结果不稳定。失败应反映智能体行为错误,而非依赖变动。
主要能力与用法:
- 先解析真实工具 ID。不要手写 ID,从被测智能体派生名称到 ID 的映射: curl -s "https://api.elevenlabs.io/v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID" -H "xi-api-key: $API_KEY" > agent.json ID 位于 conversation_config.agent.prompt.tool_ids,再通过工作区工具列表解析名称: curl -s "https://api.elevenlabs.io/v1/convai/tools?page_size=100" -H "xi-api-key: $API_KEY" 注意分页到末尾(has_more/next_cursor);重名常见,只在智能体自身 tool_ids 内映射;系统工具(start_procedure、end_procedure、load_memory_entry、transfer_to_agent)与 RAG 不会被 mock。
- 写 mock 配置。tool_mock_config 是对象,mocking_strategy 取 all、selected、none 之一;fallback_strategy 用 raise_error 可让未 mock 的调用显式报错;mock_result 是 JSON 编码字符串;parameter_conditions 为空数组表示匹配任意参数。
- mock 数据要符合业务形态,ID 前缀与字段需贴近生产,否则智能体可能拒绝或改道。
- DOM 类智能体需覆盖完整工具面,并给 chat_history 预置一轮 agent 消息,simulation_max_turns 至少 6。
- 用 test-invocations 接口核对 transcript 中每个工具是否返回预期 payload,并搜索 no mock matched。
- 用 PUT /v1/convai/agent-testing/{test_id} 原地更新测试,需发送完整对象,不支持 PATCH(返回 405);404 表示 ID 错误。优先 PUT 而非删除重建,以免丢失挂载与文件夹位置。
限制:资料未提供收费、价格、平台支持范围等信息;具体字段与行为以官方文档为准。