გვერდის ეტლები
ზოგიერთი ფუნქცია — საუბარი, ვიდეო, ვებ-ძებნა, უსათაურო ბრაუზერი — თავად გეითვეის ნაწილი არ არის. ისინი მუშაობენ როგორც ბავშვთა ვაზნები: მცირე დამოუკიდებელი HTTP-სერვისები, რომელთაც მიმართავს გეითვეი URL-ის მიხედვით. თითოეული ეტლი უფასო და ადგილობრივი: მათთვის სავალდებულო გადახდილი API არ არსებობს.
რა არის მოტოციკლის ეტლი
საიდკარი — ეს არის დამოუკიდებელი პროცესი, რომელიც უზრუნველყოფს HTTP API-ს. გეითი არასდროს ათავსებს მას ან არ ესვრის პროცესში — ის უბრალოდ იძახებს URL-ს, რომელიც თქვენ გაწყეთ. თითოეული საიდკარი
- მუშაობს საკუთარ systemd unit-ში (ჰოსტზე, კონტეინერების გარეშე),
- გაერთიანებულია ჭიშკართან გარემოს ცვლის მეშვეობით, და
- შეიძლება გადმონტაჟებული ადგილობრივად გეიტვეის გვერდით ან აღინიშნული არსებული მიმართულებით მაგალითი თქვენ უკვე სხვაგან გარბიხართ.
ამიტომაც, როდესაც კონტრაქტი იყენებს მხოლოდ HTTP-ს, იგივე კონფიგურაცია მუშაობს, იყოს თუ არა საიდკარი ჩართული localhost ან სხვა მასპინძელზე.
[!NOTE] საიდკარები არასავალდებულოა — ერთი გამონაკლისით: ვებ-ძიება (SearXNG) და ანტიდეტექტ-ბრაუზერი (CloakBrowser) ყუთიდანვე დაყენებულია. მათი პაკეტები შედის ხელმოწერილ საინსტალაციო ბანდლში და ინსტალირდება ოფლაინ. მათი გამორთვა შესაძლებელია ინსტალატორის დროშებით
--no-searchდა--no-browser. ყველა სხვა ფუნქცია აქტიურია მხოლოდ მაშინ, როცა მისი URL კონფიგურირებულია; მინიმალური ინსტალაცია კვლავ მხოლოდ გეიტვეი პლუს PostgreSQL-ია.
სეიდკარები და მათი პორტები
| პორტი | საიქარი | მხარდაჭერილი | ძალა | გაერთიანებული |
|---|---|---|---|---|
| 8001 | STT | სწრაფად-ჩურჩული | მოლაპარაკება ტექსტში | AIHUMMER_STT_URL |
| 8002 | ტექსტიდან წაკითხვა | edge-tts | ტექსტი-მოვლენაში | AIHUMMER_TTS_URL |
| 8005 | ვიდეო | ფფმეპგ | ვიდეოს გაგება | AIHUMMER_VIDEO_URL |
| 8888 | SearXNG | SearXNG | ეს web_search ინსტრუმენტი |
აყენებს ინსტალატორი, პარამეტრი დამალულია; გარე ინსტანსი — --external-search=URL |
| 9222 | კრომი / CDP | ქრომი (CDP) | ეს browser ინსტრუმენტი |
აყენებს ინსტალატორი, პარამეტრი დამალულია; გარე ინსტანსი — --external-browser=URL |
ხმის საუდადო გვერდითი გზები — ეს მზად გზა არის: STT (:8001) აგენტს გადასცემს გამორთვას და TTS (:8002) პასუხობს როგორც უფასო, ასევე ადგილობრივ ძრავებზე. ვიდეოს გაგება (:8005) არის დამატებითი, მოთხოვნით დაკავშირებადი საიდკარი. SearXNG (:8888) ზურგი web_search, და საბოლოო წერტილი Chrome/CDP (:9222) მხარს უჭერს browser ობიექტი.
საიდკარის დაკავშირება
თქვენ მიმართავთ გეიტს თითოეულ საიდკარს შესაბამისთან კატალოგის კონფიგურაცია — ადმინისტრაციული ინტერფეისიდან (მართვა → პარამეტრები) ან ს aihummer settings set. gateway.env მომხმარებელია მხოლოდ bootstrap-ისთვის და უგულებელყოფილია ამ საკვანძო სიტყვებისთვის. მასპინძელზე ხმოვან გვერდის კომპონენტებს (STT/TTS) თქვენთვის ამზადებენ; ვებ-ძიებას და ბრაუზერს თავად ინსტალატორი აერთებს — მათ მისამართებს არასოდეს აყენებთ და ისინი პარამეტრებში არ ჩანს; დანარჩენს თქვენ ჩართავთ საჭიროების მიხედვით.
# Voice in/out (auto-configured by the installer for STT/TTS)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002
# Optional video sidecar
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005
[!TIP] რადგან ყველა საიდკარი უბრალოდ URL-ია, შეგიძლიათ ცენტრალიზება გაუკეთოთ მძიმე სერვისებს: მიმართეთ რამდენიმე გეიტვეი ერთ საერთო STT/TTS ინსტანსზე, ნაცვლად იმისა, რომ თითო ჰოსტზე ცალკე ასლი გაუშვათ; ძიებისა და ბრაუზერისთვის იმავეს აკეთებენ ინსტალატორის დროშები
--external-search=URLდა--external-browser=URL.
მოვმართოთ ისინი ნატიურად ან ერთად
ყოველი საიდკარი მუშაობს თავის საკუთარ systemd სისტემაზე ჰოსტზე, ამიტომ მას მართავთ როგორც ნებისმიერ სხვა სერვისს — ვიწყებთ, ვჩუმავთ და ვუყურებთ ჟურნალს შესასვლელი წარსულისგან დამოუკიდებლად. თუ თქვენ უკვე მართავთ, მაგალითად, SearXNG-ს ან Chrome/CDP-ის ბოლო წერტილს, გადაეცით ინსტალატორს --external-search=URL ან --external-browser=URL: ლოკალური ასლი არ დაყენდება და გეიტვეი თქვენს ინსტანსს გამოიძახებს. ხმისა და ვიდეოსთვის მიუთითეთ შესაბამისი პარამეტრი არსებულ ინსტანსზე. ნებისმიერ შემთხვევაში, გარდამტეხის ხილვა იდენტურია: დაყენებული URL, რომელსაც ის შეუძლია გამოძახება.
[!WARNING] ეს
browser(CDP) დაweb_searchინსტრუმენტები უკავშირდება ქსელს. ჩართულია მონაცემების გამომავალის და იზოლირებული გარემოს კონფიგურაციის მიმოხილვა დაცული ან იზოლირებული განლაგებისთვის სანამ მათ ჩართავთ — გადამრთველი იწვევს მხოლოდ გვერდით კონტეინერს, რომლოსაც დაუკავშირდით.
სად შემდეგ?
- როგორ გამოიყენება ხმისა და ბრაუზერის ინსტრუმენტი თამაშის პროცესში: გეითვეინი და შემობრუნებადი ძრავა.
- სუროგატულად აუცილებელი დამოკიდებულება (PostgreSQL) და რაც დარჩა სურვილისამებრ: გეითვეინი და შემობრუნებადი ძრავა.