AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.3.x▾
v1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Esasy düşünjeler/Gural

Gural

v1.3.x · täzelendi 2026-09-15

Gural agentiň dünýä bilen nähili hereket edýändigini — sahypany almak, gözlemek, e-poçta ibermek, maglumatlar bazasyny soramak, resminama döretmek ýaly işleýär. AiHummer baý bir görnüşini hödürleýär gurlan katalog we bir Guralyň iş wagty bu gurallaryň sazlandyrylanynda işjeňleşmegine mümkinçilik berýär, olary täzeden başlamazdan ýükleýär, töwekgelçilikli gurallary adam tassygyndan soň açýar we howapsyz meýdança re mode-da çykşy doly baglap biler.

Bu sahypa iş wagtynyň nähili hereket edýändigini düşündirýär we gurnalan funksiýalary sanap geçýär. Doly salgyny görmek üçin şuňa serediň gurallar katalogy.

Guralyň iş wagty nähili hereket edýär

  • Konfigurasiýada ýalňyşlary işjeňleşdiriň. Bir gurallarň diňe onuň zerurlygy ýerine ýetirilende elýeterli bolýar daşky gurşawy üýtgeýjisi — adatça görkezýän konfigurasiýa bar Gerek hyzmat. Hiç hili sazlama, hiç hili gural gerek däl.
  • Iş wagty täzeden ýüklemek. Gurnagyň işjeňleşdirilmegi degişli bolýar ili, täzeden başlamadyk ýagdaýynda geçelge, şonuň üçin iş wagtynda mümkinçilikleri açyp-öçürip bilersiňiz.
  • Tassyklama gapysy. Tählikeli gurallar adam-aragatnaşykly ulgamdan yza goýulyp bilner tassyklama gapysy arkaly AIHUMMER_APPROVAL_TOOLS. Redd edilen jaň däk berra edilen.
  • Howa aralygyna bölünýän görnüş. Sazlama AIHUMMER_AIRGAPPED=1 bloklar model bilen dolandyrylýan şahsy ýa-da izolýasiýa edilen ýerleşdirişler üçin umumy çykmak.

[!WARNING] code_exec -dir standart boýyça öçürilen paýlaşylan hostinglerde. Muny diňe öňünde çalşanyňyzda işjeňleşdiriň sandbox we host model tarapyndan ýazylan kody işlemek üçin kabul ederlikli bolup durýar we göz öňünde tutuň ony tassyklama gapysynyň beýnisine goýmak.

Gurlan enjamlar

Gural Ol näme edýär Işjeňleşdir
web_fetch URL-ni almak (SSRF-howpsuzlyk bilen) standart boýyça açyk
http_request HTTP haýyşyny amala aşyrmak (SSRF-ä garşy goralan) standart boýyça açyk
web_search Gurlan SearXNG arkaly web gözleg standart boýyça açyk; gurnaýjynyň --no-search baýdagy bilen öçüriň
browser CDP üsti bilen hakyky brauzeri sürüň standart boýyça açyk; gurnaýjynyň --no-browser baýdagy bilen öçüriň
computer Kompýuter ulanylyşy boýunça CDP standart boýyça açyk; gurnaýjynyň --no-browser baýdagy bilen öçüriň
memory_store Fakty uzak möhletli ýatda sakla; auto (standart) toplamak režiminde ol derrew gözlenip bilinýär, review/off režimlerinde tassyklama garaşýan dalaşgär bolýar standart boýyça açyk
memory_search Uzak möhletli ýatda gözleg standart boýyça açyk
filesystem_read Serweriň diskindäki faýly okamak ýa-da katalog sanawy adatça açyk; AIHUMMER_FS_ROOT çäklendirilen giňişligi daraldýar, boş = tutuş serwer
db_query Diňe okamak üçin maglumat binýady soragy AIHUMMER_DB_QUERY_DSN
mail Hat ibermek/almak (SMTP/IMAP) poçta şahsy maglumatlary (sejil)
code_exec Kod çägeden çalıştır (paýlaşylan hostlarda öň bellenilen off) AIHUMMER_CODE_EXEC
doc_generate CSV/TSV/XLSX resminamalary dörediň standart boýyça açyk
tts Metni sesi öwürmek TTS ýany
image_generate / edit_image Suratlary döretmek we redaktirlemek saýlan surat arka plan ulgamy
github_get_file GitHub-dan faýl alyň standart boýyça açyk
generate_pairing_code Enjam birleşdiriş koduny çykaryň standart boýyça açyk
search_knowledge / deep_research Bilis alşymy we köptapgyrlaýyn gözleg bilim bazasy
Bitrix24 CRM / wezipesi / senenama Bitrix24 CRM, wezipeler we öňbellek ädimleri Bitrix24 goşundy
1C (BIT.FINANS OData) 1C BIT.FINANS OData arkaly girişi 1C OData sazlamasy

