Феҳристи асбобҳо — AiHummer Ҳуҷҷатнигорӣ

Дар ҳангоми гардиш агент метавонад занг занад асбобҳо. 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 меўбошад дар хостҳои муштарак ба таври пешфарз хомӯш. Танҳо онро дар як муҳити зистеро, ки шумо назорат мекунед ва ба он эътимод доред, зеро он коди таҳияшудаи моделро иҷро мекунад. Ҳатто дар муҳити маҳдудшуда, онро ҳамчун қобилияти махсус баррасӣ кунед.

Абзори муттаҳидсозӣ

Вақте ки пайвасти мувофиқ сохта шавад, агент инчунин асбобҳои домейнро мегирад:

Асбоб	Он чӣ мекунад	Чӣ тавр фаъол кардан
Асбобҳои CRM / вазифаҳо / тақвим дар Bitrix24	Шуморо мехонад ва амал мекунад бар рӯйхати Bitrix24 CRM, вазифаҳо ва тақвим.	Пайвастшавии Bitrix24 танзим шудааст
1C (БИТ.ФИНАНС OData)	Маълумоти ҳисоби Query 1C тавассути интерфейси 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.