AiHummer
ქართული
შესვლაპირადი კაბინეტი
v1.0.x
{ }Swagger

SIP ხმის კავშირის პლაგინი

v1.0.x · განახლდა 2026-07-05

SIP Voice აყენებს თქვენს აგენტს ტელეფონზე. ის პასუხობს და ახორციელებს რეალურ ზარებს ნებისმიერი სტანდარტული SIP-ტრანკის საშუალებით, ატარებს ცოცხალ ხმოვან კომუნიკაციას ზარის დროს და გთავაზობთ ჩანაწერს და მოკლე მიმოხილვას ზარის დასრულების შემდეგ, როდესაც ზარი სრულდება. ეს ნეიტრალური ოპერატორის მიმართ: ის იყენებს ჩვეულებრივ SIP-ს, ამიტომ არ არის ოპერატორთან დაკავშირებული — გადაამისამართეთ იგი ნებისმიერ ტრანკზე, რომელსაც თქვენი სატელეფონო პროვაიდერი უზრუნველყოფს.

პლაგინი მუშაობს მასპინძლის ადგილობრივ პლატფორმაზე და აერთიანებს ერთმანეთს baresip (SIP/RTP-ტერმინალი), ერთი ALSA უკუკავშირის წრე აუდიო გზა და პატარა Python ხიდი, რომელიც გადატანს აუდიოს ზარისა და გეითვეის ხმოვან ნაკადს შორის. იგი ურთიერთობს გეითვეის საშუალებით aihummer.service.v1 კონტრაქტი. საბოლოო მომხმარებლის ქცევა არხზე განთავსებულია არხის გვერდზე სიპ; ეს გვერდი ეხება თავად პლაგინს.

ფაქტები

ხელი მნიშვნელობა
ვერსია 25.1.0
ჯანმრთელობის პორტი 8830
SIP მოსმენა 5062
baresip-ის მართვა 4444
გადაწვის დრო baresip + ALSA loopback + Python ხიდი, მასპინძელი-ნატიური

რა არის ეს

ხიდი სატელეფონო ზარსა და AiHummer-ის მოძრაობას შორის. როდესაც ზარი დაკავშირებულია, აუდიო გადაეცემა baresip ALSA loopback-ის მეშვეობით Python-მოსახსრე ხიდი, რომელიც მუშაობს ხრიკი-ტექსტში → აგენტის მოძრაობა → ტექსტი-მუყველ ციკლი და პასუხს ბრუნდებს ზარს. ხელმისაწვდომია ორი ხმოვანი ძრავა:

  • yandex — რეალურ დროში ხმოვანი ტექსტის ამოცნობის ღრუბლოვანი ძრავა.
  • local — სრულიად ავტონომიური, იყენებს faster-whisper STT-ისთვის და edge-tts ხმოვანი სინთეზისთვის.

როგორ გამოიყენება ეს

ზარის დროს აგენტი შეიძლება გააკეთოს მეტი, ვიდრე უბრალოდ საუბარი:

  • ask_assistant — გამოაგზავნოთ აგენტი ზარისთვის, რათა უპასუხოთabonentს.
  • send_dtmf — გამოსხივება DTMF-ტონები (მაგალითად, IVR-ში ნავიგაციისთვის ან კოდის შეყვანისთვის).
  • ჩანაწერი — ჩანაწერინი ზარის აუდიო.
  • გადავლა — დაუშვით გამტაცებელს ბუნებრივად შეაწყვეტინოს აგენტისა სიტყვა.
  • ზარის შემდეგი შეჯამება — შედგინეთ ანგარიში ზარის დასრულების შემდეგ.
caller ─▶ SIP trunk ─▶ baresip ─▶ ALSA loopback ─▶ bridge ─▶ STT ─▶ agent turn ─▶ TTS ─▶ caller

ფუნქციის ველი

[!WARNING] SIP დანამატი მხარს უჭერს STT, TTS, შეწყვეტა, DTMF და მხოლოდ ჩანაწერი. ეს ვეფობი არა ბეჭდვითი თარგმნის უზრუნველყოფა — ეს წარმოადგენს ცალკე ძირითად ფუნქციას (იხ. ლექციის და ვიდეოს თარგმანი) და ის არ წარმოადგენს SIP ზარის გზის ნაწილს. მისი გამოყენება სატელეფონო ზარზე არ არის გათვალისწინებული.

დაყენება

დაინსტალირეთ SIP Voice ერთ კლიკზე მარკეტფლეისიდან ადმინისტრაციული ინტერფეისის გავლით. მასპინძელში ჩაშენებული დამგზავნი იტვირთავს პლაგინს, აწარმოებს ინსტალაციის ნაბიჯს, ქმნის იზოლირებულ სისტემურ სერვისს systemd-ში და ელოდება ჯანმრთელობის Endpoint-ის პასუხს მონიშვნამდე. გზადაა — ნახე ინსტალაცია და განახლებები. შემდეგ თქვენ აკონფიგურირებთ SIP-ტრანკის ანაზღაურების მონაცემებს და არჩევთ yandex ან local ძრავა.

[!TIP] სრულიად ავტონომიური ინსტალაციისთვის, სარეიტინგო მოდელების გარეშე, აირჩიეთ local ძრავა: faster-whisper და edge-tts შეინახეთ მთელი ხმოვანი გზა თქვენს საკუთარ ჰოსტზე.

უსაფრთხოება და შეზღუდვები

  • ოპერატორ-ნეიტრალური მაგისტრალური არხი. სტანდარტული SIP-ტრანკი, ოპერატორთან მიბმვის გარეშე; გადაამოწმეთ კოდეკის, DTMF-ისა და მარშრუტიზაციის თავსებადობა.
  • სერვისის სფერა: STT/TTS/DTMF/ჩაწერა/შეტება. საუბრის თარგმანი არ არის გზის გამოძახება (ეს ძირითადი ფუნქციაა).
  • ადგილობრივი ჰოსტისთვის baresip, უკუკავშირის ხრახნი და ხიდი მიდიან under systemd, და არა კონტეინერში.
  • ჩანაწერში შეიცავს უხამს სიტყვებს. ჩანაწერი და სესიისშემდგომი ანგარიში ზარის ფუნქციებია თქვენ იძლევით ნებართვას — მოექცეს ზარის აუდიოს თქვენი ადგილობრივი შეთანხმებისა და მონაცემთა შენახვის წესების შესაბამისად.

სად შემდეგ?