Падчас ходу агент можа выклікаць інструментыAiHummer мае ўбудаванае асяроддзе выканання інструментаў: некаторыя інструменты ўключаны па змаўчанні, іншыя актывуюцца толькі пры прадастаўленні неабходнай канфігурацыі. Інструменты абаронены ад SSRF і знаходзяцца ў пясочніцы, дзе гэта неабходна, а рызыкоўныя інструменты можна размяшчаць за сістэмай чалавечага адабрэння.
Уключана па змаўчанні
Гэтыя інструменты працуюць адразу пасля ўстаноўкі (некаторыя залежаць ад наладжанага мадэлі або базы ведаў).
Інструмент
Што гэта робіць
Як уключыць
web_fetch
Атрымаць змест URL. Абаронена ад SSRF.
Па змаўчанні ўключана
http_request
Зрабіце знешні HTTP-запыт. Абаронена ад SSRF.
Па змаўчанні ўключана
web_search
Шукайце ў сеціве праз убудаваны SearXNG.
Па змаўчанні ўключана (пастаўляецца з усталёўшчыкам); выключаецца праз --no-search
browser / computer
Кіруйце рэальным браўзэрам праз пратакол Chrome DevTools.
Па змаўчанні ўключана (пастаўляецца з усталёўшчыкам); выключаецца праз --no-browser
memory_store
Захаваць факт у доўгатэрміновай памяці (Эйнштэйн). Пры рэжыме збору auto (прадвызначана) факт адразу даступны для пошуку; пры review/off становіцца кандыдатам, які чакае ўхвалення. Вынік нясе поле searchable_now.
Па змаўчанні ўключана
memory_search
Пошук у доўгатэрміновай памяці (Эйнштэйн).
Па змаўчанні ўключана
doc_generate
Стварыць дакументы (CSV / TSV / XLSX).
Па змаўчанні ўключана
image_generate / edit_image
Стварайце або рэдагуйце выявы.
Па змаўчанні ўключана
github_get_file
Атрымаць адзін файл з рэпазіторыя GitHub.
Па змаўчанні ўключана
generate_pairing_code
Згенеруйце код спалучэння прылады.
Па змаўчанні ўключана
search_knowledge
Шукайце ў базе ведаў (RAG) і пацвярджайце адказы цытаваннямі.
З наладжанай базай ведаў
deep_research
Правядзіце шматступенчатое даследаванне і падрыхтуйце даклад са спасылкамі.
Па змаўчанні ўключана
docs_search
Пошук ан аўтаномная копія гэтай дакументацыі (здымак docs.aihummer.ru пастаўляецца ў рэлізе share/docs— агент можа адказваць на пытанні пра прадукты без інтэрнэту.
Пры наяўнасці здымак дакументаў (стандартная ўстаноўка)
docs_read
Прачытайце поўную старонку дакументацыі, якую можна знайсці праз docs_search.
Пры наяўнасці здымак дакументаў (стандартная ўстаноўка)
filesystem_read
Чытае файл або паказвае змест каталога на дыску сервера.
Уключаны заўсёды.AIHUMMER_FS_ROOT яго не ўключае, а толькі звужае пясочніцу: пакуль значэнне пустое, коранем пясочніцы служыць увесь сервер (/).
[!DANGER]
Што адбудзецца: агент прачытае любы файл, даступны на чытанне карыстальніку
службы шлюза, — уключна з файлам параметраў падлучэння да базы даных і ключом,
якім зашыфравана сховішча сакрэтаў.
Пры якой умове: пакуль настройка AIHUMMER_FS_ROOT пустая. Гэта стан па
змаўчанні адразу пасля ўсталявання на свой сервер.
Як выправіць: адкрыйце Кіраванне → Настройкі, знайдзіце
AIHUMMER_FS_ROOT, укажыце каталог, які агенту сапраўды патрэбны (напрыклад
/srv/agent-files), і захавайце. Значэнне захоўваецца ў базе — радок у
gateway.env для гэтага ключа ігнаруецца. Дадаткова ўнясіце
filesystem_read у AIHUMMER_APPROVAL_TOOLS, каб кожны выклік чакаў вашага
пацвярджэння.
У кіраваным воблаку AiHummer гэты інструмент агенту не выдаецца зусім —
звужаць корань трэба толькі на ўласным усталяванні.
Уключыць у наладках
Гэтыя прылады застаюцца выключанымі, пакуль вы не накіруеце іх на неабходны рэсурс. Усе элементы кіравання (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) з’яўляюцца Налады-каталог ключы: усталюйце іх у вэб-інтэрфейсе адміністратара (Кіраванне → Налады, гэта мае пошук) або з aihummer settings set <KEY> <VALUE>Размяшчаючы іх у gateway.env мае няма эфекту — асяроддзе ігнаруецца для гэтых клавіш.
Інструмент
Што гэта робіць
Як уключыць
db_query
Выканайце SQL-запыты толькі для чытання.
AIHUMMER_DB_QUERY_DSN
mail
Адправіць і прачытаць электронную пошту.
Даныя для ўваходу SMTP / IMAP
tts
Сінтэзаваць гаворку (тэкст у гаворку).
AIHUMMER_TTS_URL (TTS бакавое аўто)
code_exec
Выконвайце код у пясочніцы.
AIHUMMER_CODE_EXEC
[!DANGER]
code_exec з’яўляецца выключана па змаўчанні на агульных хастахУключайце гэта толькі ў
сярэдзе, якое вы кантралюеце і давяраеце, бо яно выконвае код, напісаны мадэллю. Нават
ізалявана, успрымайце гэта як прывілеяваную магчымасць.
Інтэграцыйныя інструменты
Калі злучэнне адпаведнасці наладжана, агент таксама атрымлівае інструменты дамена:
Інструмент
Што гэта робіць
Як уключыць
Інструменты Bitrix24 CRM / задач / календара
Чытайце і дзейнічайце па запісах, задачах і календары Bitrix24 CRM.
Падключэнне Bitrix24 настроена
1C (БІТ.ФІНАНС OData)
Запытвайце бухгалтарскія дадзеныя 1С праз інтэрфэйс OData БІТ.ФІНАНС.
Злучэнне 1C OData настроена
Вяршальнае адабрэнне
Любая прылада можа быць размешчана за вароты зацвярджэння з удзелам чалавекаПералічыце назвы інструментаў у AIHUMMER_APPROVAL_TOOLS наладка (вэб-інтэрфейс адміністратара: Кіраванне → Налады); перад тым як такі інструмент запусціцца, аператар павінен зацвердзіць выклік. Адхілены выклік не выканана.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
Рэжым ізаляванай сеткі
Усталяваць AIHUMMER_AIRGAPPED устаноўка на 1 блкіраваць публічны выхад, кантраляваны мадэллю. У гэтым рэжыме агент не можа атрымаць доступ да адкрытага інтэрнэту праз інструменты, што адпавядае суверэнным або ізаляваным разгортванням.
aihummer settings set AIHUMMER_AIRGAPPED 1
[!NOTE]
Акрамя ўбудаванага каталога, AiHummer можа сінтэзаваць інструменты з любой OpenAPI 3.x
прагляд і выяўленне любых інструментаў сервера MCP без інтэграцыйнага кода. Гл.
Раздзел Маркетплэйс і Плагіны ў дакументацыі.
Падчас ходу агент можа выклікаць **інструменты**AiHummer мае ўбудаванае асяроддзе выканання інструментаў: некаторыя інструменты ўключаны па змаўчанні, іншыя актывуюцца толькі пры прадастаўленні неабходнай канфігурацыі. Інструменты абаронены ад SSRF і знаходзяцца ў пясочніцы, дзе гэта неабходна, а рызыкоўныя інструменты можна размяшчаць за сістэмай чалавечага адабрэння.
## Уключана па змаўчанні
Гэтыя інструменты працуюць адразу пасля ўстаноўкі (некаторыя залежаць ад наладжанага мадэлі або базы ведаў).
| Інструмент | Што гэта робіць | Як уключыць |
|---|---|---|
| `web_fetch` | Атрымаць змест URL. Абаронена ад SSRF. | Па змаўчанні ўключана |
| `http_request` | Зрабіце знешні HTTP-запыт. Абаронена ад SSRF. | Па змаўчанні ўключана |
| `web_search` | Шукайце ў сеціве праз убудаваны SearXNG. | Па змаўчанні ўключана (пастаўляецца з усталёўшчыкам); выключаецца праз `--no-search` |
| `browser` / `computer` | Кіруйце рэальным браўзэрам праз пратакол Chrome DevTools. | Па змаўчанні ўключана (пастаўляецца з усталёўшчыкам); выключаецца праз `--no-browser` |
| `memory_store` | Захаваць факт у доўгатэрміновай памяці (Эйнштэйн). Пры рэжыме збору `auto` (прадвызначана) факт адразу даступны для пошуку; пры `review`/`off` становіцца кандыдатам, які чакае ўхвалення. Вынік нясе поле `searchable_now`. | Па змаўчанні ўключана |
| `memory_search` | Пошук у доўгатэрміновай памяці (Эйнштэйн). | Па змаўчанні ўключана |
| `doc_generate` | Стварыць дакументы (CSV / TSV / XLSX). | Па змаўчанні ўключана |
| `image_generate` / `edit_image` | Стварайце або рэдагуйце выявы. | Па змаўчанні ўключана |
| `github_get_file` | Атрымаць адзін файл з рэпазіторыя GitHub. | Па змаўчанні ўключана |
| `generate_pairing_code` | Згенеруйце код спалучэння прылады. | Па змаўчанні ўключана |
| `search_knowledge` | Шукайце ў базе ведаў (RAG) і пацвярджайце адказы цытаваннямі. | З наладжанай базай ведаў |
| `deep_research` | Правядзіце шматступенчатое даследаванне і падрыхтуйце даклад са спасылкамі. | Па змаўчанні ўключана |
| `docs_search` | Пошук ан **аўтаномная копія гэтай дакументацыі** (здымак docs.aihummer.ru пастаўляецца ў рэлізе `share/docs`— агент можа адказваць на пытанні пра прадукты без інтэрнэту. | Пры наяўнасці здымак дакументаў (стандартная ўстаноўка) |
| `docs_read` | Прачытайце поўную старонку дакументацыі, якую можна знайсці праз `docs_search`. | Пры наяўнасці здымак дакументаў (стандартная ўстаноўка) |
| `filesystem_read` | Чытае файл або паказвае змест каталога на дыску сервера. | **Уключаны заўсёды.** `AIHUMMER_FS_ROOT` яго не ўключае, а толькі **звужае** пясочніцу: пакуль значэнне пустое, коранем пясочніцы служыць увесь сервер (`/`). |
> [!DANGER]
> **Што адбудзецца:** агент прачытае любы файл, даступны на чытанне карыстальніку
> службы шлюза, — уключна з файлам параметраў падлучэння да базы даных і ключом,
> якім зашыфравана сховішча сакрэтаў.
> **Пры якой умове:** пакуль настройка `AIHUMMER_FS_ROOT` пустая. Гэта стан па
> змаўчанні адразу пасля ўсталявання на свой сервер.
> **Як выправіць:** адкрыйце **Кіраванне → Настройкі**, знайдзіце
> `AIHUMMER_FS_ROOT`, укажыце каталог, які агенту сапраўды патрэбны (напрыклад
> `/srv/agent-files`), і захавайце. Значэнне захоўваецца ў базе — радок у
> `gateway.env` для гэтага ключа ігнаруецца. Дадаткова ўнясіце
> `filesystem_read` у `AIHUMMER_APPROVAL_TOOLS`, каб кожны выклік чакаў вашага
> пацвярджэння.
>
> У кіраваным воблаку AiHummer гэты інструмент агенту не выдаецца зусім —
> звужаць корань трэба толькі на ўласным усталяванні.
## Уключыць у наладках
Гэтыя прылады застаюцца выключанымі, пакуль вы не накіруеце іх на неабходны рэсурс. Усе элементы кіравання (`AIHUMMER_DB_QUERY_DSN`, `AIHUMMER_CODE_EXEC`, …) з'яўляюцца **Налады-каталог** ключы: усталюйце іх у вэб-інтэрфейсе адміністратара (**Кіраванне → Налады**, гэта мае пошук) або з `aihummer settings set <KEY> <VALUE>`Размяшчаючы іх у `gateway.env` мае **няма эфекту** — асяроддзе ігнаруецца для гэтых клавіш.
| Інструмент | Што гэта робіць | Як уключыць |
|---|---|---|
| `db_query` | Выканайце SQL-запыты толькі для чытання. | `AIHUMMER_DB_QUERY_DSN` |
| `mail` | Адправіць і прачытаць электронную пошту. | Даныя для ўваходу SMTP / IMAP |
| `tts` | Сінтэзаваць гаворку (тэкст у гаворку). | `AIHUMMER_TTS_URL` (TTS бакавое аўто) |
| `code_exec` | Выконвайце код у пясочніцы. | `AIHUMMER_CODE_EXEC` |
> [!DANGER]
> `code_exec` з'яўляецца **выключана па змаўчанні на агульных хастах**Уключайце гэта толькі ў
> сярэдзе, якое вы кантралюеце і давяраеце, бо яно выконвае код, напісаны мадэллю. Нават
> ізалявана, успрымайце гэта як прывілеяваную магчымасць.
## Інтэграцыйныя інструменты
Калі злучэнне адпаведнасці наладжана, агент таксама атрымлівае інструменты дамена:
| Інструмент | Што гэта робіць | Як уключыць |
|---|---|---|
| Інструменты Bitrix24 CRM / задач / календара | Чытайце і дзейнічайце па запісах, задачах і календары Bitrix24 CRM. | Падключэнне Bitrix24 настроена |
| 1C (БІТ.ФІНАНС OData) | Запытвайце бухгалтарскія дадзеныя 1С праз інтэрфэйс OData БІТ.ФІНАНС. | Злучэнне 1C OData настроена |
## Вяршальнае адабрэнне
Любая прылада можа быць размешчана за **вароты зацвярджэння з удзелам чалавека**Пералічыце назвы інструментаў у `AIHUMMER_APPROVAL_TOOLS` наладка (вэб-інтэрфейс адміністратара: Кіраванне → Налады); перад тым як такі інструмент запусціцца, аператар павінен зацвердзіць выклік. Адхілены выклік **не** выканана.
```bash
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
```
## Рэжым ізаляванай сеткі
Усталяваць `AIHUMMER_AIRGAPPED` устаноўка на `1` блкіраваць публічны выхад, кантраляваны мадэллю. У гэтым рэжыме агент не можа атрымаць доступ да адкрытага інтэрнэту праз інструменты, што адпавядае суверэнным або ізаляваным разгортванням.
```bash
aihummer settings set AIHUMMER_AIRGAPPED 1
```
> [!NOTE]
> Акрамя ўбудаванага каталога, AiHummer можа сінтэзаваць інструменты з любой OpenAPI 3.x
> прагляд і выяўленне любых інструментаў сервера MCP без інтэграцыйнага кода. Гл.
> Раздзел Маркетплэйс і Плагіны ў дакументацыі.
## Куды далей
- Зменныя, на якія тут спасылаюцца поўнасцю: [Зменныя асяроддзя](/be/v1.0/reference/env-vars).
- Кіруйце актыўным запушчаным экземплярам: [Даведнік CLI](/be/v1.0/reference/cli).
