retellai-sdk-patterns

用途：为 Retell AI 语音智能体应用提供可上生产的 SDK 使用模式，包括客户端单例、类型化智能体配置、通话管理与错误处理。前提是已完成 retellai-install-auth 并安装 retell-sdk。主要能力与用法：1）单例客户端，通过 getRetellClient 复用同一 Retell 实例，读取 RETELL_API_KEY；2）类型化智能体配置，先创建 LLM（如模型 gpt-4o、general_prompt、functions），再创建 agent（response_engine 指向 retell-llm、voice_id、agent_name、max_call_duration_ms 默认 300000、end_call_after_silence_ms 默认 10000），返回 agentId 与 llmId；3）带重试的通话创建，makeCallWithRetry 在失败时按次数重试，仅对服务端错误（status ≥ 500）重试并做递增延迟；4）批量外呼活动，runCallCampaign 以并发上限与延迟节流遍历号码列表，返回 callId 或错误信息。限制与注意：不要盲目重试，建议在通话创建外层加幂等边界，先在应用边缘生成请求标识并在调用 SDK 前持久化状态，网络响应丢失时用该标识或可关联数据取回既有结果，避免重复拨打客户；重试应有上限且仅限可确定结果的操作。环境变量与依赖需自行配置，具体定价与可用模型等资料暂未提供。