Інструменты гэта тое, як агент уплывае на свет — атрымлівае старонку, шукае, адпраўляе пошту, звяртаецца да базы даных, стварае дакумент. AiHummer пастаўляецца з багатымі ўбудаваны каталог і а Час выканання інструмента што дазваляе ўключаць інструменты пры іх наладах, перазагружае іх без перазапуску, блакуе рызыкоўныя толькі пасля адабрэння чалавека і можа цалкам блакаваць выхад у паветрана-адлучаным рэжыме.
Гэтая старонка апісвае паводзіны асяроддзя выканання і пералік убудаваных элементаў. Для поўнага даведніка глядзіце каталог інструментаў.
Як паводзіць сябе час выканання інструмента
Уключыць-па-канфігурацыі Інструмент становіцца даступным толькі тады, калі яго ўмова-папярэднік выканана.
канфігурацыя прысутнічае — звычайна гэта зменная асяроддзя, што паказвае на
паслуга, якая ёй патрэбна. Ніякай канфігурацыі, ніякага інструмента.
Гарачы перазагрузка Уключэнне інструмента прымяняецца гарачы, без перазапуску
шлюз, каб можна было ўключаць і выключаць магчымасці падчас выканання.
Брама зацвярджэння Рызыкоўныя інструменты можна размяшчаць за ўдзельнікам чалавечага ланцуга
застацца на стадыі зацвярджэння праз AIHUMMER_APPROVAL_TOOLSАдхілены выклік гэта не
выканана.
Рэжым паветранага разрыву Наладка AIHUMMER_AIRGAPPED=1 блокі, якія кіруюцца мадэллю
агульны выхад, для суверэнных або ізаляваных размяшчэнняў
[!WARNING]
code_exec з’яўляецца выключана па змаўчанні на сумесных хастынгах. Уключайце яго толькі там, дзе
пясочніца і хост падыходзяць для запуску кода, створанага мадэллю, і разглядайце
паставіўшы гэта за вароты адабрэння
Захаваць факт у доўгатэрміновай памяці; пры рэжыме збору 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 / задачы / каляндар
CRM Bitrix24, задачы і дзеянні календара
Плагін Bitrix24
1C (БІТ.ФІНАНС OData)
Доступ 1C БИТ.ФИНАНС праз OData
Канфігурацыя 1C OData
[!NOTE]
web_fetch і http_request з’яўляюцца Ахоўваемы SSRF — яны адмаўляюцца выконваць прасібы
унутраныя адрасы і іншыя небяспечныя мэты, таму мадэль не можа іх выкарыстоўваць для
дасягнуць вашай прыватнай сеткі
Супольныя навыкі
А майстэрства з’яўляецца шматразовай інструкцыяй (фрагментам запыту), якую можна прымацаваць да агентаў. Бібліятэка знаходзіцца на адміністрацыйным інтэрфейсе «Сумесныя навыкі» старонка: каб стварыць яе, дастаткова імя і тэксту — ідэнтыфікатар (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 toolsAIHUMMER_AIRGAPPED=1 # block model-controlled public egress
[!TIP]
Выкарыстоўваць AIHUMMER_APPROVAL_TOOLS патрабаваць адабрэння для чаго-небудзь з боку
эфект — адпраўка паштовых паведамленняў, выкананне кода — пры гэтым пакідаючы інструменты толькі для чытання непарушанымі.
Інструментальныя адказы ў вашых дакументах з
Веды / RAG.
**Інструменты** гэта тое, як агент уплывае на свет — атрымлівае старонку, шукае, адпраўляе пошту, звяртаецца да базы даных, стварае дакумент. AiHummer пастаўляецца з багатымі **ўбудаваны каталог** і а **Час выканання інструмента** што дазваляе ўключаць інструменты пры іх наладах, перазагружае іх без перазапуску, блакуе рызыкоўныя толькі пасля адабрэння чалавека і можа цалкам блакаваць выхад у паветрана-адлучаным рэжыме.
Гэтая старонка апісвае паводзіны асяроддзя выканання і пералік убудаваных элементаў. Для поўнага даведніка глядзіце [каталог інструментаў](/be/v1.0/reference/tools-catalog).
## Як паводзіць сябе час выканання інструмента
- **Уключыць-па-канфігурацыі** Інструмент становіцца даступным толькі тады, калі яго ўмова-папярэднік выканана.
канфігурацыя прысутнічае — звычайна гэта зменная асяроддзя, што паказвае на
паслуга, якая ёй патрэбна. Ніякай канфігурацыі, ніякага інструмента.
- **Гарачы перазагрузка** Уключэнне інструмента прымяняецца **гарачы**, без перазапуску
шлюз, каб можна было ўключаць і выключаць магчымасці падчас выканання.
- **Брама зацвярджэння** Рызыкоўныя інструменты можна размяшчаць за ўдзельнікам чалавечага ланцуга
застацца на стадыі зацвярджэння праз `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 / задачы / каляндар | CRM Bitrix24, задачы і дзеянні календара | Плагін Bitrix24 |
| 1C (БІТ.ФІНАНС OData) | Доступ 1C БИТ.ФИНАНС праз OData | Канфігурацыя 1C OData |
> [!NOTE]
> `web_fetch` і `http_request` з'яўляюцца **Ахоўваемы SSRF** — яны адмаўляюцца выконваць прасібы
> унутраныя адрасы і іншыя небяспечныя мэты, таму мадэль не можа іх выкарыстоўваць для
> дасягнуць вашай прыватнай сеткі
## Супольныя навыкі
А **майстэрства** з'яўляецца шматразовай інструкцыяй (фрагментам запыту), якую можна прымацаваць да агентаў. Бібліятэка знаходзіцца на адміністрацыйным інтэрфейсе **«Сумесныя навыкі»** старонка: каб стварыць яе, дастаткова імя і тэксту — ідэнтыфікатар (slug) генеруецца аўтаматычна. Навыкі, якія пастаўляюцца прадаўцом, гатовыя да выкарыстання **Гатова да выкарыстання** значок; іх можна адключыць, але яны застаюцца ў спісе. Прыкладзеныя навыкі адлюстроўваюцца ў стабільным прэфіксе сістэмнага падказкі агента.
## Інструменты ўключэння
Большасць інструментаў уключаюцца, калі вы падаеце іх канфігурацыю. Звычайныя пераключальнікі:
```bash
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` патрабаваць адабрэння для чаго-небудзь з боку
> эфект — адпраўка паштовых паведамленняў, выкананне кода — пры гэтым пакідаючы інструменты толькі для чытання непарушанымі.
## Куды далей
- Глядзіце поўны даведнік па кожным інструменце ў
[каталог інструментаў](/be/v1.0/reference/tools-catalog).
- Зразумейце цыкл, які выклікае гэтыя інструменты
[Аркестрацыя і суб-агенты](/be/v1.0/concepts/orchestration-subagents).
- Інструментальныя адказы ў вашых дакументах з
[Веды / RAG](/be/v1.0/concepts/knowledge-rag).