Dpro-at/Tel-Agent
AI phone assistant | open-source
Tel‑Agent – 開源 AI 電話助理閘道
它是什麼 – Tel‑Agent 是一個自行託管的閘道，可將傳統 SIP 電話線路（或任何相容 SIP 的 PBX）連接到 AI 代理。來電會根據使用者定義的規則進行路由：可以轉接給真人、封鎖，或由 AI 接聽，AI 能進行即時對話、呼叫外部 HTTP 端點、留言、查詢行事曆等。同一個 AI 代理也能透過使用者的憑證，在數十種訊息管道（網頁聊天、SMS、電子郵件、WhatsApp、Telegram、Discord、Slack 等）進行對話。
為什麼重要 – 市面上有商業化的「AI 接待員」服務，但它們通常是閉源、僅限雲端，且將錄音和 API 金鑰掌握在供應商手中。Tel‑Agent 讓您能在自己的硬體上執行整個堆疊，選擇任何 LLM 或 TTS/STT 提供者（或執行本地模型），並將所有資料掌握在自己手中。
核心功能
- 多管道入站路由 – SIP 語音加上 24 種以上的訊息平台（WhatsApp、Telegram、Discord、Slack、電子郵件等）。
- 即時 AI 對話 – 串流語音轉文字、LLM 生成和文字轉語音；首次語音回應時間低於 800 ms。
- 工具呼叫 – 代理可以呼叫任意 HTTP 端點，實現行事曆查詢、工單建立、通話轉接等動作。
- 完整錄音與轉錄 – 每次互動皆會儲存、可搜尋，並符合 GDPR/EU‑AI‑Act 規範。
- 自行託管部署 – 提供 Windows/macOS/Linux 原生安裝程式、Docker‑Compose 以及基於 Caddy 的 HTTPS 反向代理。
- 可插拔後端 – 預設使用 Deepgram (STT)、ElevenLabs (TTS) 和雲端 LLM；預計在 v1.1 支援本地模型 (Ollama, Whisper, Piper)。
- 多語言支援 – UI 和代理目前支援英語、德語、阿拉伯語、西班牙語、荷蘭語；歡迎參與 i18n 貢獻。
架構概覽
| 層級 | 技術 |
|---|---|
| 語音/代理執行環境 | Python + LiveKit Agents |
| HTTP API | FastAPI (Python) |
| 前端儀表板 | Next.js + React |
| 持久化儲存 | SQLite (預設) – 可選 PostgreSQL |
| 快取 / 佇列 | Redis |
| TLS 終止 / 反向代理 | Caddy |
| 打包 | Windows 安裝程式, macOS pkg, Linux DEB/RPM, Docker‑Compose |
快速開始 (Docker)
git clone https://github.com/Dpro-at/Tel-Agent.git
cd Tel-Agent
cp .env.example .env # 設定 ENCRYPTION_KEY (例如 openssl rand -hex 32)
# 編輯 .env 以加入您的 STT/LLM/TTS 金鑰與頻道憑證
docker compose up -d --build # 啟動 API, 儀表板, LiveKit, Redis 等。
- 儀表板: http://localhost:38471
- API 文件: http://localhost:38472/docs
- 使用發布的
docker-compose.release.yml可跳過建置步驟，或從發布頁面執行原生安裝程式。
典型使用案例
- AI 接待員 – 自動接聽商務電話、提供資訊、安排預約，並在需要時轉接給真人。
- 全通路支援 – 單一 AI 助理處理語音、SMS、WhatsApp、Slack 等，為客戶提供一致的體驗。
- 內部工具 – 讓代理透過通用 HTTP 工具觸發內部 API（例如工單、庫存）。
- 資料所有權合規 – 將錄音和轉錄內容保留在本地，以滿足 GDPR 或 EU‑AI‑Act 要求。
授權與商業選項
- AGPL‑3.0 – 任何網路服務的修改都必須公開。
- 對於有需要的企業，Dpro GmbH 提供商業閉源授權。
更多資訊
- 完整路線圖:
docs/ROADMAP.md - 貢獻指南:
CONTRIBUTING.md(包含入門教學) - 安全政策:
SECURITY.md - API 規格:
docs/SPEC.md
簡而言之 – Tel‑Agent 是一個開源、自行託管的橋樑，讓您能在自己的基礎設施上執行 AI 驅動的電話接待員（以及許多其他訊息管道），並完全掌控資料、模型與整合。
相關
- 專案
- 專案
- 專案
- 專案