Куралдар каталогу
Бир айланып жатканда агент чалса болот асбаптар. 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 же HTML документин түзүү. | Баштапкы абалда күйгүзүлгөн |
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 |
Сервердин дискиндеги файлды окуйт же каталогдун мазмунун көрсөтөт. | Демейкиде — агенттин өз жумуш папкасы; хостко кирүү үчүн ээси ушул агенттин обочолонтуу режимин ачык тандашы керек. Башкарылуучу булутта жана демодо жеткиликсиз. |
[!NOTE]
AIHUMMER_FS_ROOTуруксат берилген түпкү каталогду кошумча чектейт; бош маани бүт серверге кирүү бербейт. Орнотуунун жөндөөлөрү, маалымат базасына кирүү маалыматтары жана шифрлөө ачкычтары, ошондой эле процесстердин чөйрөсү окулбайт. Ырастоо уруксат берилген файл чөйрөсүн кеңейтпейт.
Конфигурацияда иштетүү
Бул куралдар керектүү ресурска багыттамайынча өчүрүлгөн абалда турат. Бардык иштетүүчү тетиктер (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 колдонмосу.
HTML документтери
Агент doc_generate жана format: "html" аркылуу 4 МиБ чейин UTF-8 HTML тиркемесин түзөт. CSS жана JavaScript сакталат. Шайкеш жаңыртылган колдонмо булакты жана бүтүндүктү текшерип, сакталган файлды обочолонгон алдын ала кароодо ачат. Колдонмонун кирүү маалыматтары берилбейт; файл, булак же сеанс өзгөрсө, кароо жараксыз болот.