Асбобҳо

AIHUMMER_FS_ROOT=/srv/agent-files          # қуттии реги filesystem_read-ро ТАНГ МЕКУНАД (холӣ = тамоми сервер)
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

**Асбобҳо** ба тарзи амалҳои агент нисбат ба ҷаҳон ишора мекунад — овардани саҳифа, ҷустуҷӯ, ирсоли почта, пурсиши пойгоҳи додаҳо, эҷоди ҳуҷҷат. AiHummer як таҷҳизоти бой медиҳад **каталоги сохташуда** ва як **Вақти иҷрои асбоб** ки асбобҳоро ҳангоми конфигуратсия фаъол мекунад, онҳоро бе оғози дубора бор мекунад, осебпазиронаро пас аз тасдиқи инсон меафзояд ва метавонад хориҷшавиро пурра дар ҳолати маҳдудшудаи ҷудо карда аз ҳаво қулф кунад. Ин саҳифа ба он чӣ гуна иҷроиш кор мекунад ва рӯйхати асбобҳои дохилиро нишон медиҳад. Барои истиноди пурра, нигаред ба [каталоги асбобҳо](/tg/v1.0/reference/tools-catalog). ## Чӣ гуна муҳлати иҷрои асбоб амал мекунад - **Фаъолсозӣ-барои-конфиг.** Асбоб танҳо вақте дастрас мегардад, ки талаботи пешакӣаш иҷро шудааст танзимот мавҷуд аст — одатан ин як тағйирёбандаи муҳитӣ мебошад, ки ба хизматрасонии лозим. Ҳеҷ конфиг, ҳеҷ асбоб. - **Бори гарм фаъол.** Фаъолсозии асбоб татбиқ мешавад **гарм**бидуни аз нав оғоз кардан дарвоза, то шумо метавонед қобилиятҳоро ҳангоми иҷро фаъол ё хомӯш кунед. - **Рӯйи тасдиқ** Асбобҳои хатарнок метавонанд дар паси инсон-дар-илова ҷойгир шаванд дарвозаи тасдиқ тавассути `AIHUMMER_APPROVAL_TOOLS`Занге, ки рад шудааст **не** давр карда шуд. - **Ҳолати ҷудо аз шабака.** Муҳит `AIHUMMER_AIRGAPPED=1` моделиқароргирифтаи блокҳо баромади умумӣ, барои насбҳои давлатӣ ё ҷудогона. > [!WARNING] > `code_exec` меўбошад **пешфарз хомӯш** дар хостҳои умумӣ. Онро танҳо дар ҷое фаъол созед, ки > қуттии санг ва мизбон барои иҷрои коде, ки модел навиштааст, қабулшавандаанд, ва ба назар гиред > онро паси даргоҳи тасдиқ гузоштан. ## Асбобҳои дохилӣ | Асбоб | Он чӣ мекунад | Фаъол кардан бо | |---|---|---| | `web_fetch` | URL-ро гиред (бо муҳофизати SSRF) | ба таври пешфарз фаъол | | `http_request` | Як дархости HTTP созед (аз SSRF муҳофизатшуда) | ба таври пешфарз фаъол | | `web_search` | Ҷустуҷӯ дар веб тавассути SearXNG-и дарунсохт | ба таври пешфарз фаъол; бо флаги насбкунанда `--no-search` хомӯш мешавад | | `browser` | Бо CDP браузери воқеӣ роҳандозӣ кунед | ба таври пешфарз фаъол; бо флаги насбкунанда `--no-browser` хомӯш мешавад | | `computer` | Истифодаи компютер барои CDP | ба таври пешфарз фаъол; бо флаги насбкунанда `--no-browser` хомӯш мешавад | | `memory_store` | Фактро дар хотираи дарозмуддат нигоҳ медорад; дар режими захти `auto` (пешфарз) факт фавран барои ҷустуҷӯ дастрас аст, дар `review`/`off` — номзаде мешавад, ки тасдиқро интизор аст | ба таври пешфарз фаъол | | `memory_search` | Ҷустуҷӯ дар хотираи дарозмуддат | ба таври пешфарз фаъол | | `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` | Бозёфтани дониш ва таҳқиқоти чандқадамӣ | поёнгоҳи дониш | | CRM / вазифа / тақвими Bitrix24 | CRM Bitrix24, вазифаҳо ва амалҳои тақвим | Иловаи Bitrix24 | | 1C (БИТ.ФИНАНС OData) | Дастрасии 1C БИТ.ФИНАНС тавассути OData | Танзимоти 1C OData | > [!NOTE] > `web_fetch` ва `http_request` меўбошанд **Зери муҳофизати SSRF** — онҳо аз дархостҳо барои рад кардан даст мекашанд > нишонии дохилӣ ва дигар ҳадафҳои номашруъ, бинобар ин модели мушаххас наметавонад аз онҳо истифода барад > ба шабакаи хусусии худ бирасед. ## Малакаҳои муштарак А **маҳорати** як дастури дубора истифодашаванда (қисмати пешниҳоди) аст, ки ба агентҳо пайваст карда мешавад. Китобхона дар интерфейси маъмурон қарор дорад **Малакаҳои муштарак** саҳифа: барои сохтани он, як ном ва матн кофӣ аст — шиноса (slug) ба таври автоматӣ ҳосил мешавад. Маҳоратҳое, ки аз тарафи фурӯшанда омода пешниҳод мешаванд, дорои **Берун аз қуттӣ** нишон; онҳо метавонанд ғайрифаъол шаванд, аммо ҳанӯз рӯйхатбандӣ мемонанд. Маҳорати пайвастшуда ба префикси устувори рӯйпурси системаи агент гузошта мешаванд. ## Асбобҳои иҷозадодашуда Аксарияти воситаҳо вақте фаъол мешаванд, ки танзимоти онҳоро пешкаш кунед. Калидҳои маъмул: ```bash AIHUMMER_FS_ROOT=/srv/agent-files # қуттии реги filesystem_read-ро ТАНГ МЕКУНАД (холӣ = тамоми сервер) 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` барои ягон чиз бо паҳлӯ иҷозат талаб кардан > таъсир — фиристодани почта, иҷрои код — дар ҳоле ки асбобҳои танҳо барои хондан баста нестанд. ## Баъд ба куҷо - Маълумоти пурраи ҳар асбобро дар [каталоги асбобҳо](/tg/v1.0/reference/tools-catalog). - Фаҳмед, ки чуқурие, ки ин асбобҳоро фаро мехонад, чӣ гуна кор мекунад [Оркестратсия ва зер-агентҳо](/tg/v1.0/concepts/orchestration-subagents). - Воситаҳои замин ҷавобҳоро дар ҳуҷҷатҳои шумо доранд [Дониш / RAG](/tg/v1.0/concepts/knowledge-rag).