Куралдар каталогу
Бир айланып жатканда агент чалса болот асбаптар. AiHummer ичинде курулган куралдардын иштөө чөйрөсүн жеткиликтирет: кээ бир куралдар демейки боюнча иштейт, башкалары талап кылынган конфигурацияны бергенде гана иштей баштайт. Куралдар SSRF коргоосу менен камсыз кылынган жана тиешелүү учурда чектелген чөйрөдө иштейт, кооптуу куралдарды адамдын макулдугу аркылуу гана колдонууга коюуга болот.
Баштапкы абалда иштетилген
Бул куралдар дароо иштейт (кээ бирлери жөндөлгөн модель же билим базасына көз каранды).
| Курал | Бул эмне кылат | Канчалык күйгүзүү |
|---|---|---|
web_fetch |
URLдин мазмунун алып келүү. SSRFтен корголгон. | Баштапкы абалда күйгүзүлгөн |
http_request |
Чыгуучу HTTP сурамын жасаңыз. SSRFден корголгон. | Баштапкы абалда күйгүзүлгөн |
web_search |
Орнотулган SearXNG аркылуу вебди издөө. | Баштапкы абалда күйгүзүлгөн (орноткуч менен бирге жеткирилет); --no-search аркылуу өчүрүлөт |
browser / computer |
Chrome DevTools протоколу аркылуу чыныгы браузерди башкаруу. | Баштапкы абалда күйгүзүлгөн (орноткуч менен бирге жеткирилет); --no-browser аркылуу өчүрүлөт |
memory_store |
Фактыны узак мөөнөттүү эс тутумда (Эйнштейн) сактоо. Жыйноо режими auto болгондо (демейки) факты дароо издөөгө жеткиликтүү; review/off болгондо жактырууну күткөн талапкер болуп калат. Натыйжада searchable_now талаасы бар. |
Баштапкы абалда күйгүзүлгөн |
memory_search |
Узак мөөнөттүү эс тутумдан (Эйнштейн) издөө. | Баштапкы абалда күйгүзүлгөн |
doc_generate |
Документтерди түзүңүз (CSV / TSV / XLSX). | Баштапкы абалда күйгүзүлгөн |
image_generate / edit_image |
Сүрөттөрдү түзүү же өңдөө. | Баштапкы абалда күйгүзүлгөн |
github_get_file |
GitHub репозиторийинен бир файлды алуу. | Баштапкы абалда күйгүзүлгөн |
generate_pairing_code |
Курулманын түйүндөө кодун чыгар. | Баштапкы абалда күйгүзүлгөн |
search_knowledge |
Билүү базасын (RAG) издөө жана жоопторду шилтемелер менен негиздөө. | Билүү базасы түзүлгөн |
deep_research |
Көп баскычтуу изилдөө жүргүзүп, шилтемелүү отчет даярдаңыз. | Баштапкы абалда күйгүзүлгөн |
docs_search |
Издөө бул документациянын оффлайн көчүрмөсү (docs.aihummer.ru скриншоты чыгарылышта жөнөтүлөт, share/docs, ru/en) — агент интернет жок эле продукт тууралуу суроолорго жооп бере алат. |
Документтердин сүрөтү бар болууда (стандарттык орнотуу) |
docs_read |
Табылган толук документтештирүү барагын окуңуз docs_search. |
Документтердин сүрөтү бар болууда (стандарттык орнотуу) |
filesystem_read |
Сервердин дискиндеги файлды окуйт же каталогдун мазмунун көрсөтөт. | Ар дайым күйүк. AIHUMMER_FS_ROOT аны күйгүзбөйт, ал болгону кум челегин тарытат: маани бош турганда, тамыр бүт сервер (/) болуп калат. |
[!DANGER] Эмне болот: агент шлюз кызматынын колдонуучусу окуй ала турган ар кандай файлды окуйт — маалымат базасына туташуу параметрлери бар файлды жана сырлар сактагычын шифрлеген ачкычты кошо. Кайсы шартта:
AIHUMMER_FS_ROOTжөндөөсү бош турганда. Бул — өз серверине орноткондон кийинки демейки абал. Кантип оңдоо керек: Башкаруу → Жөндөөлөр бөлүмүн ачып,AIHUMMER_FS_ROOTачкычын таап, агентке чындап керек болгон каталогду көрсөтүңүз (мисалы/srv/agent-files) жана сактаңыз. Маани маалымат базасында сакталат — бул ачкыч үчүнgateway.envсабы эске алынбайт. Кошумчаfilesystem_readатынAIHUMMER_APPROVAL_TOOLSтизмесине жазыңыз, ошондо ар бир чакыруу сиздин ырастооңузду күтөт.AiHummer башкарылуучу булутунда бул курал агентке таптакыр берилбейт — тамырды өз орнотууңузда гана тарытуу керек.
Конфигурацияда иштетүү
Бул куралдар керектүү ресурска багыттамайынча өчүрүлгөн абалда турат. Бардык иштетүүчү тетиктер (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) болуп саналат Параметрлер-каталог ачкычтар: аларды веб-админ UIда коюңуз (Башкаруу → Багыттоолор, ал издөө бар) же менен aihummer settings set <KEY> <VALUE>. Алардын ичине салуу gateway.env бар таасир жок — Бул ачкычтар үчүн чөйрө эске алынбайт.
| Курал | Бул эмне кылат | Канчалык күйгүзүү |
|---|---|---|
db_query |
Факты катары гана SQL сурамдарын иштетиңиз. | AIHUMMER_DB_QUERY_DSN |
mail |
Электрондук кат жибер жана оку. | SMTP / IMAP күбөлүктөрү |
tts |
Дыбыс жарат (тексттен-дыбыска). | AIHUMMER_TTS_URL (TTS сайдкар) |
code_exec |
Кодду пескобокста аткарыңыз. | AIHUMMER_CODE_EXEC |
[!DANGER]
code_execболот жалпысына бөлүшүлгөн хосттордо анын иштөөсү демейки боюнча өчүрүлгөн. Аны болгону гана иштет сиз көзөмөлдөп, ишенген чөйрө, анткени анда модель тарабынан жазылган код иштейт. Андан башка чектелген аймакта болсун, муну артыкчылыктуу мүмкүнчүлүк катары карагыла.
Интеграция куралдары
Үйлөшүп турган байланыш орнотулгандан кийин, агент ошондой эле домен куралдарын алат:
| Курал | Бул эмне кылат | Канчалык күйгүзүү |
|---|---|---|
| Bitrix24 CRM / тапшырма / календарь куралдары | Bitrix24 CRM жазууларын, тапшырмаларын жана күн тартибин окуп, иштеңиз. | Bitrix24 туташуусу конфигурацияланды |
| 1C (БИТ.ФИНАНС OData) | БИТ.ФИНАНС OData интерфейси аркылуу 1C эсептик маалыматтарды суроо. | 1C OData байланышы конфигурацияланды |
Approval gate
Кандай гана курал болбосун артына коюлушу мүмкүн адам аралашкан бекитүүчү эшик. Куралдардын аттарын тизмелеңиз AIHUMMER_APPROVAL_TOOLS жөндөө (веб админ UI: Башкаруу → Жөндөөлөр); мындай курал иштебей турган мурун, оператор чалууну бекитиши керек. Кайтарылган чалу эмес аткарылды.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_execАба бөлүү режими
Орнотуу AIHUMMER_AIRGAPPED жооп кылууга 1 модель тарабынан башкарылган коомдук чыгууга тоскоол болуу үчүн. Бул режимде агент куралдардын жардамы менен ачык интернетке жете албайт, бул суверендүү же изоляцияланган жайгаштыруулар үчүн ылайыктуу.
aihummer settings set AIHUMMER_AIRGAPPED 1[!NOTE] Курсурдагы каталогдон тышкары, AiHummer каалаган OpenAPI 3.x негизиндеги куралдарды синтездей алат ар кандай MCP серверинин куралдарын спецификациялап жана көрсөтүңүз, интеграция коду жок. Көрүңүз Документтердеги Маркетплейс жана Плагиндер бөлүмү.
Келерки кайда
- Бул жерде толугу менен көрсөтүлгөн өзгөрмөлөр: Айлана-чөйрө өзгөрмөлүүлөр.
- Жүрүп жаткан версияны башкаруу: CLI колдонмосу.