Абзорҳо

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

**Абзорҳо** усулест, ки як агент бар ҷаҳон амал мекунад — гирифтани як саҳифа, ҷустуҷӯ, фиристодани почта, дархости пойгоҳи додаҳо, тавлиди як ҳуҷҷат. AiHummer як **каталоги дарунсохти** бой ва як **Tool Runtime**-ро дар бар мегирад, ки абзорҳоро вақте ки онҳо танзим карда мешаванд, фаъол мекунад, онҳоро бидуни оғози дубора аз нав боргузорӣ мекунад, абзорҳои хатарнокро дар паси тасдиқи инсонӣ дарвоза мекунад ва метавонад баромадро дар реҷаи аз ҳаво ҷудошуда комилан қулф кунад. Ин саҳифа фаро мегирад, ки чӣ тавр Runtime рафтор мекунад ва дарунсохтҳоро рӯйхат мекунад. Барои маълумоти пурра, ба [каталоги абзорҳо](/tg/v1.0/reference/tools-catalog) нигаред. ## Чӣ тавр 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) ба таври худкор ҳосил мешавад. Маҳоратҳое, ки вендор пешниҳод мекунад, бо нишони **«Аз қуттӣ»** ишора шудаанд; онҳоро хомӯш кардан мумкин аст, аммо онҳо дар рӯйхат мемонанд. Маҳоратҳои пайвастшуда ба префикси устувори промпти системавии агент рендер мешаванд. ## Фаъол кардани абзорҳо Аксари абзорҳо вақте фаъол мешаванд, ки шумо танзимоти онҳоро таъмин кунед. Калидҳои маъмул: ```bash 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`-ро истифода баред, то барои ҳар чизи дорои таъсири паҳлӯӣ > — фиристодани почта, иҷрои код — тасдиқро талаб кунед, дар ҳоле ки абзорҳои > танҳо-хониширо бедарвоза мегузоред. ## Минбаъд ба куҷо - Маълумоти пурраи ҳар абзорро дар [каталоги абзорҳо](/tg/v1.0/reference/tools-catalog) бубинед. - Ҳалқаеро, ки ин абзорҳоро даъват мекунад, бифаҳмед дар [Оркестратсия ва зер-агентҳо](/tg/v1.0/concepts/orchestration-subagents). - Ҷавобҳои абзорро дар ҳуҷҷатҳои худ асоснок кунед бо [Дониш / RAG](/tg/v1.0/concepts/knowledge-rag).