SIP Voice сіздің агентіңізді телефонға қосады. Ол кез келген стандартты SIP-транк арқылы нақты қоңырауларды қабылдайды әрі шалады, қоңырау кезінде тірі сөйлеу кезегін орындайды және қоңырау аяқталғанда сізге жазбаны және қоңыраудан кейінгі түйіндемені береді. Ол оператордан тәуелсіз: таза SIP тілінде сөйлейді, сондықтан операторға байланып қалу жоқ — оны телефония провайдеріңіз берген кез келген транкке бағыттаңыз.
Плагин хостта нативті түрде жұмыс істейді және baresip (SIP/RTP нүктесі), ALSA loopback аудио жолы мен қоңырау мен шлюздің дауыстық кезегі арасында аудионы тасымалдайтын шағын Python көпірін біріктіреді. Ол шлюзбен келісімшарт арқылы байланысады. Соңғы пайдаланушыға арналған арна әрекеті арна бетінде сипатталған — SIP; бұл бет плагиннің өзін қамтиды.
Телефон қоңырауы мен AiHummer кезегі арасындағы көпір. Қоңырау қосылғанда, аудио baresip арқылы ALSA loopback арқылы Python көпіріне ағады, ол сөзден мәтінге → агент кезегі → мәтіннен сөзге циклін орындайды және жауапты қоңырауға қайта ойнатады. Екі сөйлеу қозғалтқышы қолжетімді:
yandex — нақты уақыттағы бұлттық сөйлеу қозғалтқышы.
local — толығымен өзіңде орналасатын, STT үшін faster-whisper және TTS үшін edge-tts қолданады.
Қалай қолданылады
Қоңырау кезінде агент тек сөйлеп қана қоймай, көбірек жасай алады:
ask_assistant — қоңырау шалушыға жауап беру үшін қоңырау кезінде агент кезегін орындау.
send_dtmf — DTMF тондарын шығару (мысалы, IVR-да жүру немесе кодты енгізу үшін).
жазу — қоңырау аудиосын түсіру.
barge-in — қоңырау шалушыға агенттің сөзін табиғи түрде үзуге мүмкіндік беру.
қоңыраудан кейінгі түйіндеме — қоңырау аяқталғанда түйіндеме шығару.
[!WARNING]
SIP плагині тек STT, TTS, barge-in, DTMF және жазуды қолдайды. Ол сөйлеушіні диаризациялауды, сөйлеуді аударуды немесе дауысты клондауды қамтамасыз етпейді. Бұлар бөлек ядро/sidecar мүмкіндіктері (қараңыз:
Диаризация, аудару және клондау)
және SIP қоңырау жолының бөлігі емес. Оларды телефон қоңырауында бар деп есептемеңіз.
Орнату
SIP Voice-ты әкімші UI-дегі маркетплейстен бір рет басумен орнатыңыз. Хостта нативті деплоер плагинді жүктейді, оның орнату қадамын орындайды, оқшауланған systemd бірлігін рендерлейді және дайын деп белгілеу алдында health нүктесін күтеді — қараңыз: Орнату және жаңартулар. Содан кейін SIP-транк деректемелерін конфигурациялап, yandex немесе local қозғалтқышын таңдайсыз.
[!TIP]
Толығымен өзіңде орналасатын, ақылы модельсіз орнату үшін local қозғалтқышын таңдаңыз: faster-whisper және edge-tts бүкіл дауыстық жолды өз хостыңызда сақтайды.
Қауіпсіздік және шектеулер
Оператордан тәуелсіз транк. Стандартты SIP, операторға байланып қалу жоқ.
Ауқым — STT/TTS/DTMF/жазу/barge-in. Қоңырау жолында диаризация, аудару немесе дауысты клондау жоқ.
Хостта нативті.baresip, loopback және көпір контейнерде емес, systemd астында жұмыс істейді.
Жазу — анық. Жазу және қоңыраудан кейінгі түйіндемелер — сіз қосатын қоңырау мүмкіндіктері — қоңырау аудиосын жергілікті келісім/сақтау ережелеріңізге сай өңдеңіз.
<p class="doc-plugin-logo"><span class="pl-tile"><img src="/pl/sip.svg" alt="SIP" width="34" height="34" /></span></p>
**SIP Voice сіздің агентіңізді телефонға қосады.** Ол кез келген стандартты SIP-транк арқылы нақты қоңырауларды қабылдайды әрі шалады, қоңырау кезінде тірі сөйлеу кезегін орындайды және қоңырау аяқталғанда сізге жазбаны және қоңыраудан кейінгі түйіндемені береді. Ол **оператордан тәуелсіз**: таза SIP тілінде сөйлейді, сондықтан операторға байланып қалу жоқ — оны телефония провайдеріңіз берген кез келген транкке бағыттаңыз.
Плагин хостта нативті түрде жұмыс істейді және `baresip` (SIP/RTP нүктесі), **ALSA loopback** аудио жолы мен қоңырау мен шлюздің дауыстық кезегі арасында аудионы тасымалдайтын шағын Python көпірін біріктіреді. Ол шлюзбен келісімшарт арқылы байланысады. Соңғы пайдаланушыға арналған арна әрекеті арна бетінде сипатталған — [SIP](/kk/v1.0/channels/sip); бұл бет плагиннің өзін қамтиды.
## Фактілер
| Өріс | Мән |
|---|---|
| Нұсқа | 25.1.0 |
| Health порты | 8830 |
| SIP тыңдау | 5062 |
| baresip басқару | 4444 |
| Орта | baresip + ALSA loopback + Python көпірі, хостта нативті |
## Бұл не
Телефон қоңырауы мен AiHummer кезегі арасындағы көпір. Қоңырау қосылғанда, аудио `baresip` арқылы ALSA loopback арқылы Python көпіріне ағады, ол **сөзден мәтінге → агент кезегі → мәтіннен сөзге** циклін орындайды және жауапты қоңырауға қайта ойнатады. Екі сөйлеу қозғалтқышы қолжетімді:
- **`yandex`** — нақты уақыттағы бұлттық сөйлеу қозғалтқышы.
- **`local`** — толығымен өзіңде орналасатын, STT үшін `faster-whisper` және TTS үшін `edge-tts` қолданады.
## Қалай қолданылады
Қоңырау кезінде агент тек сөйлеп қана қоймай, көбірек жасай алады:
- **`ask_assistant`** — қоңырау шалушыға жауап беру үшін қоңырау кезінде агент кезегін орындау.
- **`send_dtmf`** — DTMF тондарын шығару (мысалы, IVR-да жүру немесе кодты енгізу үшін).
- **жазу** — қоңырау аудиосын түсіру.
- **barge-in** — қоңырау шалушыға агенттің сөзін табиғи түрде үзуге мүмкіндік беру.
- **қоңыраудан кейінгі түйіндеме** — қоңырау аяқталғанда түйіндеме шығару.
```text
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller
```
## Мүмкіндіктер аясы
> [!WARNING]
> SIP плагині **тек STT, TTS, barge-in, DTMF және жазуды** қолдайды. Ол сөйлеушіні диаризациялауды, сөйлеуді аударуды немесе дауысты клондауды **қамтамасыз етпейді**. Бұлар бөлек ядро/sidecar мүмкіндіктері (қараңыз:
> [Диаризация, аудару және клондау](/kk/v1.0/voice/diarization-translation-clone))
> және SIP қоңырау жолының бөлігі емес. Оларды телефон қоңырауында бар деп есептемеңіз.
## Орнату
SIP Voice-ты әкімші UI-дегі маркетплейстен бір рет басумен орнатыңыз. Хостта нативті деплоер плагинді жүктейді, оның орнату қадамын орындайды, оқшауланған systemd бірлігін рендерлейді және дайын деп белгілеу алдында health нүктесін күтеді — қараңыз: [Орнату және жаңартулар](/kk/v1.0/marketplace/install-updates). Содан кейін SIP-транк деректемелерін конфигурациялап, `yandex` немесе `local` қозғалтқышын таңдайсыз.
> [!TIP]
> Толығымен өзіңде орналасатын, ақылы модельсіз орнату үшін **`local`** қозғалтқышын таңдаңыз: `faster-whisper` және `edge-tts` бүкіл дауыстық жолды өз хостыңызда сақтайды.
## Қауіпсіздік және шектеулер
- **Оператордан тәуелсіз транк.** Стандартты SIP, операторға байланып қалу жоқ.
- **Ауқым — STT/TTS/DTMF/жазу/barge-in.** Қоңырау жолында диаризация, аудару немесе дауысты клондау жоқ.
- **Хостта нативті.** `baresip`, loopback және көпір контейнерде емес, systemd астында жұмыс істейді.
- **Жазу — анық.** Жазу және қоңыраудан кейінгі түйіндемелер — сіз қосатын қоңырау мүмкіндіктері — қоңырау аудиосын жергілікті келісім/сақтау ережелеріңізге сай өңдеңіз.
## Әрі қарай қайда
- Арна: [SIP](/kk/v1.0/channels/sip)
- [Сөйлеу кіріс/шығыс (STT/TTS)](/kk/v1.0/voice/stt-tts)
- [Орнату және жаңартулар](/kk/v1.0/marketplace/install-updates)