Каталог інструментаў
Падчас ходу агент можа выклікаць інструменты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 або HTML. | Па змаўчанні ўключана |
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 |
Чытае файл або паказвае змест каталога на дыску сервера. | Па змаўчанні — уласная працоўная папка агента; доступ да хоста патрабуе яўнага выбару ўладальнікам рэжыму ізаляцыі для гэтага агента. Недаступны ў кіраваным воблаку і дэма. |
[!NOTE]
AIHUMMER_FS_ROOTдадаткова звужае дазволены корань; пустое значэнне не адкрывае ўвесь сервер. Настройкі ўсталявання, яго даныя доступу да базы і ключы шыфравання, а таксама асяроддзе працэсаў недаступныя для чытання. Пацвярджэнне не пашырае дазволеную вобласць файлаў.
Уключыць у наладках
Гэтыя прылады застаюцца выключанымі, пакуль вы не накіруеце іх на неабходны рэсурс. Усе элементы кіравання (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 без інтэграцыйнага кода. Гл. Раздзел Маркетплэйс і Плагіны ў дакументацыі.
Куды далей
- Зменныя, на якія тут спасылаюцца поўнасцю: Зменныя асяроддзя.
- Кіруйце актыўным запушчаным экземплярам: Даведнік CLI.
HTML-дакументы
Агент выкарыстоўвае doc_generate з format: "html", каб стварыць HTML-укладанне да 4 МіБ UTF-8. CSS і JavaScript захоўваюцца. Сумяшчальная абноўленая праграма адкрывае захаваны файл у ізаляваным праглядзе пасля праверкі крыніцы і цэласнасці. Даныя доступу праграмы не перадаюцца; змена файла, крыніцы ці сеанса робіць прагляд несапраўдным.