用途
Retell AI 可靠性模式用于在 Retell AI 语音智能体与电话自动化平台上构建更稳定的集成。它适用于使用 Retell AI 处理语音代理、电话呼叫或电话通信的场景，重点在于可靠性相关的实现模式。
主要能力
- 提供基于 retell-sdk 的 SDK 调用模式示例，包括初始化客户端与列出智能体。
- 给出常见错误的处理对照，涵盖 401 未授权、429 请求限流、400 请求参数错误三类情况。
- 提供一个针对依赖型 CRM 故障的安全回退设计示例，说明如何为 CRM 查询设置简短且显式的超时，并提供回退响应：安排跟进或转接人工队列。
- 说明如何通过让预览 CRM 端点返回受控错误来测试回退，并确认没有呼叫被重试或重复预约。
- 建议将回退率与一般呼叫失败分开跟踪，并仅在依赖项与合成恢复呼叫均成功后再移除临时路由变更。
使用方式
前置条件：已完成 retellai-install-auth 安装与认证设置。
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 文档 |
适用场景
- 使用 Retell AI 构建语音智能体或电话自动化流程时，需要处理依赖服务故障与回退逻辑。
- 需要为 CRM 查询等外部依赖设置超时与回退响应，避免重复呼叫或重复预约。
- 需要区分回退率与一般呼叫失败率，以便评估可靠性改进效果。
限制
资料未提供该技能的具体收费、价格、平台支持范围或效果数据。使用前需完成 retellai-install-auth 安装与认证设置。相关资源包括 Retell AI 文档（https://docs.retellai.com）与 retell-sdk npm 包（https://www.npmjs.com/package/retell-sdk）。