名称： ringbot
描述： 用于拨打外呼AI电话。当被要求致电商家、拨打电话、电话订餐、预约安排或任何需要语音通话的任务时触发。触发词包括：“call”、“phone”、“dial”、“ring”、“order pizza”、“make reservation”、“schedule appointment”。

RingBot - AI 电话呼叫

使用能够进行自然对话的 AI 语音助手拨打外呼电话。

💰 为什么选择 RingBot？（成本降低 99% 的语音 AI）

传统语音 AI 成本： $0.10-0.50/分钟（ElevenLabs、PlayHT 等）
RingBot 成本： 约 $0.01/分钟（仅需支付 Twilio 通话费用！）

您只需通过 Twilio 支付实际通话分钟数的费用。

📦 两种使用 RingBot 的方式

选项 1：DIY（免费 - 使用您自己的密钥）

搭建您自己的基础设施 - 完全免费，仅需支付 Twilio 通话费用。

所需账户：

1. Twilio - https://twilio.com
   • 电话号码（约 $1/月）+ 通话（约 $0.01/分钟）
   • 获取：TWILIO_ACCOUNT_SID、TWILIO_AUTH_TOKEN、TWILIO_PHONE_NUMBER
2. LiveKit Cloud - https://cloud.livekit.io（免费套餐）
   • 创建项目 + 连接到 Twilio 的 SIP 中继
   • 获取：LIVEKIT_URL、LIVEKIT_API_KEY、LIVEKIT_API_SECRET、LIVEKIT_SIP_TRUNK_ID
3. Groq - https://console.groq.com（100% 免费）
   • 获取 API 密钥 + 接受 TTS 条款：https://console.groq.com/playground?model=canopylabs%2Forpheus-v1-english
   • 获取：GROQ_API_KEY

# DIY 设置的 .env 文件示例
TWILIO_ACCOUNT_SID=your_sid
TWILIO_AUTH_TOKEN=your_token
TWILIO_PHONE_NUMBER=+1234567890
LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=your_key
LIVEKIT_API_SECRET=your_secret
LIVEKIT_SIP_TRUNK_ID=your_trunk_id
GROQ_API_KEY=your_groq_key

选项 2：托管服务（付费 - 仅需提供 Twilio）

不想设置 LiveKit 和 Groq？使用我们的托管基础设施。

• ✅ 无需设置 LiveKit
• ✅ 无需设置 Groq
• ✅ 只需连接您的 Twilio 账户
• 💰 按分钟付费 + 适用速率限制

即将推出 - 如需提前体验，请联系：https://talkforceai.com

🚀 使用场景

1. 电话订餐

"给 DeLuca's Pizza 打电话，以 Greg 的名义订一个大的意大利辣香肠披萨自取"

2. 预订餐厅

"打电话给餐厅，预订周六晚上 7 点 4 人的位置"

3. 预约安排

"打电话给 Smith 医生的办公室，预约下周早上的年度体检"

4. 客户服务电话

"打电话给康卡斯特，询问升级我的互联网套餐"

5. 个人留言

"打电话给妈妈，告诉她我爱她，并问问她今天过得怎么样"

6. 商业线索筛选

"打电话给这份潜在客户名单，询问他们是否对我们的停车解决方案感兴趣"

7. 自动化每日通话

"每天早上 9 点，打电话给仓库检查库存状态"

8. 预约提醒

"打电话给患者，提醒他们明天的预约"

发起呼叫

curl -X POST http://localhost:8000/ringbot/call \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1XXXXXXXXXX",
    "purpose": "通话目标的简要描述",
    "context": "AI 应了解的额外背景信息"
  }'

参数说明：
* to - E.164 格式的电话号码（+1XXXXXXXXXX）
* purpose - 通话目的（指导 AI 行为）
* context - 背景信息、具体要求、需要收集的信息

示例：订购披萨

步骤 1：查找餐厅

goplaces search "pizza" --lat 41.36 --lng="-72.56" --limit 3

步骤 2：获取电话号码

goplaces details ChIJRdQwYs4v5okRY2gp8pgskJ0
# 电话：(860) 663-3999

步骤 3：拨打电话

curl -X POST http://localhost:8000/ringbot/call \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+18606633999",
    "purpose": "订购一个披萨自取",
    "context": "订单：1 个大的意大利辣香肠披萨。客户姓名：Greg。询问取餐时间和总价。"
  }'

获取良好效果的技巧

目的（Purpose） - 保持为一个清晰的句子：
* ✅ "订购一个披萨自取"
* ✅ "预约一次牙齿清洁"
* ❌ "打电话给他们，也许订点东西或问些问题"

背景（Context） - 要具体：
* 客户/呼叫者姓名
* 确切的订单或请求
* 偏好和限制条件
* 需要收集回来的信息

服务管理

启动代理：

cd /path/to/ringbot/src && python agent.py start

启动 API：

cd /path/to/ringbot && python main.py

检查通话状态：

curl http://localhost:8000/ringbot/call/{call_id}