介绍
# RingBot - AI Phone Calls
使用能够进行自然对话的 AI 语音代理拨打电话。
## 💰 为什么选择 RingBot？（语音 AI 成本低 99%）
**传统语音 AI 成本：** $0.10-0.50/分钟（ElevenLabs, PlayHT 等） **RingBot 成本：** ~$0.01/分钟（仅 Twilio 电话费用！）
| 组件 | 提供商 | 成本 | |-----------|----------|------| | STT (语音转文字) | Groq Whisper | **免费** | | LLM (AI 大脑) | Groq Llama 3.3 70B | **免费** | | TTS (文字转语音) | Groq Orpheus | **免费** | | 语音基础设施 | LiveKit Cloud | **免费层级** | | 电话 | Twilio | ~$0.01/分钟 |
**你只需通过 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`
```bash # .env for DIY setup 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. 客户服务电话 > “打电话给 Comcast，询问升级我的互联网套餐。”
### 5. 个人留言 > “给妈妈打电话，告诉她我爱她，并问问她今天过得怎么样。”
### 6. 商业线索筛选 > “给这份线索名单打电话，询问他们是否对我们的停车解决方案感兴趣。”
### 7. 自动每日通话 > “每天早上 9 点，给仓库打电话检查库存状态。”
### 8. 预约提醒 > “给患者打电话，提醒他们明天的预约。”
## 拨打电话
```bash curl -X POST http://localhost:8000/ringbot/call \ -H "Content-Type: application/json" \ -d '{ "to": "+1XXXXXXXXXX", "purpose": "Brief description of call objective", "context": "Additional context the AI should know" }' ```
**参数：** - `to` - E.164 格式的电话号码 (+1XXXXXXXXXX) - `purpose` - 电话的目的（指引 AI 行为） - `context` - 背景信息、具体请求、需要收集的信息
## 示例：订购披萨
**步骤 1：找到餐厅** ```bash goplaces search "pizza" --lat 41.36 --lng="-72.56" --limit 3 ```
**步骤 2：获取电话号码** ```bash goplaces details ChIJRdQwYs4v5okRY2gp8pgskJ0 # Phone: (860) 663-3999 ```
**步骤 3：拨打电话** ```bash curl -X POST http://localhost:8000/ringbot/call \ -H "Content-Type: application/json" \ -d '{ "to": "+18606633999", "purpose": "Order a pizza for pickup", "context": "Order: 1 large pepperoni pizza. Customer name: Greg. Ask for pickup time and total." }' ```
## 获得良好效果的技巧
**Purpose（目的）** - 保持为一句清晰的话： - ✅ “订购一个披萨以便自取” - ✅ “预约一次牙齿清洁” - ❌ “给他们打电话，也许订点东西或者问点问题”
**Context（背景）** - 具体明确： - 客户/来电者姓名 - 具体的订单或请求 - 偏好和限制条件 - 需要收集回来的信息
## 服务管理
**启动代理：** ```bash cd /path/to/ringbot/src && python agent.py start ```
**启动 API：** ```bash cd /path/to/ringbot && python main.py ```
**检查通话状态：** ```bash curl http://localhost:8000/ringbot/call/{call_id} ```