Vositalar — AiHummer Hujjatlar

Vositalar — bu agentning dunyoga taʼsir qilish usuli — sahifani olib kelish, qidirish, pochta yuborish, maʼlumotlar bazasini soʻrash, hujjat yaratish. AiHummer boy oʻrnatilgan katalog va Tool Runtime bilan keladi, u vositalarni sozlanganda yoqadi, ularni qayta ishga tushirmasdan qayta yuklaydi, xavfli vositalarni inson tasdigʻi ortida toʻsadi va havodan-ajratilgan rejimda chiquvchi trafikni butunlay qulflashi mumkin.

Bu sahifa runtime qanday ishlashini koʻrib chiqadi va oʻrnatilganlarni roʻyxatlaydi. Toʻliq maʼlumotnoma uchun vositalar katalogi sahifasiga qarang.

Tool Runtime qanday ishlaydi

Sozlamada-yoqish. Vosita faqat uning zaruriy konfiguratsiyasi mavjud boʻlganda — odatda kerakli xizmatga yoʻnaltiruvchi muhit oʻzgaruvchisi — mavjud boʻladi. Sozlama yoʻq, vosita yoʻq.
Qaynoq qayta yuklash. Vositani yoqish qaynoq qoʻllaniladi, gatewayni qayta ishga tushirmasdan, shu bois siz qobiliyatlarni ish vaqtida yoqishingiz va oʻchirishingiz mumkin.
Tasdiqlash darvozasi. Xavfli vositalar AIHUMMER_APPROVAL_TOOLS orqali jarayonda-inson tasdiqlash darvozasi ortiga qoʻyilishi mumkin. Rad etilgan chaqiruv bajarilmaydi.
Havodan-ajratilgan rejim. AIHUMMER_AIRGAPPED=1 oʻrnatish model tomonidan boshqariladigan ommaviy chiquvchi trafikni bloklaydi, suveren yoki izolyatsiya qilingan joylashtirishlar uchun.

[!WARNING] code_exec umumiy xostlarda standart boʻyicha oʻchiq. Uni faqat sandbox va xost model tomonidan yozilgan kodni ishga tushirish uchun maqbul boʻlgan joyda yoqing va uni tasdiqlash darvozasi ortiga qoʻyishni koʻrib chiqing.

Oʻrnatilgan vositalar

Vosita	Nima qiladi	Bilan yoqiladi
`web_fetch`	URL ni olib keladi (SSRF-himoyali)	standart boʻyicha yoqilgan
`http_request`	HTTP soʻrov yuboradi (SSRF-himoyali)	standart boʻyicha yoqilgan
`web_search`	SearXNG orqali veb qidiruv	`SEARXNG_URL`
`browser`	CDP orqali haqiqiy brauzerni boshqarish	`CLOAKBROWSER_CDP_URL`
`computer`	CDP orqali kompyuterdan-foydalanish	`CLOAKBROWSER_CDP_URL`
`filesystem_read`	Sandbox ildizdagi fayllarni oʻqish	`AIHUMMER_FS_ROOT`
`db_query`	Faqat-oʻqish uchun maʼlumotlar bazasi soʻrovi	`AIHUMMER_DB_QUERY_DSN`
`mail`	Pochta yuborish/qabul qilish (SMTP/IMAP)	pochta hisob maʼlumotlari (vault)
`code_exec`	Sandboxda kod ishga tushirish (umumiy xostlarda standart boʻyicha oʻchiq)	`AIHUMMER_CODE_EXEC`
`doc_generate`	CSV/TSV/XLSX hujjatlar yaratish	standart boʻyicha yoqilgan
`tts`	Matndan-nutqqa	TTS sidecar
`image_generate` / `edit_image`	Tasvirlar yaratish va tahrir qilish	sozlangan tasvir backendi
`github_get_file`	GitHub dan faylni olib kelish	standart boʻyicha yoqilgan
`generate_pairing_code`	Qurilma juftlash kodini berish	standart boʻyicha yoqilgan
`search_knowledge` / `deep_research`	Bilim olib kelish va koʻp bosqichli tadqiqot	bilim bazasi
Bitrix24 CRM / vazifa / kalendar	Bitrix24 CRM, vazifa va kalendar amallari	Bitrix24 plagini
1C (БИТ.ФИНАНС OData)	OData orqali 1C БИТ.ФИНАНС kirishi	1C OData sozlamasi

[!NOTE] web_fetch va http_request SSRF-himoyali — ular ichki manzillarga va boshqa xavfli nishonlarga soʻrovlarni rad etadi, shu bois model ulardan shaxsiy tarmogʻingizga yetib borish uchun foydalana olmaydi.

Umumiy koʻnikmalar

Koʻnikma — bu agentlarga ulash mumkin boʻlgan qayta ishlatiladigan yoʻriqnoma (prompt parchasi). Kutubxona admin UI’ning «Umumiy koʻnikmalar» sahifasida yashaydi: yaratish uchun nom va matn kifoya — identifikator (slug) avtomatik hosil qilinadi. Vendor tomonidan yetkaziladigan koʻnikmalar «Quticha tashqarisida» nishoni bilan belgilangan; ularni oʻchirib qoʻyish mumkin, lekin ular roʻyxatda qoladi. Ulangan koʻnikmalar agent tizim promptining barqaror prefiksiga render qilinadi.

Vositalarni yoqish

Koʻpgina vositalar ularning konfiguratsiyasini taqdim etganingizda yoqiladi. Keng tarqalgan kalitlar:

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] Yon taʼsiri boʻlgan har qanday narsa — pochta yuborish, kod ishga tushirish — uchun tasdiqlashni talab qilish uchun AIHUMMER_APPROVAL_TOOLSdan foydalaning, faqat-oʻqish vositalarini esa toʻsiqsiz qoldiring.

Keyin qayerga

Har bir vosita boʻyicha toʻliq maʼlumotnomani vositalar katalogi sahifasida koʻring.
Bu vositalarni chaqiradigan tsiklni Orkestratsiya va sub-agentlar sahifasida tushuning.
Vosita javoblarini hujjatlaringizga asoslang: Bilim / RAG.