Құралдар — AiHummer Құжаттама

Құралдар — агенттің әлемге әсер ету тәсілі: бетті алу, іздеу, пошта жіберу, дерекқорға сұраныс жасау, құжат жасау. AiHummer бай ішкі каталогты және Құрал орындалу ортасын жеткізеді, ол бапталған кезде құралдарды қосады, оларды қайта іске қоспай қайта жүктейді, тәуекелдісін адам мақұлдауының артына қояды әрі air-gapped режимінде сыртқа шығуды толық бұғаттай алады.

Бұл бет орындалу ортасы қалай әрекет ететінін қамтиды әрі ішкі құралдарды тізбелейді. Толық анықтамаға құралдар каталогын қараңыз.

Құрал орындалу ортасы қалай әрекет етеді

Конфигурацияда қосу. Құрал тек өзінің алғышарт конфигурациясы болғанда ғана қолжетімді болады — әдетте оған қажетті қызметке бағыттайтын орта айнымалысы. Конфигурация жоқ — құрал жоқ.
Қызу қайта жүктеу. Құралды қосу шлюзді қайта іске қоспай қызу күйде қолданылады, сондықтан мүмкіндіктерді жұмыс кезінде қосып-өшіре аласыз.
Мақұлдау қақпасы. Тәуекелді құралдарды AIHUMMER_APPROVAL_TOOLS арқылы процеске адам қатысатын мақұлдау қақпасының артына қоюға болады. Қабылданбаған шақыру орындалмайды.
Air-gapped режимі. AIHUMMER_AIRGAPPED=1 орнату модель басқаратын ашық сыртқа шығуды бұғаттайды, бұл егеменді немесе оқшауланған орналастырулар үшін.

[!WARNING] code_exec ортақ хосттарда әдепкі бойынша өшулі. Оны тек құм жәшігі мен хост модель жазған кодты орындау үшін қолайлы жерде ғана қосыңыз әрі оны мақұлдау қақпасының артына қоюды қарастырыңыз.

Ішкі құралдар

Құрал	Не істейді	Немен қосылады
`web_fetch`	URL-ді алу (SSRF-қорғалған)	әдепкі бойынша қосулы
`http_request`	HTTP сұранысын жасау (SSRF-қорғалған)	әдепкі бойынша қосулы
`web_search`	SearXNG арқылы веб іздеу	`SEARXNG_URL`
`browser`	CDP арқылы нақты браузерді басқару	`CLOAKBROWSER_CDP_URL`
`computer`	CDP арқылы компьютер қолдану	`CLOAKBROWSER_CDP_URL`
`filesystem_read`	Құм жәшігіндегі түбірдегі файлдарды оқу	`AIHUMMER_FS_ROOT`
`db_query`	Тек оқуға арналған дерекқор сұранысы	`AIHUMMER_DB_QUERY_DSN`
`mail`	Пошта жіберу/қабылдау (SMTP/IMAP)	пошта тіркелгі деректері (қойма)
`code_exec`	Кодты құм жәшігінде орындау (ортақ хосттарда әдепкі бойынша өшулі)	`AIHUMMER_CODE_EXEC`
`doc_generate`	CSV/TSV/XLSX құжаттарын жасау	әдепкі бойынша қосулы
`tts`	Мәтінді сөзге айналдыру	TTS sidecar
`image_generate` / `edit_image`	Кескіндерді жасау және өңдеу	бапталған кескін бэкенді
`github_get_file`	GitHub-тан файл алу	әдепкі бойынша қосулы
`generate_pairing_code`	Құрылғыны жұптау кодын беру	әдепкі бойынша қосулы
`search_knowledge` / `deep_research`	Білім алу және көп қадамды зерттеу	білім қоры
Bitrix24 CRM / тапсырма / күнтізбе	Bitrix24 CRM, тапсырма және күнтізбе әрекеттері	Bitrix24 плагині
1C (БІТ.ФИНАНС OData)	OData арқылы 1C БІТ.ФИНАНС қатынасы	1C OData конфигурациясы

[!NOTE] web_fetch және http_request SSRF-қорғалған — олар ішкі мекенжайларға және басқа қауіпсіз емес нысандарға сұраныстардан бас тартады, сондықтан модель оларды жеке желіңізге жету үшін қолдана алмайды.

Ортақ дағдылар

Дағды — агенттерге қосуға болатын қайта пайдаланылатын нұсқаулық (промпт үзіндісі). Кітапхана админканың «Ортақ дағдылар» бетінде тұрады: жасау кезінде аты мен мәтіні жеткілікті — идентификатор (slug) автоматты түрде шығарылады. Вендор «қораптан тыс» жеткізетін дағдылар «Қораптан тыс» бейджімен белгіленген; оларды өшіруге болады, бірақ олар тізімде қалады. Қосылған дағдылар агенттің жүйелік промптының тұрақты префиксіне рендерленеді.

Құралдарды қосу

Көптеген құралдар олардың конфигурациясын бергенде қосылады. Жиі қолданылатын ауыстырғыштар:

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] Жанама әсері бар нәрсенің бәріне — пошта жіберу, кодты орындау — мақұлдау талап ету үшін AIHUMMER_APPROVAL_TOOLS қолданыңыз, ал тек оқуға арналған құралдарды қақпасыз қалдырыңыз.

Келесі қайда

Әр құрал бойынша толық анықтаманы құралдар каталогынан қараңыз.
Осы құралдарды шақыратын циклды Оркестрация және ішкі агенттер бөлімінде түсініңіз.
Құрал жауаптарын құжаттарыңызбен Білім / RAG арқылы негіздеңіз.