用途:这是 Retell AI(语音智能体与电话通信平台)的事故处理手册(incident runbook),适用于语音智能体、电话呼叫或电信场景的故障响应。
主要能力:
- SDK 接入模式:使用 retell-sdk 初始化客户端并列出智能体。 import Retell from 'retell-sdk'; const retell = new Retell({ apiKey: process.env.RETELL_API_KEY! }); const agents = await retell.agent.list(); console.log(Agents: ${agents.length});
- 错误处理对照:401 Unauthorized 为 API 密钥无效(检查 RETELL_API_KEY);429 Rate Limited 为请求过多(实现退避);400 Bad Request 为参数无效(查阅 API 文档)。
- 应急流程示例:当转移失败率超过告警阈值时,冻结新智能体上线,将新通话路由到最近已知良好版本或人工队列;记录通话标识、智能体版本、转移目标和响应码,但不要把录音复制到事故频道;用合成预览通话与受影响的生产版本对比,只做一次可逆的路由变更,并在恢复正常流量前记录回滚条件。
前置条件:需先完成 retellai-install-auth 安装与认证配置。
适用场景:Retell AI 语音智能体的线上事故遏制、通话转移故障排查、版本回滚与证据留存。
限制:资料未提供具体部署架构、告警阈值数值、支持的电话系统或合规要求,需自行按实际环境确认。相关资源为 Retell AI 文档(https://docs.retellai.com)和 retell-sdk npm 包(https://www.npmjs.com/package/retell-sdk)。