Аспаптар — AiHummer Документация

Аспаптар — бул агенттин дүйнөгө аракет кылуу ыкмасы: бетти алуу, издөө, почта жөнөтүү, маалымат базасына суроо берүү, документ түзүү. AiHummer бай орнотулган каталогду жана Tool Runtime’ди жеткирет, ал аспаптар конфигурацияланганда аларды иштетет, аларды өчүрүп-күйгүзбөстөн кайра жүктөйт, коркунучтууларын адам бекитүүсүнүн артына коёт жана air-gapped режимде чыгууну толугу менен бекитет.

Бул бет рантайм кантип жүрөөрүн камтыйт жана орнотулгандарды тизмелейт. Толук шилтеме үчүн аспаптар каталогун карагыла.

Tool Runtime кантип жүрөт

Конфигурацияда иштетүү. Аспап анын алдын ала шарты болгон конфигурация бар болгондо гана жеткиликтүү болот — адатта ага керектүү кызматка багытталган чөйрө өзгөрмөсү. Конфигурация жок, аспап жок.
Ысык кайра жүктөө. Аспапты иштетүү шлюзду өчүрүп-күйгүзбөстөн ысык колдонулат, ошентип сиз жөндөмдөрдү рантаймда күйгүзүп-өчүрө аласыз.
Бекитүү дарбазасы. Коркунучтуу аспаптар AIHUMMER_APPROVAL_TOOLS аркылуу адам катышкан бекитүү дарбазасынын артына коюлушу мүмкүн. Четке кагылган чакырык аткарылбайт.
Air-gapped режим. 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 sidecar
`image_generate` / `edit_image`	Сүрөттөрдү түзүү жана түзөтүү	конфигурацияланган сүрөт бэкэнди
`github_get_file`	GitHub’дан файл алуу	демейки боюнча күйүк
`generate_pairing_code`	Түзмөк жупташтыруу кодун чыгаруу	демейки боюнча күйүк
`search_knowledge` / `deep_research`	Билим алуу жана көп кадамдуу изилдөө	билим базасы
Bitrix24 CRM / тапшырма / календарь	Bitrix24 CRM, тапшырма жана календарь аракеттери	Bitrix24 плагини
1C (БИТ.ФИНАНС OData)	OData аркылуу 1C БИТ.ФИНАНС мүмкүндүгү	1C OData конфигурациясы

[!NOTE] web_fetch жана http_request SSRF менен корголгон — алар ички даректерге жана башка коопсуз эмес максаттарга суроолорду четке кагат, ошентип модель аларды сиздин жеке тармагыңызга жетүү үчүн колдоно албайт.

Жалпы көндүмдөр

Көндүм — бул агенттерге тиркелчү кайра колдонула турган нускама (промпттун бир кесими). Китепкана админ UI’дин «Жалпы көндүмдөр» барагында жашайт: көндүм түзүү үчүн ат жана текст жетиштүү — идентификатор (slug) автоматтык түрдө чыгарылат. Вендор кутудан чыгары жеткирген көндүмдөр «Кутудан чыгары» значогун алып жүрөт; аларды өчүрүүгө болот, бирок алар тизмеде кала берет. Тиркелген көндүмдөр агенттин система промптунун туруктуу префиксине түшөт.

Аспаптарды иштетүү

Аспаптардын көбү сиз алардын конфигурациясын бергениңизде күйөт. Жалпы которгучтар:

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 колдонгула, ал эми окуу гана аспаптарды дарбазасыз калтыргыла.

Кийинки кадам

Ар бир аспап боюнча толук шилтемени аспаптар каталогунан карагыла.
Бул аспаптарды чакырган циклди Оркестрация жана суб-агенттер бетинен түшүнгүлө.
Аспап жоопторун документтериңизге Билим / RAG бети менен негиздегиле.