Кезек учурунда агент аспаптарды чакыра алат. AiHummer орнотулган аспап
рантайми менен келет: кээ бир аспаптар демейки боюнча күйүк, башкалары сиз талап
кылынган конфигурацияны бергенде гана иштейт. Аспаптар SSRF’тен корголгон жана
тиешелүү жерде sandbox’толгон, ал эми тобокелдүү аспаптар адамдын бекитүү гейтинин
артына коюлушу мүмкүн.
Демейки боюнча иштетилген
Бул аспаптар коробкадан чыгары менен иштейт (кээ бирлери конфигурацияланган
моделге же билим базасына көз каранды).
Tool
Эмне кылат
Кантип иштетүү
web_fetch
URL’дин мазмунун алат. SSRF’тен корголгон.
Демейки боюнча күйүк
http_request
Тышкы HTTP суроосун жасайт. SSRF’тен корголгон.
Демейки боюнча күйүк
doc_generate
Документтерди жаратат (CSV / TSV / XLSX).
Демейки боюнча күйүк
image_generate / edit_image
Сүрөттөрдү жаратат же түзөтөт.
Демейки боюнча күйүк
github_get_file
GitHub репозиторийинен бир файлды алат.
Демейки боюнча күйүк
generate_pairing_code
Түзмөк жупташтыруу кодун чыгарат.
Демейки боюнча күйүк
search_knowledge
Билим базасын (RAG) издейт жана жоопторду цитаталар менен негиздейт.
Конфигурацияланган билим базасы менен
deep_research
Көп кадамдуу изилдөө жүргүзөт жана цитаталанган отчет даярдайт.
Демейки боюнча күйүк
Конфигурацияда иштетүү
Бул аспаптар сиз аларды муктаж болгон ресурска багыттамайынча өчүк бойдон калат.
Tool
Эмне кылат
Кантип иштетүү
web_search
Web’ди издейт.
SEARXNG_URL (SearXNG инстансы)
browser / computer
Chrome DevTools Protocol аркылуу чыныгы браузерди башкарат.
CLOAKBROWSER_CDP_URL (CDP, демейки порт :9222)
filesystem_read
Файлдарды окуйт, тамыр каталогунун астында sandbox’толгон.
AIHUMMER_FS_ROOT
db_query
Окуу-гана SQL сурооларын аткарат.
AIHUMMER_DB_QUERY_DSN
mail
Электрондук кат жөнөтөт жана окуйт.
SMTP / IMAP эсептик дайындары
tts
Кепти синтездейт (текстти-кепке).
AIHUMMER_TTS_URL (TTS sidecar)
code_exec
Кодду sandbox’то аткарат.
AIHUMMER_CODE_EXEC
[!DANGER]
code_execбөлүшүлгөн хосттордо демейки боюнча өчүк. Аны өзүңүз
башкарган жана ишенген чөйрөдө гана иштетиңиз, анткени ал модель жазган кодду
иштетет. Sandbox’толсо да, аны артыкчылыктуу мүмкүнчүлүк катары карагыла.
Интеграция аспаптары
Дал келген туташуу конфигурацияланганда, агент доменге-тиешелүү аспаптарды да
алат:
Tool
Эмне кылат
Кантип иштетүү
Bitrix24 CRM / task / calendar аспаптары
Bitrix24 CRM жазууларын, тапшырмаларын жана календарын окуйт жана аларга аракет кылат.
Bitrix24 туташуусу конфигурацияланган
1C (БИТ.ФИНАНС OData)
БИТ.ФИНАНС OData интерфейси аркылуу 1C эсеп дайындарын сурайт.
1C OData туташуусу конфигурацияланган
Бекитүү гейти
Каалаган аспапты адамдын-катышуусу менен бекитүү гейтинин артына коюуга болот.
Аспап аттарын AIHUMMER_APPROVAL_TOOLS ичинде тизмелеңиз; мындай аспап
иштеп баштаардан мурда оператор чакырыкты бекитиши керек. Четке кагылган чакырык
аткарылбайт.
Модель башкарган коомдук egress’ти бөгөттөө үчүн AIHUMMER_AIRGAPPED=1 коюңуз.
Бул режимде агент аспаптар аркылуу ачык интернетке жете албайт, бул эгемен же
обочолонгон жайылтуулар үчүн ылайыктуу.
AIHUMMER_AIRGAPPED=1
[!NOTE]
Орнотулган каталогдон тышкары, AiHummer каалаган OpenAPI 3.x спецификациясынан
аспаптарды синтездей алат жана каалаган MCP сервердин аспаптарын интеграция
кодусуз ача алат. Документтердин Marketplace жана Плагиндер бөлүмүн караңыз.
Кезек учурунда агент **аспаптарды** чакыра алат. AiHummer орнотулган аспап
рантайми менен келет: кээ бир аспаптар демейки боюнча күйүк, башкалары сиз талап
кылынган конфигурацияны бергенде гана иштейт. Аспаптар SSRF'тен корголгон жана
тиешелүү жерде sandbox'толгон, ал эми тобокелдүү аспаптар адамдын бекитүү гейтинин
артына коюлушу мүмкүн.
## Демейки боюнча иштетилген
Бул аспаптар коробкадан чыгары менен иштейт (кээ бирлери конфигурацияланган
моделге же билим базасына көз каранды).
| Tool | Эмне кылат | Кантип иштетүү |
|---|---|---|
| `web_fetch` | URL'дин мазмунун алат. SSRF'тен корголгон. | Демейки боюнча күйүк |
| `http_request` | Тышкы HTTP суроосун жасайт. SSRF'тен корголгон. | Демейки боюнча күйүк |
| `doc_generate` | Документтерди жаратат (CSV / TSV / XLSX). | Демейки боюнча күйүк |
| `image_generate` / `edit_image` | Сүрөттөрдү жаратат же түзөтөт. | Демейки боюнча күйүк |
| `github_get_file` | GitHub репозиторийинен бир файлды алат. | Демейки боюнча күйүк |
| `generate_pairing_code` | Түзмөк жупташтыруу кодун чыгарат. | Демейки боюнча күйүк |
| `search_knowledge` | Билим базасын (RAG) издейт жана жоопторду цитаталар менен негиздейт. | Конфигурацияланган билим базасы менен |
| `deep_research` | Көп кадамдуу изилдөө жүргүзөт жана цитаталанган отчет даярдайт. | Демейки боюнча күйүк |
## Конфигурацияда иштетүү
Бул аспаптар сиз аларды муктаж болгон ресурска багыттамайынча өчүк бойдон калат.
| Tool | Эмне кылат | Кантип иштетүү |
|---|---|---|
| `web_search` | Web'ди издейт. | `SEARXNG_URL` (SearXNG инстансы) |
| `browser` / `computer` | Chrome DevTools Protocol аркылуу чыныгы браузерди башкарат. | `CLOAKBROWSER_CDP_URL` (CDP, демейки порт `:9222`) |
| `filesystem_read` | Файлдарды окуйт, тамыр каталогунун астында sandbox'толгон. | `AIHUMMER_FS_ROOT` |
| `db_query` | Окуу-гана SQL сурооларын аткарат. | `AIHUMMER_DB_QUERY_DSN` |
| `mail` | Электрондук кат жөнөтөт жана окуйт. | SMTP / IMAP эсептик дайындары |
| `tts` | Кепти синтездейт (текстти-кепке). | `AIHUMMER_TTS_URL` (TTS sidecar) |
| `code_exec` | Кодду sandbox'то аткарат. | `AIHUMMER_CODE_EXEC` |
> [!DANGER]
> `code_exec` **бөлүшүлгөн хосттордо демейки боюнча өчүк**. Аны өзүңүз
> башкарган жана ишенген чөйрөдө гана иштетиңиз, анткени ал модель жазган кодду
> иштетет. Sandbox'толсо да, аны артыкчылыктуу мүмкүнчүлүк катары карагыла.
## Интеграция аспаптары
Дал келген туташуу конфигурацияланганда, агент доменге-тиешелүү аспаптарды да
алат:
| Tool | Эмне кылат | Кантип иштетүү |
|---|---|---|
| Bitrix24 CRM / task / calendar аспаптары | Bitrix24 CRM жазууларын, тапшырмаларын жана календарын окуйт жана аларга аракет кылат. | Bitrix24 туташуусу конфигурацияланган |
| 1C (БИТ.ФИНАНС OData) | БИТ.ФИНАНС OData интерфейси аркылуу 1C эсеп дайындарын сурайт. | 1C OData туташуусу конфигурацияланган |
## Бекитүү гейти
Каалаган аспапты **адамдын-катышуусу менен бекитүү гейтинин** артына коюуга болот.
Аспап аттарын `AIHUMMER_APPROVAL_TOOLS` ичинде тизмелеңиз; мындай аспап
иштеп баштаардан мурда оператор чакырыкты бекитиши керек. Четке кагылган чакырык
**аткарылбайт**.
```ini
# /home/.aihummer/etc/gateway.env
AIHUMMER_APPROVAL_TOOLS=mail,code_exec
```
## Air-gapped режим
Модель башкарган коомдук egress'ти бөгөттөө үчүн `AIHUMMER_AIRGAPPED=1` коюңуз.
Бул режимде агент аспаптар аркылуу ачык интернетке жете албайт, бул эгемен же
обочолонгон жайылтуулар үчүн ылайыктуу.
```ini
AIHUMMER_AIRGAPPED=1
```
> [!NOTE]
> Орнотулган каталогдон тышкары, AiHummer каалаган OpenAPI 3.x спецификациясынан
> аспаптарды синтездей алат жана каалаган MCP сервердин аспаптарын интеграция
> кодусуз ача алат. Документтердин Marketplace жана Плагиндер бөлүмүн караңыз.
## Кийинки кадам
- Бул жерде шилтемеленген өзгөрмөлөр толугу менен: [Чөйрө өзгөрмөлөрү](/en/v1.0/reference/env-vars).
- Иштеп жаткан инстансты башкарыңыз: [CLI шилтемеси](/en/v1.0/reference/cli).