AVA Core：Asterisk AI 语音代理

项目简介

AVA Core 是一个面向 Asterisk 和 FreePBX 的开源 AI 语音代理（AI Voice Agent），通过 Audiosocket、RTP、Websocket 等技术与电话系统对接，用来构建电话语音代理。它既可以使用完整的实时语音提供商，也可以把语音识别（STT）、语言模型（LLM）、语音合成（TTS）拆成模块化管线，并通过自托管 Admin UI 管理配置、Agent 和通话记录。项目采用 MIT 许可证。

项目提供演示主页 https://demo.agent6789.com 和两条美国演示电话：标准语音 (925) 736-6718，HD 语音 (909) 788-2282；HD 语音需要支持 G.722 的线路/设备并启用 wideband_pcm_16k Audio Profile。

主要功能

• 实时或模块化语音：可选 Deepgram、OpenAI Realtime、Google Live/Vertex、ElevenLabs、xAI Grok 等实时语音提供商，也可自行组合 STT、LLM、TTS 后端，包括 OpenAI 兼容端点。
• 自托管管理后台：配置提供商与 Agent，查看 Call History，筛选和导出记录，并通过面板管理更新。
• 电话系统工具：转接、分机可用性查询、语音信箱、挂断控制等与 Asterisk 集成的能力。
• 业务集成：Google/Microsoft 日历、可选 Teams 会议、Calendly 预约、Pushover、邮件、HTTP 摘要，以及带按 Agent 访问控制的 MCP 工具。
• 云、混合或本地运行：可选择音频与模型推理的运行位置；支持本地语音和/或 LLM 推理、可选 GPU 加速、远程本地模型服务器。
• 运维诊断：CLI 健康检查、脱敏支持包、指标，以及升级与恢复文档。
• 传输方式：AudioSocket、ExternalMedia RTP 取决于配置；Media WebSocket 为可选启用，并对 Asterisk 有额外要求。

安装与使用

准备一台 Linux x86_64 主机，安装 Docker Compose v2，并准备已启用 ARI 的 Asterisk 18+ / FreePBX 系统。纯云配置建议至少 2 核 CPU、4 GB 内存；本地推理需要更多资源。安装前先查看支持平台与传输兼容性文档。

在 AVA 主机上执行：

git clone --branch v7.7.1 https://github.com/hkjarral/AVA-AI-Voice-Agent-for-Asterisk.git
cd AVA-AI-Voice-Agent-for-Asterisk
sudo ./preflight.sh --apply-fixes
docker compose -p asterisk-ai-voice-agent up -d --build admin_ui

preflight.sh 会准备 .env、生成 JWT 密钥并检查 PBX/媒体权限。随后打开 http://<server-ip>:3003，用日志中的一次性管理员密码登录：

docker compose -p asterisk-ai-voice-agent logs admin_ui | grep -i password

首次登录后修改密码，完成 Setup Wizard，配置生成的 Asterisk dialplan，并按安装指南启动 AI Engine。确认引擎健康并完成测试通话后，再把来电路由到代理。已有安装请按 v7.7.1 升级指南操作，不要重复克隆新实例。

本地转写方面，Admin API 可通过带认证的 OpenAI 兼容接口暴露本地 STT，不提供云端回退或转写 UI；具体后端、限制和实时通话优先级见转写指南。

注意事项

• 不同模型、工具、传输方式的可用性、延迟和支持程度不同，应按兼容性矩阵和发布验证结果确认，不要默认所有提供商/传输组合都可用。
• AudioSocket 与 ExternalMedia RTP 受配置影响；Media WebSocket 需要额外 Asterisk 模块或较新版本。
• 外呼活动（Outbound campaigns）和 VICIdial 集成仍为 alpha；FreeSWITCH 支持由社区维护。
• 混合部署仍会把配置的输入发送到云服务。
• 3003 端口应通过防火墙、VPN 或带认证的 TLS 反向代理限制访问，不要直接暴露到公网。
• v7.7.1 的 tag 与发布物仍需维护者批准；安装前请以 GitHub Releases 的实际发布状态为准。

---

本作品整理自 GitHub 开源项目 hkjarral/AVA-AI-Voice-Agent-for-Asterisk，原作者 @hkjarral，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。