用途:面向使用 Retell AI 语音智能体与电话(telephony)平台的调试场景,整理集成实现模式与故障排查流程。使用前提是已完成 retellai-install-auth 认证配置。
主要能力:提供 retell-sdk 的初始化与调用示例,例如用 API Key 创建客户端,并调用 retell.agent.list() 列出智能体;给出常见错误的排查表,包括 401(API Key 无效,检查 RETELL_API_KEY)、429(请求过多,实施退避)、400(参数无效,查阅 API 文档)。
使用方式:按资料示例先完成认证,再以环境变量提供密钥初始化 SDK,然后调用接口获取智能体列表并做日志输出;出现故障时参照错误表定位原因。
支持包实践:为间歇性故障整理安全支持包时,可收集受影响通话 ID、智能体版本、webhook 状态、API 响应头与部署版本(取自测试或经同意的通话),排除 API 密钥、原始音频和完整转录,改用脱敏时间线;先在预览智能体上复现,再修改线上配置,并保留校验和以便与证据对应。
资源与限制:参考 Retell AI 文档(https://docs.retellai.com)与 retell-sdk npm 页面(https://www.npmjs.com/package/retell-sdk)。资料未提供具体计费、价格、平台支持范围及更多功能细节,暂未提供。