SIP Voice плагини

v1.0.x · жаңыланды 2026-06-26

SIP Voice сиздин агентиңизди телефонго коет. Ал каалаган стандарттык SIP транк аркылуу реалдуу чалууларды кабыл алат жана чалат, чалуу учурунда жандуу кеп turn’ун иштетет жана чалуу аяктаганда сизге жазууну жана чалуудан кийинки корутундуну берет. Ал оператор-нейтралдуу: ал жөнөкөй SIP’те сүйлөйт, ошондуктан оператор кулчулугу жок — аны телефония провайдериңиз берген каалаган транкка багыттаңыз.

Плагин хост-нативдик иштейт жана baresip (SIP/RTP эндпоинти), ALSA loopback аудио жолу жана чалуу менен gateway’дин үн turn’у ортосунда аудио жылдырган кичинекей Python көпүрөсүн бириктирет. Ал gateway менен контракт аркылуу сүйлөшөт. Акыркы колдонуучу каналынын жүрүм-туруму канал бетинде SIP; бул бет плагиндин өзүн камтыйт.

Фактылар

Талаа	Маани
Версия	25.1.0
Health порту	8830
SIP угуу	5062
baresip башкаруу	4444
Runtime	baresip + ALSA loopback + Python көпүрө, host-native

Бул эмне

Телефон чалуусу менен AiHummer turn’у ортосундагы көпүрө. Чалуу туташканда аудио baresip’тен ALSA loopback аркылуу Python көпүрөсүнө агат, ал кептен-текст → агент turn → тексттен-кеп циклин иштетет жана жоопту чалууга кайра ойнотот. Эки кеп кыймылдаткычы жеткиликтүү:

yandex — реалдуу убакыттагы булут кеп кыймылдаткычы.
local — толугу менен өзүн-өзү хосттогон, STT үчүн faster-whisper жана TTS үчүн edge-tts колдонгон.

Кантип колдонулат

Чалуу учурунда агент жөн гана сүйлөбөстөн көбүрөөк нерсе кыла алат:

ask_assistant — чалуучуга жооп берүү үчүн чалуу учурундагы агент turn’ун иштетет.
send_dtmf — DTMF тондорун чыгарат (мисалы, IVR’да навигация кылуу же код киргизүү үчүн).
жазуу — чалуу аудиосун тартып алат.
barge-in — чалуучуга агенттин сөзүн табигый түрдө бөлүүгө мүмкүндүк берет.
чалуудан кийинки корутунду — чалуу аяктагандан кийин корутунду чыгарат.

caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller

Мүмкүнчүлүктөрдүн чөйрөсү

[!WARNING] SIP плагини STT, TTS, barge-in, DTMF жана жазууну гана колдойт. Ал спикер диаризациясын, кеп котормосун же үн клондоону бербейт. Булар өзүнчө ядро/sidecar мүмкүнчүлүктөрү (караңыз Диаризация, котормо жана клондоо) жана SIP чалуу жолунун бөлүгү эмес. Аларды телефон чалуусунда болот деп ойлобоңуз.

Орнотуу

SIP Voice’ту admin UI’дагы маркетплейстен бир чыкылдатуу менен орнотуңуз. Хост-нативдик деплойер плагинди жүктөп алат, анын орнотуу кадамын аткарат, sandbox’толгон systemd бирдигин рендерлейт жана даяр деп белгилөөдөн мурда ден соолук эндпоинтин күтөт — Орнотуу жана жаңылоолор бөлүмүн караңыз. Андан кийин SIP транк эсептик дайындарыңызды конфигурациялап, yandex же local кыймылдаткычын тандайсыз.

[!TIP] Толугу менен өзүн-өзү хосттогон, акылуу-моделдер жок орнотуу үчүн local кыймылдаткычын тандаңыз: faster-whisper жана edge-tts бүт үн жолун өз хостуңузда сактайт.

Коопсуздук жана чектөөлөр

Оператор-нейтралдуу транк. Стандарттык SIP, оператор кулчулугу жок.
Чөйрө — STT/TTS/DTMF/жазуу/barge-in. Чалуу жолунда диаризация, котормо же үн клону жок.
Хост-нативдик. baresip, loopback жана көпүрө контейнерде эмес, systemd астында иштейт.
Жазуу — ачык. Жазуу жана чалуудан кийинки корутундулар — сиз иштеткен чалуу мүмкүнчүлүктөрү — чалуу аудиосун жергиликтүү макулдук/сактоо эрежелериңизге ылайык иштетиңиз.