Інструменты — AiHummer Дакументацыя

Інструменты — гэта тое, як агент дзейнічае на свет — здабывае старонку, шукае, адпраўляе пошту, запытвае базу дадзеных, генеруе дакумент. AiHummer пастаўляе багаты ўбудаваны каталог і Tool Runtime, які ўключае інструменты, калі яны наладжаны, перазагружае іх без перазапуску, ставіць рызыкоўныя за вароты чалавечага зацвярджэння і можа цалкам заблакаваць выхад у рэжыме паветранага зазору.

Гэтая старонка апісвае, як паводзіць сябе рантайм, і пералічвае ўбудаваныя інструменты. Поўны даведнік глядзіце ў каталогу інструментаў.

Як паводзіць сябе Tool Runtime

Уключэнне па канфігурацыі. Інструмент становіцца даступным толькі тады, калі прысутнічае яго неабходная канфігурацыя — звычайна зменная асяроддзя, што паказвае на сэрвіс, які яму патрэбны. Няма канфігурацыі — няма інструмента.
Гарачая перазагрузка. Уключэнне інструмента прымяняецца гарача, без перазапуску шлюза, так што вы можаце ўключаць і выключаць здольнасці ў рантайме.
Вароты зацвярджэння. Рызыкоўныя інструменты можна паставіць за вароты зацвярджэння з чалавекам у цыкле праз AIHUMMER_APPROVAL_TOOLS. Адхілены выклік не выконваецца.
Рэжым паветранага зазору. Усталяванне AIHUMMER_AIRGAPPED=1 блакуе кантраляваны мадэллю публічны выхад, для суверэнных або ізаляваных разгортванняў.

[!WARNING] code_exec выключаны прадвызначана на агульных хастах. Уключайце яго толькі там, дзе пясочніца і хаст прыймальныя для запуску кода, аўтараванага мадэллю, і разгледзьце магчымасць паставіць яго за вароты зацвярджэння.

Убудаваныя інструменты

Інструмент	Што ён робіць	Уключыць праз
`web_fetch`	Здабыць URL (абаронена ад SSRF)	уключана прадвызначана
`http_request`	Зрабіць HTTP-запыт (абаронена ад SSRF)	уключана прадвызначана
`web_search`	Вэб-пошук праз SearXNG	`SEARXNG_URL`
`browser`	Кіраваць сапраўдным браўзерам праз CDP	`CLOAKBROWSER_CDP_URL`
`computer`	Кампутарнае выкарыстанне праз CDP	`CLOAKBROWSER_CDP_URL`
`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 / задача / каляндар	Дзеянні Bitrix24 CRM, задач і календара	плагін Bitrix24
1C (БІТ.ФІНАНС OData)	Доступ да 1C БІТ.ФІНАНС праз OData	канфігурацыя 1C OData

[!NOTE] web_fetch і http_request абаронены ад SSRF — яны адмаўляюць запыты да ўнутраных адрасоў і іншых небяспечных мэт, так што мадэль не можа выкарыстаць іх для дасягнення вашай прыватнай сеткі.

Агульныя навыкі

Навык — гэта пераўжывальная інструкцыя (кавалак промпта), якую можна падключаць агентам. Бібліятэка жыве на старонцы «Агульныя навыкі» адмінкі: пры стварэнні дастаткова імя і тэксту — ідэнтыфікатар (slug) выводзіцца аўтаматычна. Навыкі, што пастаўляюцца вендарам «з каробкі», пазначаны значком «З каробкі»; іх можна адключыць, але яны застаюцца ў спісе. Падключаныя навыкі рэндэрацца ў стабільны прэфікс сістэмнага промпта агента.

Уключэнне інструментаў

Большасць інструментаў уключаюцца, калі вы прадастаўляеце іх канфігурацыю. Распаўсюджаныя пераключальнікі:

SEARXNG_URL=http://localhost:8888          # web_search
CLOAKBROWSER_CDP_URL=http://localhost:9222 # browser + computer
AIHUMMER_FS_ROOT=/srv/agent-files          # filesystem_read (sandboxed root)
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.