什么是 AiWma
AiWma 是一套专为中文场景深度打磨的 AI 语音服务平台，提供 AI 客服（ACS）与AI 采访助手（AIJ）两条产品线， 共享同一套语音引擎、知识库与合规基础设施。
AI 客服 · ACS
为您的产品接入具备意图理解、多轮对话与实时语音能力的 AI 客服机器人，支持 Web 组件、REST API 与 WebSocket 三种接入方式。
AI 采访助手 · AIJ
结构化的 AI 新闻采访系统，支持维权、开发者访谈、融资报道等四类采访模板，自动生成合规草稿，内置 PII 脱敏。
平台定位
AiWma 不是一个通用聊天机器人框架，而是针对特定业务场景的垂直 AI 语音解决方案。 它的核心价值体现在三个层面：
- 中文语境深度适配——从语音识别的热词机制到 LLM 的意图理解， 每个环节都针对中文口语和垂直行业术语进行了专项优化。
- 可自托管的完整栈——所有组件（ASR、LLM、TTS、知识库、数据库） 均可在私有环境部署，满足数据主权与合规要求。
- 可配置不可改代码——业务规则、意图树、知识库、品牌声线全部通过 配置文件驱动，运营团队无需改动代码即可完成大部分定制。
产品线对比
| 维度 | ACS · AI 客服 | AIJ · AI 采访 |
|---|---|---|
| 主要场景 | 电商、游戏、SaaS 产品的用户服务 | 媒体采访、内容机构、维权记录 |
| 交互模型 | 意图树 + 工具调用 + 人工切换 | 7 状态采访状态机 + 6 种追问策略 |
| 主要输出 | 实时语音/文字回复，工单写入 | 结构化采访草稿（Markdown/JSON） |
| 接入复杂度 | 低（嵌入一段 JS）→ 高（全参数 API） | 中（REST API + 状态轮询） |
| 合规要求 | 基础 PII 脱敏 | 四级 PII 分级，知情同意全程记录 |
核心技术栈
以下是 AiWma 平台各层的主要组件。作为接入方，您通常只需要关注接口层； 下表供希望深度了解平台能力的开发者参考。
| 层 | 主要组件 | 备用 / 本地替代 |
|---|---|---|
| LLM | Claude Sonnet 4.6 |
GPT-4o / Qwen2.5:7b（本地） |
| ASR | Deepgram Nova-3 (zh-CN) |
Faster-Whisper large-v3（本地） |
| TTS | CosyVoice 2（中文专属） |
ElevenLabs Flash v2.5 |
| 向量检索 | Qdrant 1.9 |
— |
| 数据库 | PostgreSQL 16 |
— |
| 缓存 | Redis 7 |
— |
| 网关 | Fastify 5 + Nginx |
— |
快速上手路径
根据您的目标，选择最合适的起点：
获取 API Key
联系 AiWma 团队（contact@aiwma.com） 开通试用账户，获取您专属的 API Key。 Key 的格式与使用方式见 认证文档。
定制配置
通过 客户配置文件 调整品牌声线、意图树、知识库和配额策略，无需修改代码。
服务层与端口
AiWma 平台由多个微服务组成。作为接入方，您只需与
网关（Gateway）交互——端口 3000（或您部署时配置的域名）。
其他服务属于内部依赖，不对外暴露。
| 服务 | 端口 | 对外可见 | 说明 |
|---|---|---|---|
gateway |
3000 |
是 | REST API + WebSocket，您的唯一接入点 |
engine |
3001 |
否 | 对话引擎，仅 Gateway 内部调用 |
business |
3002 |
否 | 会话管理、采访调度 |
post-process |
3003 |
否 | 草稿生成、合规检查 |
config-server |
3004 |
否 | 客户配置加载与热更新 |
开发环境访问 Nginx 统一入口（端口 80）
实际部署中，所有外部请求都应通过 Nginx 反向代理进入，而不是直接访问 Gateway 端口。
开发环境可直接访问 http://localhost:3000。