官方插件/SIP语音插件
SIP语音插件
v1.2.x · 已更新 2026-07-05

SIP 语音让您的座席接通电话。 它可以通过任何标准SIP中继拨打和接听真实通话,在通话过程中进行实时语音轮次,并在通话结束时为您提供录音和通话后的摘要。它是 操作符中立它使用标准的SIP协议,因此没有运营商锁定——可以指向你的电信提供商提供的任何中继线路。
该插件以宿主本地方式运行并拼接在一起 baresip (SIP/RTP端点),一个 ALSA 回环 音频路径,以及一个小型的 Python 桥梁,它在通话和网关的语音轮流之间移动音频。它通过以下方式与网关通信 aihummer.service.v1 合同。终端用户的渠道行为显示在渠道页面上 会话初始化协议;本页涵盖插件本身。
事实
| 字段 |
价值 |
| 版本 |
25.1.0 |
| 健康港 |
8830 |
| SIP 监听 |
5062 |
| baresip 控制 |
4444 |
| 运行时 |
baresip + ALSA 回环 + Python 桥接,宿主本地 |
它是什么
在电话通话和AiHummer转弯之间的桥梁。当电话接通时,音频从 baresip 通过 ALSA 回环进入运行一个的 Python 桥 语音转文本 → 代理回合 → 文本转语音 循环并将回复播放回通话中。有两个语音引擎可用:
yandex ——一个实时云语音引擎。
local — 完全自托管,使用 faster-whisper 用于语音转文字和 edge-tts
用于语音合成。
它是如何使用的
在通话中,座席不仅可以进行交谈:
ask_assistant — 执行通话中的座席操作来接听来电者。
send_dtmf — 发出 DTMF 音调(例如,用于导航 IVR 或输入代码)。
- 录音 — 录制通话音频。
- 打断 — 让来电者自然地打断客服的讲话。
- 通话后总结 — 在通话结束后生成摘要。
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
功能范围
[!WARNING]
SIP 插件支持 仅限 STT、TTS、插话、DTMF 和录音。 它
做 不 提供语音翻译——这是一个独立的核心功能
(参见 语音翻译与视频)
并且不是SIP通话路径的一部分。不要在电话通话中假设它。
安装
在管理界面中从市场一键安装 SIP 语音。主机本地部署器下载插件,执行其安装步骤,渲染一个沙箱化的 systemd 单元,并在健康端点响应后才标记为就绪 — 参见 安装与更新然后你配置你的SIP中继凭据并选择 yandex 或者 local 发动机。
[!TIP]
对于完全自托管、无需付费模型的设置,请选择 local 引擎:
faster-whisper 和 edge-tts 将整个语音路径保留在您自己的主机上。
安全与限制
- 运营商中立干线 标准SIP中继,无运营商锁定;检查编解码器、DTMF和路由兼容性。
- 范围是语音转文字/文字转语音/DTMF/录音/插话。 没有语音翻译
调用路径(这是一个核心能力)。
- 主机原生
baresip,回环和桥接运行在 systemd 下,而不是
在一个容器里。
- 录音是明确的。 录音和通话后总结是通话功能
您启用——根据您本地的同意/保留规则处理通话音频。
接下来去哪儿
<p class="doc-plugin-logo"><span class="pl-tile"><img src="/pl/sip.svg" alt="SIP" width="34" height="34" /></span></p>
**SIP 语音让您的座席接通电话。** 它可以通过任何标准SIP中继拨打和接听真实通话,在通话过程中进行实时语音轮次,并在通话结束时为您提供录音和通话后的摘要。它是 **操作符中立**它使用标准的SIP协议,因此没有运营商锁定——可以指向你的电信提供商提供的任何中继线路。
该插件以宿主本地方式运行并拼接在一起 `baresip` (SIP/RTP端点),一个 **ALSA 回环** 音频路径,以及一个小型的 Python 桥梁,它在通话和网关的语音轮流之间移动音频。它通过以下方式与网关通信 `aihummer.service.v1` 合同。终端用户的渠道行为显示在渠道页面上 [会话初始化协议](/zh/v1.0/channels/sip);本页涵盖插件本身。
## 事实
| 字段 | 价值 |
|---|---|
| 版本 | 25.1.0 |
| 健康港 | 8830 |
| SIP 监听 | 5062 |
| baresip 控制 | 4444 |
| 运行时 | baresip + ALSA 回环 + Python 桥接,宿主本地 |
## 它是什么
在电话通话和AiHummer转弯之间的桥梁。当电话接通时,音频从 `baresip` 通过 ALSA 回环进入运行一个的 Python 桥 **语音转文本 → 代理回合 → 文本转语音** 循环并将回复播放回通话中。有两个语音引擎可用:
- **`yandex`** ——一个实时云语音引擎。
- **`local`** — 完全自托管,使用 `faster-whisper` 用于语音转文字和 `edge-tts`
用于语音合成。
## 它是如何使用的
在通话中,座席不仅可以进行交谈:
- **`ask_assistant`** — 执行通话中的座席操作来接听来电者。
- **`send_dtmf`** — 发出 DTMF 音调(例如,用于导航 IVR 或输入代码)。
- **录音** — 录制通话音频。
- **打断** — 让来电者自然地打断客服的讲话。
- **通话后总结** — 在通话结束后生成摘要。
```text
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
```
## 功能范围
> [!WARNING]
> SIP 插件支持 **仅限 STT、TTS、插话、DTMF 和录音。** 它
> 做 **不** 提供语音翻译——这是一个独立的核心功能
> (参见 [语音翻译与视频](/zh/v1.0/voice/diarization-translation-clone))
> 并且不是SIP通话路径的一部分。不要在电话通话中假设它。
## 安装
在管理界面中从市场一键安装 SIP 语音。主机本地部署器下载插件,执行其安装步骤,渲染一个沙箱化的 systemd 单元,并在健康端点响应后才标记为就绪 — 参见 [安装与更新](/zh/v1.0/marketplace/install-updates)然后你配置你的SIP中继凭据并选择 `yandex` 或者 `local` 发动机。
> [!TIP]
> 对于完全自托管、无需付费模型的设置,请选择 **`local`** 引擎:
> `faster-whisper` 和 `edge-tts` 将整个语音路径保留在您自己的主机上。
## 安全与限制
- **运营商中立干线** 标准SIP中继,无运营商锁定;检查编解码器、DTMF和路由兼容性。
- **范围是语音转文字/文字转语音/DTMF/录音/插话。** 没有语音翻译
调用路径(这是一个核心能力)。
- **主机原生** `baresip`,回环和桥接运行在 systemd 下,而不是
在一个容器里。
- **录音是明确的。** 录音和通话后总结是通话功能
您启用——根据您本地的同意/保留规则处理通话音频。
## 接下来去哪儿
- 频道: [会话初始化协议](/zh/v1.0/channels/sip)
- [语音输入/输出(语音转文本/文本转语音)](/zh/v1.0/voice/stt-tts)
- [安装与更新](/zh/v1.0/marketplace/install-updates)