用途:Vapi Simulations 用于为助手(assistant)或小队(squad)构建真实感对话测试。五层结构为:人格控制 AI 测试者,场景定义意图与可衡量结果,模拟把二者配对,套件把模拟分组,运行对目标执行。适合多轮行为、人格变化、小队交接、真实工具路径或音频行为;若需精确回复、正则、固定模拟对话或精确工具参数校验,则应使用 Evals,不要创建旧版 Test Suites。
主要能力:先把自然语言需求改写成两名评审能得出一致通过/失败判断的可测陈述,并记录来源,按高影响、高频、高不确定度排序覆盖。设计覆盖矩阵后再写载荷;每个目标按核心结果、来电者变化、信息缺失或不清晰、工具或服务失败恢复、护栏、无法满足时的安全替代、交接质量、语音一轮、已知生产故障回归等顺序覆盖。先做一个核心路径冒烟模拟,用一到两个必需布尔结果、chat 传输和一次迭代。
使用方式:运行前先检查目标与既有资源,复用意图和配置明确匹配的资源,否则新建或让用户选择。按依赖顺序创建人格与场景、再模拟、可选套件;创建要求 201,更新先获取当前资源,套件 simulationIds 和 targetAssignments 为整体替换。运行优先用 vapi.webchat 快速迭代,语音相关用 vapi.websocket;先一次迭代,仅在单次有效后为衡量一致性增加次数。用 POST /eval/simulation/run 创建,返回运行 ID 与仪表盘 URL 时一并给出。
限制与安全:发送前须对照当前 Vapi 文档、API 参考或 OpenAPI 验证实时载荷。不得打印、索取或嵌入 API 密钥、凭据、私有 webhook URL 或真实客户数据。运行模拟视为外部操作,会消耗额度、占用并发、发送 webhook,并可能调用目标真实工具,除非已 mock。未明确要求时不要运行、取消、更新或删除资源,应改为起草配置。所有 ID 必须从用户输入或 API 解析,不得杜撰。模拟使用 /eval/simulation API 家族。400 时对照当前 schema 修正一处明确校验问题后最多重试一次;401/403 停止处理认证或权限;404 报告缺失依赖;409 或并发错误检查并发与活动运行;5xx 报告服务失败。仅在排队或运行中可取消。未经验证 API 响应,不得声称运行、取消、变更或通过成功。资料外的收费、价格等细节暂未提供。