Eleven Labs MCP Integration

🚀 十一實驗室MCP集成 - 科技新聞更新代理

這是一個基於FastAPI的後端項目，用於創建十一實驗室（ElevenLabs）代理，該代理可撥出電話，以友好且無專業術語的方式提供科技新聞更新。本項目展示瞭如何集成十一實驗室的MCP（模型上下文協議），以創建具備語音功能的對話式AI代理。

🚀 快速開始

本項目是一個基於FastAPI的後端應用，藉助十一實驗室的MCP協議，創建能撥出電話並提供科技新聞更新的對話式AI代理。以下是快速搭建和使用該項目的步驟。

✨ 主要特性

• 對話式AI代理：創建一個自信、友好且精通科技的“同事”形象。
• 語音集成：使用十一實驗室的Alice語音，使通話聽起來自然流暢。
• 科技新聞推送：提供有關人工智能、編程和網絡安全的最新消息。
• 簡單的API：提供易於使用的端點，用於創建代理和管理通話。
• MCP集成：利用十一實驗室的MCP協議，實現代理的無縫管理。

📦 安裝指南

前提條件

• Python 3.8 或更高版本
• 十一實驗室的API密鑰
• 十一實驗室的電話號碼（用於撥出電話）
• Git

安裝步驟

1. 克隆倉庫

   git clone https://github.com/LEKKALAGANESH/Eleven-Labs-MCP-Integration.git
   cd Eleven-Labs-MCP-Integration
   

2. 安裝依賴項

   pip install -r requirements.txt
   

3. 配置環境變量

   cp .env.example .env
   # 使用實際值編輯.env文件
   

4. 運行服務器

   uvicorn app.main:app --reload
   

🔧 配置

創建一個 .env 文件，並設置以下變量：

ELEVENLABS_API_KEY=your_elevenlabs_api_key
ELEVENLABS_BASE_URL=https://api.elevenlabs.io/v1
AGENT_VOICE_ID=Xb7hH8MSUJpSbSDYk0k2
AGENT_PHONE_NUMBER_ID=your_phone_number_id

📦 項目結構

ElevenLabs/
├── app/
│   ├── main.py              # 包含端點的FastAPI應用程序
│   ├── elevenlabs_client.py # 十一實驗室API客戶端函數
│   └── config.py            # 配置和環境變量
├── requirements.txt         # Python依賴項
├── .env.example            # 環境變量模板
├── .gitignore              # Git忽略規則
└── README.md               # 項目文檔

📚 詳細文檔

📡 API端點

1. 創建代理

POST /create-agent 創建一個具有預定義個性和語音的新科技新聞更新代理。

響應：

{
  "agent": {
    "agent_id": "agent_5701k1capwtse9fske3xgefspyra",
    "name": "Tech News Update Agent",
    "voice_id": "Xb7hH8MSUJpSbSDYk0k2"
  }
}

2. 撥出電話

POST /call 發起一個撥出電話到指定的電話號碼。

請求體：

{
  "phone_number": "+1234567890"
}

響應：

{
  "result": {
    "conversation_id": "conv_3401k1casackffe9emj08wgf9zsd",
    "call_sid": "CA12265951d92ca816f1f15693d7efd6a2",
    "status": "success"
  }
}

💻 使用示例

[基礎用法]

使用curl

1. 創建代理：

   curl -X POST "http://localhost:8000/create-agent"
   

2. 撥打電話：

   curl -X POST "http://localhost:8000/call" \
        -H "Content-Type: application/json" \
        -d '{"phone_number": "+1234567890"}'
   

使用Python requests

import requests

# 創建代理
response = requests.post("http://localhost:8000/create-agent")
agent_data = response.json()
agent_id = agent_data["agent"]["agent_id"]

# 撥打電話
call_data = {"phone_number": "+1234567890"}
response = requests.post("http://localhost:8000/call", json=call_data)
print(response.json())

🤖 代理個性

科技新聞更新代理配置如下：

• 語氣：自信、友好且對話感強。
• 語音：使用Alice（女性語音）進行自然交流。
• 專業領域：提供人工智能、編程和網絡安全的最新消息。
• 風格：以無專業術語的方式解釋，並說明實際影響。
• 方式：就像一位知識淵博的同事分享有趣的新聞。

⚠️ 重要提示

⚠️ 重要提示

• 電話驗證：必須擁有經過驗證或付費的十一實驗室/Twilio賬戶，才能撥打未驗證的號碼。
• 代理ID：創建代理後，將返回的 agent_id 更新到 main.py 文件中。
• API限制：注意十一實驗室API的速率限制和使用配額。
• 環境變量：切勿將實際的API密鑰提交到版本控制系統。

🔗 相關鏈接

• 十一實驗室API文檔
• FastAPI文檔
• MCP（模型上下文協議）

📄 許可證

本項目為開源項目，採用 MIT許可證。

🤝 貢獻

歡迎貢獻代碼！請隨意提交拉取請求。

📞 支持

如需支持，請在GitHub倉庫中創建一個問題，或聯繫維護人員。

使用十一實驗室MCP集成 ❤️ 構建