Rapida：端到端语音编排平台

Rapida 是一个开源平台，旨在实现大规模语音智能体的设计、构建与部署。 它基于三大核心原则：

• 可靠性 (Reliable) — 专为生产环境工作负载、实时音频处理和容错执行而设计。
• 可观测性 (Observable) — 对通话、延迟、性能指标和工具使用情况提供深度可见性。
• 可定制性 (Customizable) — 灵活的架构，可适配任何 LLM、工作流或企业技术栈。

Rapida 为构建真实世界的语音智能体提供了平台和框架——涵盖了从低延迟音频流到编排、监控及集成的全流程。

Rapida 使用 Go 语言编写，并利用高度优化的 gRPC 协议实现快速、高效的双向通信。

---

架构

---

特性

• 实时语音编排 利用 GRPC 实现低延迟音频流处理。

• 模型无关 (LLM-Agnostic) 架构 自带模型支持——无论是 OpenAI、Anthropic、开源模型还是自定义推理服务均可接入。

• 生产级可靠性 内置重试机制、错误处理、通话生命周期管理和健康检查。

• 全面可观测性 提供通话日志、流式事件、工具调用追踪、延迟分解、性能指标及仪表盘。

• 灵活的工具系统 为智能体构建自定义工具和动作，或与任何后端系统集成。

• 开发者友好 提供清晰的 API、模块化组件和简洁的配置方式。

• 企业级就绪 具备可扩展的设计、高效的通信协议和可预测的性能表现。

文档与指南

https://doc.rapida.ai

先决条件

• Docker & Docker Compose (安装指南)
• 16GB+ RAM (用于运行所有服务)

---

快速开始

仅需 4 条命令即可启动所有服务：

# 克隆仓库
git clone https://github.com/rapidaai/voice-ai.git && cd voice-ai

# 设置并构建
make setup-local && make build-all

# 启动所有服务
make up-all

# 查看运行中的服务
docker compose ps

服务地址：

• UI: http://localhost:3000
• Web API: http://localhost:9001
• Assistant API: http://localhost:9007
• Endpoint API: http://localhost:9005
• Integration API: http://localhost:9004
• Document API: http://localhost:9010

停止服务：

make down-all

---

开发

操作特定服务

# 仅启动数据库
make up-db

# 仅启动 UI
make up-ui

# 仅启动 Assistant API
make up-assistant

# 列出所有可用命令
make help

查看日志

# 查看所有服务日志
make logs-all

# 查看特定服务日志
make logs-web
make logs-assistant

代码修改后重建

# 重建并重启单个服务
make rebuild-assistant

# 重建所有服务
make rebuild-all

配置服务

启动前请编辑环境变量文件：

• docker/web-api/.web.env - Web API (端口 9001)
• docker/assistant-api/.assistant.env - Assistant API (端口 9007)
• docker/endpoint-api/.endpoint.env - Endpoint API (端口 9005)
• docker/integration-api/.integration.env - Integration API (端口 9004)
• docker/document-api/config.yaml - Document API (端口 9010)

请在这些文件中填入您的 API 密钥（OpenAI、Anthropic、Deepgram、Twilio 等）。

---

本地开发（不使用 Docker）

Go 服务

# 下载依赖
go mod download

# 构建服务
go build -o bin/web ./cmd/web

# 运行服务
./bin/web

需要独立安装并运行 PostgreSQL、Redis 和 OpenSearch。

React UI

cd ui

# 安装并运行
yarn install
yarn start:dev

# 构建生产环境版本
yarn build

---

故障排除

端口被占用：

lsof -i :3000    # 查找占用端口的进程
kill -9 <PID>    # 终止进程

服务无法启动：

make logs-all    # 检查日志
docker compose ps  # 验证服务状态

数据库问题：

# 测试连接
docker compose exec postgres psql -U rapida -d web_db -c "SELECT 1"