AiHummer
Türkmençe
Gir
v1.0.x
{ }Swagger

Çalt Başlangyç

v1.0.x · täzelendi 2026-07-07

Bu çalt başlangyç AiHummer-iň ilkinji işleýşini geçýär — gurnamadan kanalda jogap berýän ilkinji agente çenli. Her ädimiň doly jikme-jiklik bilen ýörite sahypasy bar, geçdigiňizçe baglanyşdyrylan.

AiHummer-i guruň

Gurnama şahsy kabinetiňizden başlanýar: my.aihummer.ru saýtynda hasaba alnyň, «Gurnama» ekranyny açyň we şahsy gurnama baglanyşygyňyzy alyň. Kabinet taýýar buýrugy görkezer — ony serwerde sudo bilen işlediň (root-suz gurnama hem goldanýar — serediň Gurnama):

curl -fsSL "<şahsy gurnama baglanyşygyňyz>" | sudo bash

Gurnaýjy arhitekturaňyzy ýüze çykarýar, gol çekilen bandly ýükleýär we barlaýar, gurnama köküni ýaýbaňlaýar we gateway hyzmatyny systemd astynda hasaba alýar. Doly jikme-jiklik üçin — şahsy baglanyşyk, reliz kanallary, sidecar-lary saýlamak, barlamak — Gurnama sahypasyna serediň.

PostgreSQL-e gönükdiriň

Ýeke-täk berk garaşlylyk pgcrypto giňeltmesi işjeňleşdirilen PostgreSQL. Gurnaýjy maglumat bazasy birikmesini awtomatiki birikdirýär. Eger maglumat bazasyny el bilen belleseňiz, AIHUMMER_DATABASE_URL konfigurasiýa opsiýasyny ulanyň:

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Maglumat bazasy migrasiýalary başlanyşda awtomatiki ulanylýar.

Admin UI-ni açyň

Hyzmat ýokary galandan soň, serwerdäki admin Web UI-ni açyň. Ol öz aýratyn hususy diňleýjisinde işleýär (default :8781, AIHUMMER_WEBUI_ADDR), kök ýolunda / hödürlenýär — köpçülik gateway portunda däl:

http://localhost:8781/

Boş maglumat bazasynda gateway admin girişini döredýär we bir gezeklik paroly ~/.aihummer/etc/initial-admin-password.txt-e ýazýar. Ony okaň, giriň, paroly derrew üýtgediň we faýly öçüriň — jikme-jiklik üçin serediň Ilkinji giriş.

Ilkinji kanalyňyzy birikdiriň

Admin UI-den habarlar AiHummer-e ýetip biler ýaly kanal goşuň:

  • Telegram — başlamak üçin iň önümçilige taýýar konnektor.
  • Web widjet — brauzerde ähli zady synamagyň iň çalt usuly.
  • MAX — rus messenjeri, şeýle hem elýeterli.

Ilkinji agentiňizi dörediň

Admin UI-de agent dörediň: oňa persona we isleg boýunça agent boýunça model beriň. Marşrutizator habarlary nirä ibermelidigini bilmegi üçin ony ýaňy goşan kanalyňyza («Channels» sahypasyndaky «Bindings» blogy) baglaň. Kanal arkaly habar iberiň we gezegiň başdan-aýak işleýşini synlaň.

Admin UI-den göni agent bilen gürleşiň

Ilkinji barlag üçin kanal hökmany däl: «Sessions» sahypasynda «+ Täze sessiýa» düwmesi agent bilen gürrüňdeşligi göni admin UI-de açýar. Ýazyjy faýl goşmaga mümkinçilik berýär (suratlar we resminamalar — model çykarylan teksti alýar), we tekstiň üstündäki iki geçiriji her gezek üçin bahany we gural çykyşyny görkezýär — agentiň her ädimde näme edendigini görmek üçin amatly.

[!TIP] AiHummer-i hiç hili kanalsyz onuň OpenAI-gabat gelýän API-si arkaly gönüden hem sürüp bilersiňiz:

POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}

SSE akymy üçin "stream": true belläň.

Mock modele üns beriň

Hakyky modeli birikdirýänçäňiz, jogaplar deterministik mock-dan gelýär — hiç hili model çykdajysy bolmazdan kanallary, marşrutlaşdyrmagy we agentleri barlamak üçin peýdaly.

[!NOTE] Hakyky model hiç haçan talap edilmeýär: AiHummer mugt/ýerli OpenAI-gabat gelýän nokatlarda we Codex/ChatGPT-abuna transportynda işleýär. Öz üpjünçiňizi (BYOK) birikdirmek üçin AIHUMMER_LLM_* konfigurasiýa opsiýalaryny belläň — bu isleg boýunça. Talaplara serediň.

Indiki nirä