Gurallar katalogy

# /home/.aihummer/etc/gateway.env
AIHUMMER_APPROVAL_TOOLS=mail,code_exec

AIHUMMER_AIRGAPPED=1

Gezek wagtynda agent **gurallary** çagyryp bilýär. AiHummer içki gural ortasyny iberýär: käbir gurallar adaty boýunça açyk, beýlekiler diňe siz talap edilýän konfigurasiýany berseňiz işjeňleşýär. Gurallar SSRF-goralan we ähmiýetli ýerde sandbokslanan, we howply gurallar adam tassyklama germewiniň aňyrsynda goýlup bilner. ## Adaty boýunça işjeňleşdirilen Bu gurallar gutudan-daşary işleýär (käbiri düzülen modele ýa-da bilim bazasyna bagly). | Gural | Näme edýär | Nädip işjeňleşdirmeli | |---|---|---| | `web_fetch` | URL-iň mazmunyny almak. SSRF-goralan. | Adaty boýunça açyk | | `http_request` | Çykýan HTTP haýyşy etmek. SSRF-goralan. | Adaty boýunça açyk | | `doc_generate` | Resminamalary döretmek (CSV / TSV / XLSX). | Adaty boýunça açyk | | `image_generate` / `edit_image` | Suratlary döretmek ýa-da redaktirlemek. | Adaty boýunça açyk | | `github_get_file` | GitHub repozitoriýasyndan ýeke-täk faýly almak. | Adaty boýunça açyk | | `generate_pairing_code` | Enjam jübütleşdiriş kody çykarmak. | Adaty boýunça açyk | | `search_knowledge` | Bilim bazasynda gözlemek (RAG) we jogaplary sitatalar bilen esaslandyrmak. | Bilim bazasy düzülende | | `deep_research` | Köp-ädimli barlag işletmek we sitataly hasabat çykarmak. | Adaty boýunça açyk | ## Konfigurasiýada işjeňleşdirmeli Bu gurallar siz olary gerekli çeşmä ugrukdyrýançaňyz öçük galýar. | Gural | Näme edýär | Nädip işjeňleşdirmeli | |---|---|---| | `web_search` | Webde gözlemek. | `SEARXNG_URL` (SearXNG instansy) | | `browser` / `computer` | Chrome DevTools Protocol arkaly hakyky brauzeri sürmek. | `CLOAKBROWSER_CDP_URL` (CDP, adaty port `:9222`) | | `filesystem_read` | Kök katalogyň astynda sandbokslanan faýllary okamak. | `AIHUMMER_FS_ROOT` | | `db_query` | Diňe-okalýan SQL soraglaryny işletmek. | `AIHUMMER_DB_QUERY_DSN` | | `mail` | Email ibermek we okamak. | SMTP / IMAP kredensiallary | | `tts` | Söz sintezlemek (text-to-speech). | `AIHUMMER_TTS_URL` (TTS sidecar) | | `code_exec` | Sandboksda kod ýerine ýetirmek. | `AIHUMMER_CODE_EXEC` | > [!DANGER] > `code_exec` **paýlaşylan hostlarda adaty boýunça öçük**. Ony diňe öz > dolandyrýan we ynanýan gurşawyňyzda işjeňleşdiriň, sebäbi ol model-ýazan kody işledýär. Hatda > sandbokslananam bolsa, oňa artykmaçlykly ukyp hökmünde garaň. ## Integrasiýa gurallary Degişli birikme düzülende, agent şeýle hem domen gurallaryny alýar: | Gural | Näme edýär | Nädip işjeňleşdirmeli | |---|---|---| | Bitrix24 CRM / task / kalendar gurallary | Bitrix24 CRM ýazgylaryny, tabşyryklary we kalendary okamak we olar boýunça hereket etmek. | Bitrix24 birikmesi düzülen | | 1C (БИТ.ФИНАНС OData) | 1C buhgalter maglumatlaryny БИТ.ФИНАНС OData interfeýsi arkaly soramak. | 1C OData birikmesi düzülen | ## Tassyklama germewi Islendik gural **human-in-the-loop tassyklama germewiniň** aňyrsynda goýlup bilner. Gural atlaryny `AIHUMMER_APPROVAL_TOOLS`-da sanaň; şeýle gural işlemezden öň, operator çagyryşy tassyklamaly. Ret edilen çagyryş **ýerine ýetirilmeýär**. ```ini # /home/.aihummer/etc/gateway.env AIHUMMER_APPROVAL_TOOLS=mail,code_exec ``` ## Howa-aralykly режim Model-dolandyrylýan köpçülikleýin egress-i bloklamak üçin `AIHUMMER_AIRGAPPED=1` belläň. Bu режimde agent gurallar arkaly açyk internete ýetip bilmeýär, bu suweren ýa-da izolirlenen ýerleşdirişler üçin amatlydyr. ```ini AIHUMMER_AIRGAPPED=1 ``` > [!NOTE] > Içki kataloglardan başga-da, AiHummer islendik OpenAPI 3.x > spesifikasiýasyndan gurallary sintezläp bilýär we islendik MCP serweriniň gurallaryny integrasiýa kody bolmazdan > açyp bilýär. Dokumentleriň Marketpleýs & Pluginler bölümine serediň. ## Indiki nirä - Bu ýerde salgylanan üýtgeýjiler doly görnüşde: [Gurşaw üýtgeýjileri](/tk/v1.0/reference/env-vars). - Işleýän instansy dolandyrmak: [CLI salgylanmasy](/tk/v1.0/reference/cli).