Gurallar — AiHummer Resminamalar

Gurallar — agentiň dünýä täsir edýän usulydyr — sahypa almak, gözlemek, poçta ibermek, maglumat binýadyny soramak, resminama döretmek. AiHummer baý içki katalogy we tabşyrylan wagtynda gurallary işledýän, olary täzeden başlaman täzeden ýükleýän, töwekgelçiliklileri adam tassyklamasynyň aňyrsynda goýýan we howa-bölekli režimde çykyşy doly gulplap bilýän Gural Çalşygy (Tool Runtime) hödürleýär.

Bu sahypa çalşygyň nähili işleýändigini açyp görkezýär we içki gurallary sanaýar. Doly salgylanma üçin serediň gurallar katalogy.

Gural Çalşygy nähili işleýär

Sazlamada-işletmek. Gural diňe onuň öňünden talap edilýän konfigurasiýasy bar bolanda elýeterli bolýar — adatdan oňa gerek hyzmaty görkezýän gurşaw üýtgeýjisi. Konfigurasiýa ýok, gural ýok.
Gyzgyn täzeden ýükleme. Gurallaryň işledilmegi gateway-i täzeden başlaman gyzgyn ulanylýar, şeýlelikde siz mümkinçilikleri iş wagtynda açyp we öçürip bilersiňiz.
Tassyklama derwezesi. Töwekgelçilikli gurallar AIHUMMER_APPROVAL_TOOLS arkaly sikldäki-adam tassyklama derwezesiniň aňyrsynda goýlup bilner. Ret edilen çagyryş ýerine ýetirilmeýär.
Howa-bölekli režim. AIHUMMER_AIRGAPPED=1 bellemek model tarapyndan dolandyrylýan jemgyýetçilik çykyşyny bloklaýar, özbaşdak ýa-da izolirlenen ýerleşdirmeler üçin.

[!WARNING] code_exec umumy hostlarda adatdan öçükdir. Ony diňe sandbox we host model tarapyndan ýazylan kody işletmek üçin kabul ediläýin ýerlerde işlediň we ony tassyklama derwezesiniň aňyrsynda goýmagy göz öňünde tutuň.

Içki gurallar

Gural	Näme edýär	Şu bilen işlediň
`web_fetch`	URL almak (SSRF-goragly)	adatdan açyk
`http_request`	HTTP haýyşy etmek (SSRF-goragly)	adatdan açyk
`web_search`	SearXNG arkaly web gözleg	`SEARXNG_URL`
`browser`	CDP üsti bilen hakyky brauzeri işletmek	`CLOAKBROWSER_CDP_URL`
`computer`	CDP üsti bilen kompýuter ulanmak	`CLOAKBROWSER_CDP_URL`
`filesystem_read`	Sandbox-laşdyrylan kökde faýllary okamak	`AIHUMMER_FS_ROOT`
`db_query`	Diňe-okalýan maglumat binýady soragy	`AIHUMMER_DB_QUERY_DSN`
`mail`	Poçta ibermek/almak (SMTP/IMAP)	poçta kepillendiriş maglumatlary (gazna)
`code_exec`	Sandboxda kod işletmek (umumy hostlarda adatdan öçük)	`AIHUMMER_CODE_EXEC`
`doc_generate`	CSV/TSV/XLSX resminamalary döretmek	adatdan açyk
`tts`	Tekstden-söze	TTS sidecar
`image_generate` / `edit_image`	Suratlary döretmek we redaktirlemek	sazlanan surat backend
`github_get_file`	GitHub-dan faýl almak	adatdan açyk
`generate_pairing_code`	Enjam jübütleşdiriş koduny bermek	adatdan açyk
`search_knowledge` / `deep_research`	Bilim alyş we köp basgançakly barlag	bilim binýady
Bitrix24 CRM / task / calendar	Bitrix24 CRM, task we calendar hereketleri	Bitrix24 plagini
1C (БИТ.ФИНАНС OData)	OData üsti bilen 1C БИТ.ФИНАНС girişi	1C OData konfigurasiýasy

[!NOTE] web_fetch we http_request SSRF-goragly — olar içerki salgylara we beýleki howpsuz däl maksatlara haýyşlary ret edýär, şeýlelikde model olary siziň hususy ulgamyňyza ýetmek üçin ulanyp bilmez.

Gurallary işletmek

Gurallaryň köpüsi siz olaryň konfigurasiýasyny berseňiz açylýar. Umumy düwmeler:

SEARXNG_URL=http://localhost:8888          # web_search
CLOAKBROWSER_CDP_URL=http://localhost:9222 # browser + computer
AIHUMMER_FS_ROOT=/srv/agent-files          # filesystem_read (sandboxed root)
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] Tarapyn täsiri bolan islendik zat üçin — poçta ibermek, kod işletmek — tassyklamany talap etmek üçin AIHUMMER_APPROVAL_TOOLS ulanyň, diňe-okalýan gurallary derwezesiz galdyryň.

Indiki nirede

Doly her-gural salgylanmasyny görüň gurallar katalogy.
Bu gurallary çagyrýan sikle düşüniň Orkestrasiýa we sub-agentler.
Gural jogaplaryny resminamalaryňyzda esaslandyryň Bilim / RAG.