Құралдар
Құралдар бұл агенттің әлемде қалай әрекет ететіні — бет алу, іздеу, хат жіберу, деректер қорынан сұрау жүргізу, құжат әзірлеу. 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 немесе HTML құжатын жасау. | әдепкі бойынша қосулы |
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.
HTML құжаттары
Агент doc_generate және format: "html" арқылы 4 МиБ дейін UTF-8 HTML тіркемесін жасайды. CSS пен JavaScript сақталады. Үйлесімді жаңартылған қолданба дереккөз бен тұтастықты тексеріп, сақталған файлды оқшауланған алдын ала қарауда ашады. Қолданбаның кіру деректері берілмейді; файл, дереккөз немесе сеанс өзгерсе, қарау жарамсыз болады.