用途:本技能用于 Retell AI 语音智能体和电话自动化平台的安全基础实现,覆盖安全的 SDK 集成方式与凭据处理,适合在涉及语音智能体、电话呼叫或电信集成时使用。
前提条件:需先完成 retellai-install-auth 的安装与认证配置。
主要用法:使用 retell-sdk 初始化客户端,API 密钥通过环境变量读取,避免硬编码。示例:import Retell from 'retell-sdk'; const retell = new Retell({ apiKey: process.env.RETELL_API_KEY! }); 随后可调用 retell.agent.list() 并打印智能体数量。
安全实践:轮换已暴露的开发凭据时,先在提供方控制台禁用暴露的开发密钥,创建限定范围的替代密钥,仅更新开发环境的密钥引用;用无害的 agent-list 请求验证新密钥,同时确保命令输出不打印密钥值;检查访问日志与受影响的预览配置,记录事件时只写凭据标识和轮换时间,不把密钥材料复制进工单或代码仓库。
错误处理:401 Unauthorized 通常因 API 密钥无效,需检查 RETELL_API_KEY;429 Rate Limited 表示请求过多,应实现退避;400 Bad Request 表示参数无效,需对照 API 文档核查。
资源:Retell AI 文档 https://docs.retellai.com 与 retell-sdk npm 包 https://www.npmjs.com/package/retell-sdk。
限制:资料未提供收费、价格、平台支持范围或具体效果等事实,暂未提供;使用应遵守平台文档与自身安全策略。