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 驱动的电话接待员（以及许多其他消息渠道），并完全掌控数据、模型与集成。
相关
- 项目
- 项目
- 项目
- 项目