Куралдар бул агент дүйнөгө кандай аракет кыларын көрсөтөт — бет алат, издейт, кат жөнөтөт, базадан суроо салат, документ түзөт. AiHummer бай киргизилген каталог жана бир Куралдын иштөө убактысы бул куралдар конфигурацияланганда мүмкүнчүлүктөрүн ачат, кайра баштоосуз кайра жүктөйт, тобокелдүү куралдарды адамдын уруксаты аркылуу тейлейт жана аба ажыратылган режимде чыгышты толук бөгөй алат.
Бул баракча процесс учурунда кандай иштей турганын жана орнотулган функцияларды камтыйт. Толук справка үчүн караңыз куралдар каталогу.
Курал убакыт режиминде кантип жүрөт
Иштетүү-дөөлөтү конфигурацияда. Курал анын алдын ала шарттары аткарылганда гана жеткиликтүү болот
конфигурация бар — адатта чөйрө өзгөрмөсү муну көрсөтөт
керектүү кызмат. Параметр жок, курал жок.
Ысык жүктөө. Куралды иштетүү колдонулат ысык, кайра баштамай туруп
Шлюз, анын жардамы менен сиз мүмкүнчүлүктөрдү иштөө учурунда күйгүзүп жана өчүрө аласыз.
Маалымат берүү дарбазасы. Өнөкөт куралдар адам-өлчөм процессинин артында жайгаштырылышы мүмкүн
маанилүү жол аркылуу бекитүү AIHUMMER_APPROVAL_TOOLS. Чакырууну четке каккан эмес
аткарылды.
Аба мейкиндигинен ажыратылган режим. Орнотуу AIHUMMER_AIRGAPPED=1 блоктор модел тарабынан башкарылат
жалпы кирүү, суверендүү же изоляцияланган жайылтуулар үчүн.
[!WARNING]
code_exec болот адатта өчүрүлгөн жарандык хосттордо. Аны гана жерде иштетүү
sandbox жана host модель тарабынан жазылган кодду иштетүүгө ылайыктуу, жана карап көрүңүз
аны бекитүү эшигинин артында коюу.
Ички аспаптар
Курал
Бул эмне кылат
Иштетүү менен
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
Билдирүүнү алуу жана көп баскычтуу изилдөө
билим базасы
Bitrix24 CRM / тапшырма / календарь
Bitrix24 CRM, тапшырма жана календарь аракеттери
Bitrix24 плагини
1C (БИТ.ФИНАНС OData)
1C БИТ.ФИНАНС OData аркылуу кирүү
1C OData конфигурациясы
[!NOTE]
web_fetch жана http_request бар СССР тарабынан корголгон — алар суранууларды четке кагышат
ички даректери жана башка коопсуз эмес максаттар, андыктан модел аларды колдонуу мүмкүн эмес
жеке тармагыңызга жетүү.
Бөлүшүлгөн көндүмдөр
A ышмандык бул агенттерге тиркелиши мүмкүн болгон кайталап колдонулчу көрсөтмө (сүрөттөмө бөлүгү). Китепкана админ UIда жайгашкан «Бөлүшүлгөн көндүмдөр» барак: бирин түзүү үчүн, аталышы жана текст эле жетиштүү — идентификатор (слуг) автоматтык түрдө алынат. Вендор тарабынан даяр абалда берилген көндүмдөрдө Кутудан чыккандай бейдж; алар өчүрүлүшү мүмкүн, бирок тизмеде калат. Тиркелген көндүмдөр агенттин тутумдук билдирүүсүнүн туруктуу префиксинде көрсөтүлөт.
Куралдарды күйгүзүү
Көпчүлүк куралдар алардын конфигурациясын бергенде күйгүзүлөт. Жөнөкөй которгучтар:
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 toolsAIHUMMER_AIRGAPPED=1 # block model-controlled public egress
[!TIP]
Колдонуу AIHUMMER_APPROVAL_TOOLS бир нерсеге кошумча талап үчүн макулдашуу сурап
таасир — почта жөнөтүү, кодду иштетүү — окууга гана уруксат берген куралдарды тоскочсуз калтырып.
Сиздин документтердеги жоопторду негизги курал менен камсыз кылат
Билүү / RAG.
**Куралдар** бул агент дүйнөгө кандай аракет кыларын көрсөтөт — бет алат, издейт, кат жөнөтөт, базадан суроо салат, документ түзөт. AiHummer бай **киргизилген каталог** жана бир **Куралдын иштөө убактысы** бул куралдар конфигурацияланганда мүмкүнчүлүктөрүн ачат, кайра баштоосуз кайра жүктөйт, тобокелдүү куралдарды адамдын уруксаты аркылуу тейлейт жана аба ажыратылган режимде чыгышты толук бөгөй алат.
Бул баракча процесс учурунда кандай иштей турганын жана орнотулган функцияларды камтыйт. Толук справка үчүн караңыз [куралдар каталогу](/ky/v1.0/reference/tools-catalog).
## Курал убакыт режиминде кантип жүрөт
- **Иштетүү-дөөлөтү конфигурацияда.** Курал анын алдын ала шарттары аткарылганда гана жеткиликтүү болот
конфигурация бар — адатта чөйрө өзгөрмөсү муну көрсөтөт
керектүү кызмат. Параметр жок, курал жок.
- **Ысык жүктөө.** Куралды иштетүү колдонулат **ысык**, кайра баштамай туруп
Шлюз, анын жардамы менен сиз мүмкүнчүлүктөрдү иштөө учурунда күйгүзүп жана өчүрө аласыз.
- **Маалымат берүү дарбазасы.** Өнөкөт куралдар адам-өлчөм процессинин артында жайгаштырылышы мүмкүн
маанилүү жол аркылуу бекитүү `AIHUMMER_APPROVAL_TOOLS`. Чакырууну четке каккан **эмес**
аткарылды.
- **Аба мейкиндигинен ажыратылган режим.** Орнотуу `AIHUMMER_AIRGAPPED=1` блоктор модел тарабынан башкарылат
жалпы кирүү, суверендүү же изоляцияланган жайылтуулар үчүн.
> [!WARNING]
> `code_exec` болот **адатта өчүрүлгөн** жарандык хосттордо. Аны гана жерде иштетүү
> sandbox жана host модель тарабынан жазылган кодду иштетүүгө ылайыктуу, жана карап көрүңүз
> аны бекитүү эшигинин артында коюу.
## Ички аспаптар
| Курал | Бул эмне кылат | Иштетүү менен |
|---|---|---|
| `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` | Билдирүүнү алуу жана көп баскычтуу изилдөө | билим базасы |
| Bitrix24 CRM / тапшырма / календарь | Bitrix24 CRM, тапшырма жана календарь аракеттери | Bitrix24 плагини |
| 1C (БИТ.ФИНАНС OData) | 1C БИТ.ФИНАНС OData аркылуу кирүү | 1C OData конфигурациясы |
> [!NOTE]
> `web_fetch` жана `http_request` бар **СССР тарабынан корголгон** — алар суранууларды четке кагышат
> ички даректери жана башка коопсуз эмес максаттар, андыктан модел аларды колдонуу мүмкүн эмес
> жеке тармагыңызга жетүү.
## Бөлүшүлгөн көндүмдөр
A **ышмандык** бул агенттерге тиркелиши мүмкүн болгон кайталап колдонулчу көрсөтмө (сүрөттөмө бөлүгү). Китепкана админ UIда жайгашкан **«Бөлүшүлгөн көндүмдөр»** барак: бирин түзүү үчүн, аталышы жана текст эле жетиштүү — идентификатор (слуг) автоматтык түрдө алынат. Вендор тарабынан даяр абалда берилген көндүмдөрдө **Кутудан чыккандай** бейдж; алар өчүрүлүшү мүмкүн, бирок тизмеде калат. Тиркелген көндүмдөр агенттин тутумдук билдирүүсүнүн туруктуу префиксинде көрсөтүлөт.
## Куралдарды күйгүзүү
Көпчүлүк куралдар алардын конфигурациясын бергенде күйгүзүлөт. Жөнөкөй которгучтар:
```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` бир нерсеге кошумча талап үчүн макулдашуу сурап
> таасир — почта жөнөтүү, кодду иштетүү — окууга гана уруксат берген куралдарды тоскочсуз калтырып.
## Келерки кайда
- Ар бир курал боюнча толук шилтемени караңыз
[куралдар каталогу](/ky/v1.0/reference/tools-catalog).
- Бул куралдарды чакырган циклди түшүнүңүз
[Оркестрация жана суб-агенттер](/ky/v1.0/concepts/orchestration-subagents).
- Сиздин документтердеги жоопторду негизги курал менен камсыз кылат
[Билүү / RAG](/ky/v1.0/concepts/knowledge-rag).