AiHummer
Беларуская▾
УвайсціАсабісты кабінет
v1.6.x▾
{ }Swagger

Каталог інструментаў

v1.6.x · абноўлена 2026-11-15

Падчас ходу агент можа выклікаць інструменты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 без інтэграцыйнага кода. Гл. Раздзел Маркетплэйс і Плагіны ў дакументацыі.

Куды далей

HTML-дакументы

Агент выкарыстоўвае doc_generate з format: "html", каб стварыць HTML-укладанне да 4 МіБ UTF-8. CSS і JavaScript захоўваюцца. Сумяшчальная абноўленая праграма адкрывае захаваны файл у ізаляваным праглядзе пасля праверкі крыніцы і цэласнасці. Даныя доступу праграмы не перадаюцца; змена файла, крыніцы ці сеанса робіць прагляд несапраўдным.