[!NOTE] web_fetch we http_request bar SSRF tarapyndan goralan — olar haýyşlara razy bolmaýarlar iňi salgylar we beýleki howply maksatlar, şonuň üçin model olar bilen ulanyp bilmez şahsy toruňyza ýetmek.

Hemişelik brauzer profili

Adaty ýagdaýda computer her sorag üçin arassa brauzer açýar. 1.3 wersiýasyndan gural aýdyň bellenen şahsy profili (cookie-ler we saýt sessiýalary) soraglaryň arasynda saklap bilýär — meselem, işgäriň her gezek täzeden girmän öz hasaplaryny alyp barmagy üçin. Profil hiç haçan model argumentlerindäki at ýa-da ýol boýunça saýlanmaýar — diňe operatoryň aýdyň baglamasy boýunça:

  • AIHUMMER_BROWSER_PROFILE_SOCKET — gurnalan brauzer hyzmatynyň şahsy managed-profiles.sock soketine absolýut ýol; boş (adaty) — hemişelik profiller öçük.
  • AIHUMMER_BROWSER_PROFILE_BINDINGS — baglamalaryň JSON massiwi: profile_id, tenant_id, user_id, agent_ids we conversation_ids (64-e çenli profil, her biriniň bir eýesi).

Profil diňe häzirki ulanyjy onuň eýesi bolanda we agent hem-de dialog baglamada sanalanda açylýar; dialog başga adam gatnaşyjylarsyz şahsy bolmaly. Eýe we hukuklar diňe ilkinji açylyşda däl, her hereketde barlanýar. Hemişelik profiller açyk wagty computer hereketleri diňe laýyk baglama bilen ýerine ýetirilýär. Brauzeriň aýdyň tor syýasaty gerek — kesgitlenen AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK (true ýa-da false) ýa-da AIHUMMER_BROWSER_ALLOWED_HOSTNAMES sanawy; daşky brauzeriň cookie-leri import edilmeýär. Iki sazlama-da howply hasaplanýar: dolandyrylýan bulutda we demo instansda olar gulplanan.

Ulgamlaýyn başarnyklar

A başarnyk agentlere birikdirip bolýan gaýtadan ulanylyp bilinýän görkezme (prompt bölegi) bolup durýar. Kitaphana administrasiýa interfeýsinde ýerleşýär “Bilelikde ulanylýan başarnyklary” sahypa: döretmek üçin bir ad we tekst ýeterlikdir — identifikator (slug) awtomatiki ýagdaýda emele gelýär. Satuwçy tarapyndan paket bilen berlen başarnyklar Sandyktan çykyp belligi; olar öçürilip bilner, ýöne sanawda galýar. Birikdirilen başarnyklary agentiň ulgam nyşanynyň durnukly öňki görnüşine geçiriler.

Guralary ýola goýmak

Köp gurallar, öňünden olaryň sazlamalary berleninde işleme başlaýar. Adatdaky suwihler:

AIHUMMER_FS_ROOT=/srv/agent-files          # filesystem_read çäklendirilen giňişligini DARALDÝAR (boş = tutuş serwer)
AIHUMMER_DB_QUERY_DSN=postgres://...        # db_query (read-only)
AIHUMMER_CODE_EXEC=1                         # code_exec (sandboxed)
AIHUMMER_APPROVAL_TOOLS=mail,code_exec       # require approval for these tools
AIHUMMER_AIRGAPPED=1                          # block model-controlled public egress

[!TIP] Ulanylýar AIHUMMER_APPROVAL_TOOLS deşine bir zadyň tassyklanmagyny talap etmek täsir — hat ibermek, kody işledýän — okamak üçin guralary açyk goýmak bilen.

Indi nire?