Бакавыя калёсы

# 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

Некаторыя магчымасці — прамова, відэа, вэб-пошук, headless-браўзэр — не ўваходзяць у склад самага шлюзу. Яны працуюць як **бокавыя калёсы**невялікія, незалежныя HTTP-сэрвісы, да якіх мае доступ шлюз **па URL**. Кожны багажнік матацыкла **бясплатна і мясцовы**: за імі няма абавязковага платнага API. ## Што такое сайдкэр Сайдкар — гэта асобны працэс, які адкрывае HTTP API. Шлюз ніколі не інтэгруе яго ў сябе і не запускае ў сваім працэсе — ён проста выклікае URL, які вы наладжваеце. Кожны сайдкар - бяжыць пад **свой уласны модуль systemd** (хаст-родны, без кантэйнераў) - падключаны да шлюза праз пераменную асяроддзя, і - можа быць **ўсталяваны непасрэдна побач з шлюзам або накіраваны на ўжо існуючы прыклад** ты ўжо пабег кудысьці яшчэ Паколькі кантракт выкарыстоўвае толькі HTTP, тая ж канфігурацыя працуе незалежна ад таго, усталяваны Sidecar ці не. `localhost` альбо на іншым гаспадары. > [!NOTE] > Бокавыя прычэпы з'яўляюцца неабавязковымі — з адным выключэннем: вэб-пошук > (SearXNG) і антыдэтэкт-браўзер (CloakBrowser) усталёўваюцца адразу з > каробкі. Іх кампаненты пастаўляюцца ўнутры падпісанага бандла ўсталёўшчыка > і ўсталёўваюцца афлайн. Выключыць іх можна сцягамі ўсталёўшчыка > `--no-search` і `--no-browser`. Любая іншая магчымасць актыўная толькі > тады, калі наладжаны яе URL; мінімальная ўстаноўка — па-ранейшаму толькі > шлюз плюс PostgreSQL. ## Бокавыя каляскі і іх парты | Порт | Сідкары | Падтрымліваецца | Улады | Злучаны з | |---|---|---|---|---| | 8001 | СТТ | хутчэй-шаптаць | маўленне ў тэкст | `AIHUMMER_STT_URL` | | 8002 | ТТS | edge-tts | тэкст-у-голас | `AIHUMMER_TTS_URL` | | 8005 | відэа | ffmpeg | разуменне відэа | `AIHUMMER_VIDEO_URL` | | 8888 | SearXNG | SearXNG | гэты `web_search` інструмент | ставіцца ўсталёўшчыкам, налада схаваная; знешні экзэмпляр — `--external-search=URL` | | 9222 | Chrome / 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) наладжваюцца для вас; вэб-пошук і браўзер падключае сам усталёўшчык — вы ніколі не задаяце іх адрасы, і яны не паказваюцца ў наладах; астатняе вы ўключаеце па меры неабходнасці. ```bash # 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`. ## Запуск іх на месцы або сумесна Кожны сайдкар працуе пад уласнай unit-сэрвісам systemd на хосце, таму яго можна кіраваць як любым іншым сэрвісам — запускаць, спыняць і чытаць журналы незалежна ад шлюзу. Калі вы ўжо запускаеце, скажам, SearXNG або кропку доступу Chrome/CDP, перадайце ўсталёўшчыку `--external-search=URL` або `--external-browser=URL`: лакальная копія не ставіцца, і шлюз выклікае ваш экзэмпляр. Для голасу і відэа накіруйце адпаведную наладу на існуючы экзэмпляр. У любым выпадку выгляд шлюзу аднолькавы: настроены URL, які ён можа выклікаць. > [!WARNING] > Гэта `browser` (CDP) і `web_search` інструменты звязваюцца з сеткай. У > Агляд узмоцненых або ізаляваных разгортванняў, якія правяраюць выхадныя злучэнні і ізаляваны рэжым > перш чым уключаць іх — шлюз выклікае толькі дапаўняльны сэрвіс, які вы падключылі. ## Куды далей - Як выкарыстоўваюцца голас і інструмент браўзера па чарзе: [Шлюз і паваротны рухавік](/be/v1.0/architecture/gateway-turn-engine). - Мінімальная жорсткая залежнасць (PostgreSQL) і ўсё астатняе па жаданні: [Шлюз і паваротны рухавік](/be/v1.0/architecture/gateway-turn-engine).