Үндсэн ойлголтууд/Хэрэгсэл
Хэрэгсэл
v1.2.x · шинэчилсэн 2026-06-26
Хэрэгсэл нь т агент дэлхий дээр хэрхэн үйлдэл хийдэгийг — хуудас татах, хайлт хийх, имэйл илгээх, өгөгдлийн сангийн лавлагаа авах, баримт бичиг үүсгэх. AiHummer баялагтай хамт ирдэг оролттой каталог мөн нэг Багажийн гүйцэтгэл энэ нь багаж хэрэгслийг тохируулсан үед идэвхжүүлж, дахин ачаалалгүйгээр дахин ачаалж, эрсдэлтэйг хүний зөвшөөрлийн ард хаадаг бөгөөд агаарын тасалдсан горимд гаралтыг бүрэн түгжиж чаддаг.
Энэхүү хуудсанд гүйцэтгэл хэрхэн ажилладаг болон дотоод функцуудын жагсаалт багтсан. Бүрэн лавлахын хувьд, харах багаж хэрэгслийн каталог.
Төхөөрөмжийн Runtime хэрхэн аашилдаг
- Тохиргоонд идэвхжүүлэх. Төхөөрөмж нь зөвхөн шаардлагатай нөхцөл биелсэн тохиолдолд ашиглахад бэлэн болдог
конфигураци байгаа — ихэвчлэн орчны хувьсагч үүнд зааж өгдөг
Тухайн үйлчилгээ шаардлагатай. Тохиргоо шаардлагагүй, хэрэгсэл шаардлагагүй.
- Дулаан дахин ачааллах. Хэрэгслийг идэвхжүүлэх үйлчилнэ халуун, дахин эхлүүлэхгүйгээр
гүүрэн хаалга, ингэснээр та чадваруудыг ажиллах үед асааж унтрааж болно.
- Зөвшөөрлийн хаалга. Эрсдэлтэй хэрэгслүүдийг хүний оролцоо бүхий процессийн ард байрлуулж болно
хууль ёсны зөвшөөрлийн хаалга дамжуулан
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 бол SSRF-тай хамгаалагдсан — тэд хүсэлтийг татгалздаг
дотоод хаягууд ба бусад аюултай зорилтууд, тиймээс загвар тэдгээрийг ашиглаж чадахгүй
таны хувийн сүлжээнд хүрэх.
Хуваалцсан ур чадвар
А ур чадвар нь төлөөлөгчдийг холбож ашиглах боломжтой дахин ашиглах заавар (туруун хэсэг) юм. Тус номын сан нь удирдлагын UI дээр байдаг Хуваалцсан ур чадвар хуудас: үүсгэхийн тулд нэг нэр ба текст хангалттай — таних тэмдэг (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 ямар ч зүйлд талтай байхыг зөвшөөрөл шаардах
нөлөө — захидал илгээх, код ажиллуулах — зөвхөн унших боломжтой хэрэгслүүдийг хаалгүйгээр.
Дараа хаашаа явах вэ
**Хэрэгсэл** нь т агент дэлхий дээр хэрхэн үйлдэл хийдэгийг — хуудас татах, хайлт хийх, имэйл илгээх, өгөгдлийн сангийн лавлагаа авах, баримт бичиг үүсгэх. AiHummer баялагтай хамт ирдэг **оролттой каталог** мөн нэг **Багажийн гүйцэтгэл** энэ нь багаж хэрэгслийг тохируулсан үед идэвхжүүлж, дахин ачаалалгүйгээр дахин ачаалж, эрсдэлтэйг хүний зөвшөөрлийн ард хаадаг бөгөөд агаарын тасалдсан горимд гаралтыг бүрэн түгжиж чаддаг.
Энэхүү хуудсанд гүйцэтгэл хэрхэн ажилладаг болон дотоод функцуудын жагсаалт багтсан. Бүрэн лавлахын хувьд, харах [багаж хэрэгслийн каталог](/mn/v1.0/reference/tools-catalog).
## Төхөөрөмжийн Runtime хэрхэн аашилдаг
- **Тохиргоонд идэвхжүүлэх.** Төхөөрөмж нь зөвхөн шаардлагатай нөхцөл биелсэн тохиолдолд ашиглахад бэлэн болдог
конфигураци байгаа — ихэвчлэн орчны хувьсагч үүнд зааж өгдөг
Тухайн үйлчилгээ шаардлагатай. Тохиргоо шаардлагагүй, хэрэгсэл шаардлагагүй.
- **Дулаан дахин ачааллах.** Хэрэгслийг идэвхжүүлэх үйлчилнэ **халуун**, дахин эхлүүлэхгүйгээр
гүүрэн хаалга, ингэснээр та чадваруудыг ажиллах үед асааж унтрааж болно.
- **Зөвшөөрлийн хаалга.** Эрсдэлтэй хэрэгслүүдийг хүний оролцоо бүхий процессийн ард байрлуулж болно
хууль ёсны зөвшөөрлийн хаалга дамжуулан `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` бол **SSRF-тай хамгаалагдсан** — тэд хүсэлтийг татгалздаг
> дотоод хаягууд ба бусад аюултай зорилтууд, тиймээс загвар тэдгээрийг ашиглаж чадахгүй
> таны хувийн сүлжээнд хүрэх.
## Хуваалцсан ур чадвар
А **ур чадвар** нь төлөөлөгчдийг холбож ашиглах боломжтой дахин ашиглах заавар (туруун хэсэг) юм. Тус номын сан нь удирдлагын UI дээр байдаг **Хуваалцсан ур чадвар** хуудас: үүсгэхийн тулд нэг нэр ба текст хангалттай — таних тэмдэг (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` ямар ч зүйлд талтай байхыг зөвшөөрөл шаардах
> нөлөө — захидал илгээх, код ажиллуулах — зөвхөн унших боломжтой хэрэгслүүдийг хаалгүйгээр.
## Дараа хаашаа явах вэ
- Бүх хэрэгслийн лавлагааг эндээс үзнэ үү
[багаж хэрэгслийн каталог](/mn/v1.0/reference/tools-catalog).
- Эдгээр хэрэгслийг дуудаж байгаа давталтыг ойлгох
[Оркестраци ба дэд агентууд](/mn/v1.0/concepts/orchestration-subagents).
- Таны баримт бичгүүдэд үндэслэн хэрэгслийн хариултууд
[Мэдлэг / RAG](/mn/v1.0/concepts/knowledge-rag).