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 |
Resminamalary dörediň (CSV / TSV / XLSX). | Önümlilikde açyk |
image_generate / edit_image |
Suratlary döretmek ýa-da redaktirlemek. | Önümlilikde açyk |
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. | Hemişe açyk. AIHUMMER_FS_ROOT ony açmaýar, diňe çäklendirilen giňişligi daraldýar: bahasy boş wagty kök tutuş serwerdir (/). |
[!DANGER] Näme bolar: agent derwezäniň hyzmat ulanyjysynyň okap bilýän islendik faýlyny okar — maglumatlar bazasyna birikme parametrleri bolan faýly we syrlar ammaryny şifrleýän açary hem goşmak bilen. Haýsy şertde:
AIHUMMER_FS_ROOTsazlamasy boş wagty. Bu öz serweriňize gurnalandan soňky adaty ýagdaýdyr. Nädip düzetmeli: Dolandyryş → Sazlamalar bölümini açyň,AIHUMMER_FS_ROOTaçaryny tapyň, agente hakykatdan gerek katalogy görkeziň (meselem/srv/agent-files) we ýatda saklaň. Baha maglumatlar bazasynda saklanýar — bu açar üçingateway.envsetiri äsgerilmeýär. Şeýle hemfilesystem_readadynyAIHUMMER_APPROVAL_TOOLSsanawyna ýazyň, şonda her çagyryş siziň tassyklamaňyza garaşar.AiHummer-iň dolandyrylýan bulutynda bu gural agente asla berilmeýär — köki diňe öz gurnamaňyzda daraltmaly.
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_exec-dir paýlaşylan myhmançylyklarda standart bozuldy. Munuňy diňe bir wagtda açyň önümi öňünden ýazylan kody işledýän, size dolandyryp we ynanyp bolýan gurşaw. sandbox edilip, ony aýratyn hukukly bir mümkinçilik hökmünde hasapla.
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_execHowada 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.