AiHummer
Кыргызча▾
Кирүү
v1.0.x▾
v1.0.xstable
{ }Swagger
Каналдар/Веб-виджет

Веб-виджет

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

Веб-виджет AiHummer агентин сиздин веб-сайтыңызга киргизилүүчү маек ишке киргизгичи катары коёт. Келүүчүлөр көбүкчөнү басат, терет, жана ар бир башка каналды кубаттаган ошол эле кезек кыймылдаткычынан жоопторду артка агылтат.

Виджетти шлюздун өзү /widget/ жолунда тейлейт, ошондуктан иштете турган өзүнчө кызмат жок.

Киргизүү кантип иштейт

Виджет сиздин барактын өздүк стилдеринен жана скрипттеринен изоляцияланып турууга арналган үч катмарда жеткирилет:

  1. Барагыңызга таштай турган кичинекей <script> жүктөгүч.
  2. Shadow-root ишке киргизгич — маек көбүкчөсү жана панели Shadow DOM ичинде рендерленет, ошондуктан сиздин CSS’иңиз жана виджеттин CSS’и эч качан чабышпайт.
  3. Чыныгы маек бетин жайгаштырган бир-теги бар (same-origin) iframe.

Киргизүү үзүндүсү

Жүктөгүч скриптти агент жеткиликтүү болушун каалаган каалаган баракка кошуңуз, адатта жабылуучу </body> тегинин алдында:

<script
  src="https://your-aihummer-host/widget/loader.js"
  async>
</script>

Жүктөгүч агенттериңизди иштеткен ошол эле шлюздан тейленет, ошондуктан маек бети виджет ресурстары менен бир-теги бар (same-origin).

Виджеттин артындагы эндпоинттер

Виджет эки шлюз эндпоинти менен сүйлөшөт:

POST /v1/web/session
GET  /v1/web/stream
  • POST /v1/web/session веб-маек сессиясын ачат.
  • GET /v1/web/stream агенттин жообун Server-Sent Events (SSE) аркылуу артка агылтат, ошондуктан жооптор токен-токен менен пайда болот.

Конфигурация

Виджеттин туура тейлениши жана жөнөтүлүшү үчүн эки жөндөө орнотулушу керек:

  • AIHUMMER_WIDGET_DIR — шлюз /widget/ дарегинде тейлеген виджет ресурстарынын каталогу.
  • AIHUMMER_DEFAULT_WORKSPACE_ID — кирүүчү веб-сессиялар жөнөтүлүүчү демейки жумушчу мейкиндик.

[!NOTE] Виджетти шлюз /widget/ дарегинде тейлейт; ал үчүн өзүнчө процесс жайылтпайсыз. Шлюздун калган бөлүгүнө кылгандай эле, TLS’ти реверс-проксиңизде аяктаңыз.

Андан ары кайда