Мафҳумҳои асосӣ / Асбобҳо
Асбобҳо v1.3.x · навсозӣ шуд 2026-09-15 ⧉ Нусхабардорӣ ҳамчун Markdown ✓ Нусхабардорӣ шуд
Асбобҳо ба тарзи амалҳои агент нисбат ба ҷаҳон ишора мекунад — овардани саҳифа, ҷустуҷӯ, ирсоли почта, пурсиши пойгоҳи додаҳо, эҷоди ҳуҷҷат. AiHummer як таҷҳизоти бой медиҳад каталоги сохташуда ва як Вақти иҷрои асбоб ки асбобҳоро ҳангоми конфигуратсия фаъол мекунад, онҳоро бе оғози дубора бор мекунад, осебпазиронаро пас аз тасдиқи инсон меафзояд ва метавонад хориҷшавиро пурра дар ҳолати маҳдудшудаи ҷудо карда аз ҳаво қулф кунад.
Ин саҳифа ба он чӣ гуна иҷроиш кор мекунад ва рӯйхати асбобҳои дохилиро нишон медиҳад. Барои истиноди пурра, нигаред ба каталоги асбобҳо .
Чӣ гуна муҳлати иҷрои асбоб амал мекунад
Фаъолсозӣ-барои-конфиг. Асбоб танҳо вақте дастрас мегардад, ки талаботи пешакӣаш иҷро шудааст
танзимот мавҷуд аст — одатан ин як тағйирёбандаи муҳитӣ мебошад, ки ба
хизматрасонии лозим. Ҳеҷ конфиг, ҳеҷ асбоб.
Бори гарм фаъол. Фаъолсозии асбоб татбиқ мешавад гарм бидуни аз нав оғоз кардан
дарвоза, то шумо метавонед қобилиятҳоро ҳангоми иҷро фаъол ё хомӯш кунед.
Рӯйи тасдиқ Асбобҳои хатарнок метавонанд дар паси инсон-дар-илова ҷойгир шаванд
дарвозаи тасдиқ тавассути 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 — онҳо аз дархостҳо барои рад кардан даст мекашанд
нишонии дохилӣ ва дигар ҳадафҳои номашруъ, бинобар ин модели мушаххас наметавонад аз онҳо истифода барад
ба шабакаи хусусии худ бирасед.
Профили доимии браузер
Аз рӯи пешфарз computer барои ҳар дархост браузери тозаро мекушояд. Аз
версияи 1.3 абзор метавонад профили шахсии ба таври возеҳ таъиншударо
(cookie ва сессияҳои сайтҳо) байни дархостҳо нигоҳ дорад — масалан, то корманд
кабинетҳои худро бе ҳар дафъа аз нав ворид шудан идора кунад. Профил ҳеҷ гоҳ
аз рӯи ном ё роҳ аз аргументҳои модел интихоб намешавад — танҳо аз рӯи
пайвасти возеҳи оператор:
AIHUMMER_BROWSER_PROFILE_SOCKET — роҳи мутлақ ба сокети хусусии
managed-profiles.sock-и хидмати насбшудаи браузер; холӣ (пешфарз) —
профилҳои доимӣ хомӯшанд.
AIHUMMER_BROWSER_PROFILE_BINDINGS — массиви JSON-и пайвастҳо: profile_id,
tenant_id, user_id, agent_ids ва conversation_ids (то 64 профил, ҳар
яке бо як соҳиб).
Профил танҳо вақте кушода мешавад, ки корбари ҷорӣ соҳиби он бошад ва агент ва
муколама дар пайваст номбар шуда бошанд; муколама бояд шахсӣ бошад, бе
иштирокчиёни дигари инсон. Соҳиб ва ҳуқуқҳо на танҳо ҳангоми кушодани аввал,
балки дар ҳар амал тафтиш мешаванд. Вақте профилҳои доимӣ фаъоланд, амалҳои
computer танҳо бо пайвасти мувофиқ иҷро мешаванд. Сиёсати возеҳи шабакавии
браузер лозим аст — AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK-и муқарраршуда
(true ё false) ё рӯйхати AIHUMMER_BROWSER_ALLOWED_HOSTNAMES; cookie-ҳои
браузери беруна ворид намешаванд. Ҳар ду танзимот хатарнок ҳисобида мешаванд:
дар абри идорашаванда ва инстанси демо онҳо қулф шудаанд.
Малакаҳои муштарак
А маҳорати як дастури дубора истифодашаванда (қисмати пешниҳоди) аст, ки ба агентҳо пайваст карда мешавад. Китобхона дар интерфейси маъмурон қарор дорад Малакаҳои муштарак саҳифа: барои сохтани он, як ном ва матн кофӣ аст — шиноса (slug) ба таври автоматӣ ҳосил мешавад. Маҳоратҳое, ки аз тарафи фурӯшанда омода пешниҳод мешаванд, дорои Берун аз қуттӣ нишон; онҳо метавонанд ғайрифаъол шаванд, аммо ҳанӯз рӯйхатбандӣ мемонанд. Маҳорати пайвастшуда ба префикси устувори рӯйпурси системаи агент гузошта мешаванд.
Асбобҳои иҷозадодашуда
Аксарияти воситаҳо вақте фаъол мешаванд, ки танзимоти онҳоро пешкаш кунед. Калидҳои маъмул:
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 барои ягон чиз бо паҳлӯ иҷозат талаб кардан
таъсир — фиристодани почта, иҷрои код — дар ҳоле ки асбобҳои танҳо барои хондан баста нестанд.
Баъд ба куҷо
← Қаблӣ
Дониш / RAG
Баъдӣ →
Студияҳои лоиҳа: OpenDesign ва VoiceStudio
**Асбобҳо** ба тарзи амалҳои агент нисбат ба ҷаҳон ишора мекунад — овардани саҳифа, ҷустуҷӯ, ирсоли почта, пурсиши пойгоҳи додаҳо, эҷоди ҳуҷҷат. 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** — онҳо аз дархостҳо барои рад кардан даст мекашанд
> нишонии дохилӣ ва дигар ҳадафҳои номашруъ, бинобар ин модели мушаххас наметавонад аз онҳо истифода барад
> ба шабакаи хусусии худ бирасед.
## Профили доимии браузер
Аз рӯи пешфарз `computer` барои ҳар дархост браузери тозаро мекушояд. Аз
версияи 1.3 абзор метавонад **профили шахсии ба таври возеҳ таъиншударо**
(cookie ва сессияҳои сайтҳо) байни дархостҳо нигоҳ дорад — масалан, то корманд
кабинетҳои худро бе ҳар дафъа аз нав ворид шудан идора кунад. Профил ҳеҷ гоҳ
аз рӯи ном ё роҳ аз аргументҳои модел интихоб намешавад — танҳо аз рӯи
пайвасти возеҳи оператор:
- `AIHUMMER_BROWSER_PROFILE_SOCKET` — роҳи мутлақ ба сокети хусусии
`managed-profiles.sock`-и хидмати насбшудаи браузер; холӣ (пешфарз) —
профилҳои доимӣ хомӯшанд.
- `AIHUMMER_BROWSER_PROFILE_BINDINGS` — массиви JSON-и пайвастҳо: `profile_id`,
`tenant_id`, `user_id`, `agent_ids` ва `conversation_ids` (то 64 профил, ҳар
яке бо як соҳиб).
Профил танҳо вақте кушода мешавад, ки корбари ҷорӣ соҳиби он бошад ва агент ва
муколама дар пайваст номбар шуда бошанд; муколама бояд шахсӣ бошад, бе
иштирокчиёни дигари инсон. Соҳиб ва ҳуқуқҳо на танҳо ҳангоми кушодани аввал,
балки дар ҳар амал тафтиш мешаванд. Вақте профилҳои доимӣ фаъоланд, амалҳои
`computer` танҳо бо пайвасти мувофиқ иҷро мешаванд. Сиёсати возеҳи шабакавии
браузер лозим аст — `AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK`-и муқарраршуда
(`true` ё `false`) ё рӯйхати `AIHUMMER_BROWSER_ALLOWED_HOSTNAMES`; cookie-ҳои
браузери беруна ворид намешаванд. Ҳар ду танзимот хатарнок ҳисобида мешаванд:
дар абри идорашаванда ва инстанси демо онҳо қулф шудаанд.
## Малакаҳои муштарак
А **маҳорати** як дастури дубора истифодашаванда (қисмати пешниҳоди) аст, ки ба агентҳо пайваст карда мешавад. Китобхона дар интерфейси маъмурон қарор дорад **Малакаҳои муштарак** саҳифа: барои сохтани он, як ном ва матн кофӣ аст — шиноса (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).