用途：该技能面向 Retell AI 语音智能体与电话自动化平台的集成开发，整理已知实现陷阱与应对模式，帮助在语音外呼、电话流程和电话系统集成中减少踩坑。
主要能力：给出 SDK 调用模式，使用 retell-sdk 初始化客户端并列出智能体；提供常见 API 错误的分类与处理建议，包括 401 未授权（检查 RETELL_API_KEY）、429 限流（实现退避）、400 请求错误（核对 API 文档）；并专门说明网络超时后的重复拨号风险及处理策略。
必要用法：需先完成 retellai-install-auth 安装与鉴权设置。初始化示例为：import Retell from 'retell-sdk'; const retell = new Retell({ apiKey: process.env.RETELL_API_KEY! });，随后可调用 retell.agent.list() 列出智能体。
关键实践：当外呼请求在提交后超时，重试前应先通过请求关联标识或呼叫标识确认 Retell 是否已创建该呼叫；若状态未知，应暂缓重试并携带脱敏后的请求元数据上报升级，因为重复发送请求可能导致同一联系人被呼叫两次。仅在操作明确幂等时添加有界重试，并在变更后监控重复拨号率。
适用场景：使用 Retell AI 构建语音智能体、执行电话外呼或对接电话系统的开发与运维工作。
限制：资料未提供具体计费、价格、平台覆盖范围或效果数据；部分内容以英文原文呈现，实际参数与接口细节需以官方文档为准。