Alətlər Kataloqu
Dönüş zamanı agent zəng edə bilər alətlər. AiHummer daxili alət iş vaxtı göndərir: bəzi alətlər standart olaraq açıqdır, digərləri isə yalnız tələb olunan konfiqurasiyanı təmin etdiyiniz zaman aktivləşir. Alətlər SSRF-dən qorunur və müvafiq olduqda sandbox-da işləyir, riskli alətlər isə insan təsdiqi qapısı arxasında yerləşdirilə bilər.
Defolt üzrə aktivdir
Bu alətlər hazır vəziyyətdə işləyir (bəziləri konfiqurasiya edilmiş modelə və ya məlumat bazasına bağlıdır).
| Alət | Nə edir | Necə aktivləşdirmək |
|---|---|---|
web_fetch |
URL-in məzmununu əldə edin. SSRF qorunur. | Defolt üzrə açıq |
http_request |
Çıxış HTTP sorğusu göndərin. SSRF tərəfindən qorunur. | Defolt üzrə açıq |
web_search |
Daxili SearXNG vasitəsilə vebdə axtarış edin. | Defolt üzrə açıq (quraşdırıcı ilə birlikdə gəlir); --no-search ilə söndürün |
browser / computer |
Chrome DevTools protokolu vasitəsilə real brauzeri idarə edin. | Defolt üzrə açıq (quraşdırıcı ilə birlikdə gəlir); --no-browser ilə söndürün |
memory_store |
Faktı uzunmüddətli yaddaşda (Einstein) saxlayın. Yığım rejimi auto (susmaya görə) olduqda fakt dərhal axtarıla bilir; review/off olduqda təsdiq gözləyən namizəd olur. Nəticə searchable_now sahəsi daşıyır. |
Defolt üzrə açıq |
memory_search |
Uzunmüddətli yaddaşda (Einstein) axtarış edin. | Defolt üzrə açıq |
doc_generate |
Sənədlər yaradın (CSV / TSV / XLSX). | Defolt üzrə açıq |
image_generate / edit_image |
Şəkillər yaradın və ya redaktə edin. | Defolt üzrə açıq |
github_get_file |
GitHub deposundan tək bir faylı götürün. | Defolt üzrə açıq |
generate_pairing_code |
Cihaz bağlama kodu verin. | Defolt üzrə açıq |
search_knowledge |
Bilik bazasında (RAG) axtarış edin və cavabları istinadlarla əsaslandırın. | Bilik bazası konfiqurasiya olunmuş vəziyyətdə |
deep_research |
Çoxmərhələli tədqiqat aparın və istinad edilmiş hesabat hazırlayın. | Defolt üzrə açıq |
docs_search |
Axtar bu sənədlərin oflayn nüsxəsi (release-də docs.aihummer.ru snapshot göndərilir, share/docs, ru/en) — agent internet olmadan məhsul suallarını cavablandıra bilər. |
Sənədlər anlıq görüntüsü mövcud olduqda (standart quraşdırma) |
docs_read |
Tapılan tam sənədlər səhifəsini oxuyun docs_search. |
Sənədlər anlıq görüntüsü mövcud olduqda (standart quraşdırma) |
filesystem_read |
Serverin diskindəki faylı oxuyur və ya qovluğun tərkibini göstərir. | Həmişə açıqdır. AIHUMMER_FS_ROOT onu açmır, yalnız qum qutusunu daraldır: dəyər boş olduğu müddətdə qum qutusunun kökü bütün serverdir (/). |
[!DANGER] Nə baş verəcək: agent şlüz xidmətinin istifadəçisinin oxuya bildiyi istənilən faylı oxuyacaq — verilənlər bazasına qoşulma parametrləri olan fayl və sirlər anbarını şifrələyən açar da daxil olmaqla. Hansı şərtdə:
AIHUMMER_FS_ROOTparametri boş olduğu müddətdə. Bu, öz serverinizə quraşdırmadan dərhal sonrakı standart vəziyyətdir. Necə düzəltmək: İdarəetmə → Parametrlər bölməsini açın,AIHUMMER_FS_ROOTaçarını tapın, agentin həqiqətən ehtiyac duyduğu qovluğu göstərin (məsələn/srv/agent-files) və yadda saxlayın. Dəyər verilənlər bazasında saxlanılır — bu açar üçüngateway.envsətri nəzərə alınmır. Əlavə olaraqfilesystem_readadınıAIHUMMER_APPROVAL_TOOLSsiyahısına yazın ki, hər çağırış sizin təsdiqinizi gözləsin.AiHummer-in idarə olunan buludunda bu alət agentə ümumiyyətlə verilmir — kökü yalnız öz quraşdırmanızda daraltmaq lazımdır.
Konfiqurasiyada aktiv edin
Bu alətlər ehtiyac duyduqları resursa göstəriş verənədək söndürüldükdə qalırlar. Bütün aktivləşdirən düymələr (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) olurlar Parametrlər-kataloq açarlar: onları veb idarəetmə UI-də təyin edin (İdarəetmə → Parametrlər, onun axtarışı var) və ya ilə aihummer settings set <KEY> <VALUE>. Onları yerləşdirmək gateway.env var təsirsiz — bu açarlar üçün mühit nəzərə alınmır.
| Alət | Nə edir | Necə aktivləşdirmək |
|---|---|---|
db_query |
Yalnız oxumaq üçün SQL sorğularını işə salın. | AIHUMMER_DB_QUERY_DSN |
mail |
E-poçt göndərin və oxuyun. | SMTP / IMAP giriş məlumatları |
tts |
Nitqi sintez etmək (mətn-dan-nitqə). | AIHUMMER_TTS_URL (TTS yan maşını) |
code_exec |
Kodu qum qutusunda işə sal. | AIHUMMER_CODE_EXEC |
[!DANGER]
code_execdır paylaşılan hostlarda standart olaraq deaktivdir. Yalnız onu bir mühitə siz nəzarət edir və inanırsınız, çünki bu, model tərəfindən yaradılmış kodu işlədir. Hətta qum qutusuna salınmış, bunu üstünlük verilən bir qabiliyyət kimi qəbul edin.
İnteqrasiya vasitələri
Uyğun bağlantı qurulduqda, agent həmçinin domen alətləri alır:
| Alət | Nə edir | Necə aktivləşdirmək |
|---|---|---|
| Bitrix24 CRM / tapşırıq / təqvim alətləri | Bitrix24 CRM qeydlərini, tapşırıqları və təqvimi oxuyun və onlara əməl edin. | Bitrix24 əlaqəsi qurulub |
| 1C (BİT.FİNANS OData) | БИТ.ФИНАНС OData interfeysi vasitəsilə 1C uçot məlumatlarını sorğulamaq. | 1C OData bağlantısı konfiqurasiya edildi |
Təsdiq qapısı
Hər hansı bir alət arxaya qoyula bilər insan-nəzarətli təsdiq qapısı. Alət adlarını siyahıya alın AIHUMMER_APPROVAL_TOOLS ayar (veb admin UI: İdarəetmə → Ayarlar); belə bir alət işləmədən əvvəl operator zəngi təsdiqləməlidir. Rədd edilmiş zəng yox icra olundu.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
Hava əlaqəsi olmayan rejim
Quraşdır AIHUMMER_AIRGAPPED təyin etməyə 1 Model tərəfindən idarə olunan ictimai çıxışı bloklamaq üçün. Bu rejimdə agent alətlər vasitəsilə açıq internetə çıxa bilmir, bu isə suveren və ya izolyasiya olunmuş yerləşdirmələr üçün uyğundur.
aihummer settings set AIHUMMER_AIRGAPPED 1
[!NOTE] Quraşdırılmış kataloqdan kənarda, AiHummer hər hansı OpenAPI 3.x-dən alətləri sintez edə bilər Hər hansı MCP serverinin alətlərini heç bir inteqrasiya kodu olmadan göstərin və ifşa edin. Baxın Sənədlərin Marketplace və Pluginlər bölməsi.
Növbəti haradır
- Burada tam olaraq istinad olunan dəyişənlər: Ətraf mühit dəyişənləri.
- İşləyən nümunəni idarə edin: CLI istinadı.