Asboblar katalogi — AiHummer Hujjatlar

Burilish vaqtida agent qo’ng’iroq qilishi mumkin asboblar. AiHummer o‘rnatilgan vosita ish vaqti bilan birga jo‘natiladi: ba’zi vositalar sukut bo‘yicha yoqilgan bo‘lsa, boshqalari faqat zarur konfiguratsiyani ta’minlaganingizda ishga tushadi. Vositalar zaruratga qarab SSRF-dan himoyalangan va izolyatsiyalangan, xavfli vositalar esa insonning tasdiqi orqali ishlashi mumkin.

Standart bo’yicha yoqilgan

Bu vositalar darhol ishlaydi (ba’zilari sozlangan model yoki bilim bazasiga bog’liq).

Asbob	Nimani qiladi	Qanday yoqish
`web_fetch`	URL mazmunini oling. SSRF himoyalangan.	Standart bo’yicha yoqilgan
`http_request`	Chiqish HTTP so‘rovini yuboring. SSRF himoyalangan.	Standart bo’yicha yoqilgan
`web_search`	O‘rnatilgan SearXNG orqali vebda qidiring.	Standart bo’yicha yoqilgan (o‘rnatuvchi bilan birga keladi); o‘chirish uchun `--no-search`
`browser` / `computer`	Chrome DevTools protokoli orqali haqiqiy brauzerni boshqaring.	Standart bo’yicha yoqilgan (o‘rnatuvchi bilan birga keladi); o‘chirish uchun `--no-browser`
`memory_store`	Faktni uzoq muddatli xotiraga saqlash (Einstein). `auto` to‘plash rejimida (standart) fakt darhol qidiriladi; `review`/`off` da u tasdiqlashni kutayotgan nomzodga aylanadi. Natija `searchable_now` maydonini o‘z ichiga oladi.	Standart bo’yicha yoqilgan
`memory_search`	Uzoq muddatli xotirada qidirish (Einstein).	Standart bo’yicha yoqilgan
`doc_generate`	Hujjatlarni yaratish (CSV / TSV / XLSX).	Standart bo’yicha yoqilgan
`image_generate` / `edit_image`	Rasmlar yaratish yoki tahrirlash.	Standart bo’yicha yoqilgan
`github_get_file`	GitHub omboridan bitta faylni oling.	Standart bo’yicha yoqilgan
`generate_pairing_code`	Qurilma juftlashtirish kodini chiqarish.	Standart bo’yicha yoqilgan
`search_knowledge`	Bilim bazasini (RAG) qidiring va javoblarni manbalar bilan mustahkamlang.	Bilim bazasi sozlangan holda
`deep_research`	Ko‘p bosqichli tadqiqot o‘tkazing va iqtibos keltirilgan hisobot tayyorlang.	Standart bo’yicha yoqilgan
`docs_search`	Qidirish ushbu hujjatning oflayn nusxasi (docs.aihummer.ru snapshot chiqarishda jo’natiladi, `share/docs`, ru/en) — agent internetga ulanmasdan mahsulot savollariga javob bera oladi.	Hujjatlar skrinshoti mavjud bo‘lganda (standart o‘rnatish)
`docs_read`	Topilgan to‘liq hujjat sahifasini o‘qing `docs_search`.	Hujjatlar skrinshoti mavjud bo‘lganda (standart o‘rnatish)
`filesystem_read`	Server diskidagi faylni o’qiydi yoki katalog tarkibini ko’rsatadi.	Doim yoqilgan. `AIHUMMER_FS_ROOT` uni yoqmaydi, faqat qum qutisini toraytiradi: qiymat bo’sh turganda ildiz butun server (`/`) bo’ladi.

[!DANGER] Nima bo’ladi: agent shlyuz xizmati foydalanuvchisi o’qiy oladigan har qanday faylni o’qiydi — ma’lumotlar bazasiga ulanish parametrlari bo’lgan fayl va sirlar omborini shifrlaydigan kalit ham shular jumlasidan. Qanday sharoitda: AIHUMMER_FS_ROOT sozlamasi bo’sh turganda. Bu — o’z serveringizga o’rnatilgandan keyingi standart holat. Qanday tuzatiladi: Boshqaruv → Sozlamalar bo’limini oching, AIHUMMER_FS_ROOT kalitini toping, agentga haqiqatan kerak katalogni ko’rsating (masalan /srv/agent-files) va saqlang. Qiymat ma’lumotlar bazasida saqlanadi — bu kalit uchun gateway.env satri e’tiborga olinmaydi. Bundan tashqari filesystem_read nomini AIHUMMER_APPROVAL_TOOLS ro’yxatiga kiriting, shunda har bir chaqiruv sizning tasdig’ingizni kutadi.

