SuperAPI AI 工具集

retellai-common-errors

智能体与模型

查看项目

更新于 10-16 06:20

技能介绍

用途:该技能是 Retell AI 常见错误的快速参考,帮助定位并修复语音智能体在通话、Webhook 和语音质量方面的问题。

主要能力:覆盖六类常见错误。401 Unauthorized 需在 Retell Dashboard 核对 API key,确保 RETELL_API_KEY 以 key_ 开头;通话立即失败通常是 400 电话号码格式错误,需使用 E.164 格式如 +14155551234,from_number 与 to_number 均须有效;智能体不响应需检查 LLM 配置,可用 retell.llm.retrieve(agent.response_engine.llm_id) 查看模型与 general_prompt 长度,确保提示词非空且指令清晰;函数调用超时要求端点 5 秒内响应,应避免在响应前执行异步工作;Webhook 未收到事件需在 agent 上设置 webhook_url,而非仅在 Dashboard 设置;语音质量差需检查到 Retell 服务器的网络延迟并尝试不同 voice ID。

使用方式:需先安装 retell-sdk 并配置 API key。错误处理按 HTTP 码区分:400、401、404 不可重试,需修正参数、密钥或 ID;429 与 500+ 可重试,429 应退避。

适用场景:调试 Retell AI 通话问题、排查 Webhook 与函数调用故障、优化语音质量。

限制:资料未提供具体价格、平台支持范围及完整安装命令;示例代码仅作参考,实际使用需结合自身环境验证。