**Asterisk AI 语音助手 (AVA)** 是一个开源、模块化的平台,通过 ARI 将人工智能直接集成到 Asterisk/FreePBX 环境中。它支持混合部署、纯云端部署或完全本地部署,能够实现实时语音交互、工具调用(转接、邮件、摘要)以及插话(barge-in)支持等高级功能。
### 快速入门
1. **克隆与设置:**
```bash
git clone https://github.com/hkjarral/AVA-AI-Voice-Agent-for-Asterisk.git
cd AVA-AI-Voice-Agent-for-Asterisk
sudo ./preflight.sh --apply-fixes
```
2. **启动:** 运行 `docker compose -p asterisk-ai-voice-agent up -d` 启动管理界面和 AI 引擎。
3. **配置:** 通过 `http://localhost:3003` 访问管理界面。按照设置向导选择您的服务提供商(如 OpenAI、Google、Deepgram、xAI Grok 或本地 Ollama),并生成拨号方案(dialplan)代码片段。
### 主要功能
* **部署灵活性:** 支持基于云端(OpenAI, Google, ElevenLabs)或完全本地(Ollama/Faster-Whisper/Piper)的推理,以实现最大程度的隐私保护。
* **易用性:** 通过可视化仪表盘管理智能体、提示词(prompts)和语音。
* **生产就绪:** 内置通话记录、监控、诊断命令行工具及多租户安全机制。
* **Asterisk 集成:** 通过标准的拨号方案变量(`AI_AGENT`)进行连接,实现无缝路由。
*注意:需要 x86_64 Linux 系统及已启用 ARI 的 Asterisk 18+ 版本。*