AiHummer boshqariladigan bulutida bu vosita agentga umuman berilmaydi — ildizni faqat o’z o’rnatmangizda toraytirish kerak.

Sozlamalarda yoqish

Ushbu vositalar kerakli resursga yo’naltirmaguncha o’chiq bo’lib qoladi. Barcha yoqish tugmalari (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) bo‘ladi Sozlamalar-katalog kalitlar: ularni veb admin UI-da belgilang (Boshqaruv → Sozlamalar, u qidiruvga ega) yoki bilan aihummer settings set <KEY> <VALUE>. Ularni joylashtirish gateway.env bor hech qanday ta’sir — bu kalitlar uchun muhit e’tiborsiz qoldiriladi.

Asbob	Nimani qiladi	Qanday yoqish
`db_query`	Faqat o‘qish uchun SQL so‘rovlarini bajarish.	`AIHUMMER_DB_QUERY_DSN`
`mail`	Elektron pochta jo’natish va o’qish.	SMTP / IMAP ma’lumotlari
`tts`	Nutqni sintez qilish (matndan nutqqa).	`AIHUMMER_TTS_URL` (TTS yon avtomobil)
`code_exec`	Kodning xavfsiz muhitda bajarilishi.	`AIHUMMER_CODE_EXEC`

[!DANGER] code_exec bo‘ladi umumiy hostinglarda standart bo‘yicha o‘chirilgan. Faqat uni yoqing siz nazorat qiladigan va ishonadigan muhit, chunki u model tomonidan yozilgan kodni ishga tushiradi. Hatto sandboxlangan, uni imtiyozli imkoniyat sifatida qabul qiling.

Integratsiya vositalari

Mos keluvchi ulanish sozlanganda, agent shuningdek domen vositalarini ham oladi:

Asbob	Nimani qiladi	Qanday yoqish
Bitrix24 CRM / vazifa / taqvim vositalari	Bitrix24 CRM yozuvlari, vazifalari va taqvimini o’qing va ularga amal qiling.	Bitrix24 ulanishi sozlandi
1C (BIT.FINANS OData)	БИТ.ФИНАНС OData interfeysi orqali 1C buxgalteriya maʼlumotlarini soʻrov qilish.	1C OData ulanishi sozlandi

Tasdiqlash darvozasi

Har qanday asbob orqasiga qo‘yilishi mumkin inson-aralashuvli tasdiqlash eshigi. Asbob nomlarini ro’yxatlang AIHUMMER_APPROVAL_TOOLS sozlamalar (veb admin UI: Boshqaruv → Sozlamalar); bunday vosita ishlashdan oldin, operator chaqiruvni tasdiqlashi kerak. Rad etilgan chaqiruv emas ijro etildi.

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

Havo-ajratilgan rejim

O‘rnatish AIHUMMER_AIRGAPPED sozlash 1 model tomonidan boshqariladigan jamoat chiqishini to’sish uchun. Ushbu rejimda agent vositalar orqali ochiq internetga kira olmaydi, bu esa suveren yoki izolyatsiyalangan joylashuvlar uchun mos keladi.

aihummer settings set AIHUMMER_AIRGAPPED 1

[!NOTE] Oʻrnatilgan katalogdan tashqari, AiHummer har qanday OpenAPI 3.x dan vositalarni sintez qilishi mumkin har qanday MCP serverining asboblarini hech qanday integratsiya kodi bilan aniqlang va oshkor qiling. Qarang Hujjatlarning Marketplace va Plaginlar bo‘limi.

Keyingi qayerga

Bu yerda to‘liq tilga olingan o‘zgaruvchilar: Atrof-muhit o’zgaruvchilari.
Ishlayotgan nusxani boshqarish: CLI ma’lumotnomasi.