Куралдар
Куралдар бул агент дүйнөгө кандай аракет кыларын көрсөтөт — бет алат, издейт, кат жөнөтөт, базадан суроо салат, документ түзөт. 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 же HTML документин түзүү. | адатта күйгүзүлгөн |
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бар СССР тарабынан корголгон — алар суранууларды четке кагышат ички даректери жана башка коопсуз эмес максаттар, андыктан модел аларды колдонуу мүмкүн эмес жеке тармагыңызга жетүү.
Туруктуу браузер профили
Демейки боюнча computer ар бир суроо-талапка таза браузер ачат. 1.3
версиясынан баштап курал так дайындалган жеке профилди (cookie жана сайт
сессиялары) суроо-талаптардын ортосунда сактай алат — мисалы, кызматкер ар
жолу кайра кирбестен өз кабинеттерин жүргүзүшү үчүн. Профиль эч качан модель
аргументтериндеги ат же жол боюнча тандалбайт — оператордун так байланышы
боюнча гана:
AIHUMMER_BROWSER_PROFILE_SOCKET— орнотулган браузер кызматынын жекеmanaged-profiles.sockсокетине абсолюттук жол; бош (демейки) — туруктуу профилдер өчүрүлгөн.AIHUMMER_BROWSER_PROFILE_BINDINGS— байланыштардын JSON массиви:profile_id,tenant_id,user_id,agent_idsжанаconversation_ids(64кө чейин профиль, ар биринин бир ээси).
Профиль учурдагы колдонуучу анын ээси болгондо жана агент менен диалог
байланышта тизмеленгенде гана ачылат; диалог башка адам катышуучуларсыз
жеке болушу керек. Ээси жана укуктар биринчи ачууда гана эмес, ар бир
аракетте текшерилет. Туруктуу профилдер күйгүзүлгөндө computer аракеттери
ылайыктуу байланыш менен гана аткарылат. Браузердин так тармак саясаты
керек — коюлган AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK (true же false) же
AIHUMMER_BROWSER_ALLOWED_HOSTNAMES тизмеси; тышкы браузердин cookie файлдары
импорттолбойт. Эки жөндөө тең коркунучтуу деп эсептелет: башкарылуучу
булутта жана демо-инстанста алар кулпуланган.
Бөлүшүлгөн көндүмдөр
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 tools
AIHUMMER_AIRGAPPED=1 # block model-controlled public egress
[!TIP] Колдонуу
AIHUMMER_APPROVAL_TOOLSбир нерсеге кошумча талап үчүн макулдашуу сурап таасир — почта жөнөтүү, кодду иштетүү — окууга гана уруксат берген куралдарды тоскочсуз калтырып.
Келерки кайда
- Ар бир курал боюнча толук шилтемени караңыз куралдар каталогу.
- Бул куралдарды чакырган циклди түшүнүңүз Оркестрация жана суб-агенттер.
- Сиздин документтердеги жоопторду негизги курал менен камсыз кылат Билүү / RAG.
HTML документтери
Агент doc_generate жана format: "html" аркылуу 4 МиБ чейин UTF-8 HTML тиркемесин түзөт. CSS жана JavaScript сакталат. Шайкеш жаңыртылган колдонмо булакты жана бүтүндүктү текшерип, сакталган файлды обочолонгон алдын ала кароодо ачат. Колдонмонун кирүү маалыматтары берилбейт; файл, булак же сеанс өзгөрсө, кароо жараксыз болот.