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 шәреверс-проксиаҿ иаԥшәырха, агейту даҽа хәҭакгьы шәышабоу аиԥшҡ.

Аҩаҟа уаҳа