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

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

Бұл бетте іске қосу ортасының қалай әрекет ететіні және кіріктірілген функциялар тізімі көрсетілген. Толық анықтама үшін мына қараңыз құралдар каталогы.

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

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

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

Құрылғы ішіндегі құралдар

Құрал	Не істейді	Қосу арқылы
`web_fetch`	URL алу (SSRF-ке қарсы қорғалған)	әдепкі бойынша қосулы
`http_request`	HTTP сұрауын жасаңыз (SSRF-дан қорғалған)	әдепкі бойынша қосулы
`web_search`	Кіріктірілген SearXNG арқылы веб іздеу	әдепкіде қосулы; орнатқыштың `--no-search` жалаушасымен өшіріледі
`browser`	CDP арқылы нақты шолғышты жүргізу	әдепкіде қосулы; орнатқыштың `--no-browser` жалаушасымен өшіріледі
`computer`	CDP арқылы компьютерді пайдалану	әдепкіде қосулы; орнатқыштың `--no-browser` жалаушасымен өшіріледі
`memory_store`	Фактіні ұзақ мерзімді жадта сақтау; жинау режимі `auto` болғанда (әдепкі) ол бірден іздеуге қолжетімді, `review`/`off` кезінде мақұлдауды күтетін кандидат болады	әдепкіде қосулы
`memory_search`	Ұзақ мерзімді жадтан іздеу	әдепкіде қосулы
`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 сайдкар
`image_generate` / `edit_image`	Суреттерді жасау және өңдеу	конфигурацияланған кескін артқы жағы
`github_get_file`	GitHub-тен файл алу	әдепкі бойынша қосулы
`generate_pairing_code`	Құрылғыны жұптастыру кодыңызды шығарыңыз	әдепкі бойынша қосулы
`search_knowledge` / `deep_research`	Білімді алу және көпсатылы зерттеу	білім қоры
Bitrix24 CRM / тапсырма / күнтізбе	Bitrix24 CRM, тапсырма және күнтізбе әрекеттері	Bitrix24 плагині
1C (БИТ.ҚАРЖЫ OData)	1C БИТ.ФИНАНС OData арқылы қол жеткізу	1C OData конфигурациясы

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

Тұрақты браузер профилі

Әдепкі бойынша computer әр сұрауға таза браузер ашады. 1.3 нұсқасынан бастап құрал нақты тағайындалған жеке профильді (cookie және сайт сессиялары) сұраулар арасында сақтай алады — мысалы, қызметкер әр жолы қайта кірмей өз кабинеттерін жүргізуі үшін. Профиль ешқашан модель аргументтеріндегі атау немесе жол бойынша таңдалмайды — тек оператордың нақты байланыстыруы бойынша:

AIHUMMER_BROWSER_PROFILE_SOCKET — орнатылған браузер қызметінің жеке managed-profiles.sock сокетіне абсолютті жол; бос (әдепкі) — тұрақты профильдер өшірулі.
AIHUMMER_BROWSER_PROFILE_BINDINGS — байланыстырулардың JSON массиві: profile_id, tenant_id, user_id, agent_ids және conversation_ids (64-ке дейін профиль, әрқайсысының бір иесі).

Профиль тек ағымдағы пайдаланушы оның иесі болғанда және агент пен диалог байланыстыруда тізімделгенде ашылады; диалог басқа адам қатысушыларсыз жеке болуы керек. Иесі мен құқықтар тек алғаш ашқанда ғана емес, әр әрекетте тексеріледі. Тұрақты профильдер қосулы кезде computer әрекеттері тек сәйкес байланыстырумен орындалады. Браузердің нақты желі саясаты қажет — орнатылған AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK (true немесе false) немесе AIHUMMER_BROWSER_ALLOWED_HOSTNAMES тізімі; сыртқы браузердің cookie файлдары импортталмайды. Екі параметр де қауіпті болып саналады: басқарылатын бұлтта және демо-инстанста олар құлыптаулы.

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

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

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

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

AIHUMMER_FS_ROOT=/srv/agent-files          # filesystem_read құм жәшігін ТАРЫЛТАДЫ (бос = бүкіл сервер)
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.