Gural katalogy
Öwrüliň dowamynda agent jaň edip biler gural. AiHummer gurnalan gural işjeňleýin işleýji görnüşini iberýär: käbir gurallar özi bilen özi işläp başlaýar, beýlekiler diňe gerekli sazlamany berende işjeňleşýär. Gurallar SSRF-den goralýar we degişli ýagdaýlarda izolýasiýa edilýär, howply gurallar adam tassyklamagynyň yzyna goýulyp bilner.
Önümlilikde işjeňleşdirilen
Bu guralar çykarylyşa taýýardyr (käbirleri sazlanan model ýa-da bilim bazasyna baglydyr).
| Gural | Ol näme edýär | Nädip işjeňleşdirmeli |
|---|---|---|
web_fetch |
Bir URL-niň mazmunyny alyň. SSRF-den goraýar. | Önümlilikde açyk |
http_request |
Çykyş HTTP haýyşyny ýerine ýetiriň. SSRF goragly. | Önümlilikde açyk |
web_search |
Gurlan SearXNG arkaly webde gözleg ediň. | Önümlilikde açyk (gurnaýjy bilen bilelikde gelýär); --no-search bilen öçüriň |
browser / computer |
Hakyky brauzeri Chrome DevTools Protocol arkaly ider. | Önümlilikde açyk (gurnaýjy bilen bilelikde gelýär); --no-browser bilen öçüriň |
memory_store |
Fakty uzak möhletli ýatda sakla (Einstein). auto (standart) toplamak režiminde fakt derrew gözlenip bilinýär; review/off bilen ol tassyklama garaşýan dalaşgär bolýar. Netije searchable_now meýdanyny göterýär. |
Önümlilikde açyk |
memory_search |
Uzak möhletli ýatda gözleg ediň (Einstein). | Önümlilikde açyk |
doc_generate |
CSV / TSV / XLSX ýa-da HTML resminamasyny döretmek. | Önümlilikde açyk |
image_generate / edit_image |
Suratlary döretmek ýa-da redaktirlemek. | Sazlanan şekil ýerine ýetirijisi gerek; redaktirlemek üçin ol bu amaly hem goldamalydyr. |
github_get_file |
GitHub saklaýyşlaryndan bir faýly alyň. | Önümlilikde açyk |
generate_pairing_code |
Enjam baglaşyk kody beriň. | Önümlilikde açyk |
search_knowledge |
Bilim binýasyny (RAG) gözläň we jogaplary sitatalar bilen esaslandyryň. | Bilelikde bilimiň binýady bilen düzülip görkezilen |
deep_research |
Köp basgançakly gözleg geçirip, sitat berlen hasabat düz. | Önümlilikde açyk |
docs_search |
Gözle bu dokumentasiýanyň oflaýn nusgasy (a docs.aihummer.ru öň görkezilen snapshot çykýandygy bilen, share/docs, ru/en) — agent internet bolmazdan haryt barada soraglara jogap berip biler. |
Resminamalaryň skanşoty bilen öňünden bar (standart gurnama) |
docs_read |
Üstünden tapylan doly resminama sahypasyny okap bilersiňiz docs_search. |
Resminamalaryň skanşoty bilen öňünden bar (standart gurnama) |
filesystem_read |
Serweriň diskindäki faýly okaýar ýa-da katalogyň mazmunyny görkezýär. | Adaty ýagdaýda agentiň öz iş bukjasy; hosta giriş üçin eýesi şu agentiň izolýasiýa tertibini açyk saýlamalydyr. Dolandyrylýan bulutda we demoda elýeterli däl. |
[!NOTE]
AIHUMMER_FS_ROOTrugsat berlen köki goşmaça daraldýar; boş baha tutuş serwere giriş bermeýär. Gurnamanyň sazlamalary, maglumat bazasyna giriş maglumatlary we şifrleme açarlary, şeýle hem prosesleriň gurşawy okalmaýar. Tassyklama rugsat berlen faýl çägini giňeltmeýär.
Konfigurasiýada işjeňleşdir
Bu gurallar gerek bolan çeşmäni görkezýänçä öçük bolýar. Ähli işjeňleşdiriji düwmeler (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) …dyr Sazlamalar-katalog açarlar: olary web administratori UI-de goýuň (Dolandyryş → Sazlamalar, gözleg bilen) ýa-da bilen aihummer settings set <KEY> <VALUE>. Olaryň içine goýmak gateway.env bar tä’sir ýok — bu açarlar üçin daşky gurşaw görmezlikden gelinýär.
| Gural | Ol näme edýär | Nädip işjeňleşdirmeli |
|---|---|---|
db_query |
Diňe okamak üçin SQL soraglaryny işlet. | AIHUMMER_DB_QUERY_DSN |
mail |
Email iberiň we okaň. | SMTP / IMAP şahsyň maglumatlary |
tts |
Sözleri ýygnamak (text-den-sese). | AIHUMMER_TTS_URL (TTS goşmaça program) |
code_exec |
Kod sanykxona içinde ýerine ýetiriň. | AIHUMMER_CODE_EXEC |
[!DANGER]
code_execadaty ýagdaýda öçürilen. Ony diňe özüňiziň dolandyrýan we ynanýan gurşawyňyzda açyň: ol modeliň ýazan koduny ýerine ýetirýär we izolirlenen gurşawda hem ýokary hukukly mümkinçilik bolup galýar.
Integrasiýa gurallary
Görüňen baglanyşyk sazlanan ýagdaýynda, agent hem domén gurallaryny alýar:
| Gural | Ol näme edýär | Nädip işjeňleşdirmeli |
|---|---|---|
| Bitrix24 CRM / wezipeler / öňündäki meýilnamalar guraly | Bitrix24 CRM ýazgylaryny, wezipelerini we senenamalaryny okaň we olara hereket ediň. | Bitrix24 baglanyşygy sazlandy |
| 1C (BIT.FINANS OData) | БИТ.ФИНАНС OData interfeýsi arkaly 1C hasapçylyk maglumatlaryny soramak. | 1C OData baglanyşygy sazlandy |
Tassyklama gapy
Her haýsydyr bir gurwal biriniň yzyna goýup bilner adam-aralygyndaky tassyklama gapysy. Gurallaryň atlaryny sanan lista AIHUMMER_APPROVAL_TOOLS saýlama (web administratoryň ulanyjy interfeýsi: Dolandyryş → Saýlamalar); şeýle gural işlemeýändigi bilen, işgäriň çagyryşy tassyklamasy gerek. Reddedilen çagyryş däk berra edilen.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
Howada aralyk režimi
Ýatyryň AIHUMMER_AIRGAPPED saýlamak 1 model tarapyndan dolandyrylýan jemgyýetçilik çykalga ýapmak üçin. Bu ulgamda agent gurallar arkaly açyk internetiň elýeterine baryp bilmeýär, bu bolsa suveren ýa-da izolýasiýa edilen ýerleşdirişler üçin laýykdyr.
aihummer settings set AIHUMMER_AIRGAPPED 1
[!NOTE] Döredilen katalogdan başga, AiHummer islendik OpenAPI 3.x-den enjamlar sintez edip biler html beýanyny görkezmek we hiç hili birleşdiriş kody bolmazdan haýsydyr bir MCP serveriniň enjamlaryny açmak. Görüň Hujjatlaryň Marketplace we Pluginler bölümi.
Indi nire?
- Bu ýerde doly agzalan üýtgeýänler: Çevre üýtgeýjileri.
- Işleýän nusgany dolandyrmak: CLI salgysy.
HTML resminamalary
Agent doc_generate we format: "html" arkaly 4 MiB çenli UTF-8 HTML goşundysyny döredýär. CSS we JavaScript saklanýar. Gabat gelýän täzelenen programma çeşmäni we bitewüligi barlap, saklanan faýly aýratyn deslapky görnüşde açýar. Programmanyň giriş maglumatlary geçirilmeýär; faýl, çeşme ýa-da sessiýa üýtgese, deslapky görnüş güýjüni ýitirýär.