Alətlər
Alətlər bir agentin dünyaya necə təsir göstərdiyidir — bir səhifə götürmək, axtarmaq, mail göndərmək, verilənlər bazasına sorğu vermək, sənəd yaratmaq. AiHummer zəngin bir funksionallıqla göndərilir daxili kataloq və bir Alət İş Vaxtı bu, vasitələr konfiqurasiya edildikdə onları aktiv edir, yenidən başlatmadan yenidən yükləyir, riskli olanları insan təsdiqi arxasında saxlayır və hava-sıxılmış rejimdə çıxışı tamamilə kilidləyə bilər.
Bu səhifə icra müddətinin necə davrandığını izah edir və daxili funksiyaları siyahıya alır. Tam istinad üçün baxın alətlər kataloqu.
Alətin İşləmə Vaxtı necə davranaır
- Konfiqurasiyada aktivləşdir. Bir alət yalnız onun əvvəlcədən tələb olunanı olduqda mövcud olur konfiqurasiya mövcuddur — adətən bir ətraf mühit dəyişəni ona işarə edir xidmətə ehtiyacı var. Konfiqurasiya yoxdur, alət yoxdur.
- İsti yeniləmə. Alət aktivləşdirmə tətbiq olunur isti, yenidən başlamadan şlüz, beləliklə işləmə zamanı imkanları açıb bağlaya bilərsiniz.
- Təsdiq qapısı. Riskli alətlər insan-dövrəsində arxada yerləşdirilə bilər
təsdiq qapısı vasitəsilə
AIHUMMER_APPROVAL_TOOLS. Rədd edilmiş zəng yox icra olundu. - Hava ayırmalı rejim. Parametrlər
AIHUMMER_AIRGAPPED=1bloklar model ilə idarə olunur public çıxış, suveren və ya təcrid olunmuş yerləşdirmələr üçün.
[!WARNING]
code_execdır varsayılan olaraq söndürülüb paylaşılan hostlarda. Yalnız orada aktiv edin ki sandbox və host model tərəfindən yazılan kodu işlətmək üçün qəbul ediləndir və nəzərə alın bunu təsdiq qapısının arxasına qoymaq.
Daxili alətlər
| Alət | Nə edir | İlə aktiv edin |
|---|---|---|
web_fetch |
URL-i gətirin (SSRF-dən qorunan) | varsayılan olaraq açıq |
http_request |
HTTP sorğusu həyata keçirin (SSRF-mühafizəli) | varsayılan olaraq açıq |
web_search |
Daxili SearXNG vasitəsilə veb axtarış | varsayılan olaraq açıq; quraşdırıcı bayrağı --no-search ilə söndürün |
browser |
Həqiqi brauzeri CDP üzərindən idarə edin | varsayılan olaraq açıq; quraşdırıcı bayrağı --no-browser ilə söndürün |
computer |
CDP üzərində kompüter istifadəsi | varsayılan olaraq açıq; quraşdırıcı bayrağı --no-browser ilə söndürün |
memory_store |
Faktı uzunmüddətli yaddaşda saxlayın; yığım rejimi auto (susmaya görə) olduqda dərhal axtarıla bilir, review/off olduqda təsdiq gözləyən namizəd olur |
varsayılan olaraq açıq |
memory_search |
Uzunmüddətli yaddaşda axtarış | varsayılan olaraq açıq |
filesystem_read |
Serverin diskindəki faylın oxunması və ya qovluq siyahısı | standart olaraq açıq; AIHUMMER_FS_ROOT qum qutusunu daraldır, boş = bütün server |
db_query |
Yalnız oxumaq üçün verilənlər bazası sorğusu | AIHUMMER_DB_QUERY_DSN |
mail |
Poçt göndərmək/qəbul etmək (SMTP/IMAP) | poçt məlumatları (şəxsi saxlama qutusu) |
code_exec |
Kodu qum qabında işlədin (paylaşılan hostlarda standart olaraq söndürülsün) | AIHUMMER_CODE_EXEC |
doc_generate |
CSV / TSV / XLSX və ya HTML sənədi yaradın. | varsayılan olaraq açıq |
tts |
Mətndən nitqə | TTS yan maşını |
image_generate / edit_image |
Şəkillər yaradın və redaktə edin | konfiqurasiya edilmiş şəkil arxa ucu |
github_get_file |
GitHub-dan fayl gətirin | varsayılan olaraq açıq |
generate_pairing_code |
Cihaz qoşulma kodu verin | varsayılan olaraq açıq |
search_knowledge / deep_research |
Bilik əldə etmə və çoxsəviyyəli tədqiqat | bilgi bazası |
| Bitrix24 CRM / tapşırıq / təqvim | Bitrix24 CRM, tapşırıq və təqvim əməliyyatları | Bitrix24 əlavəsi |
| 1C (BİT.FİNANS OData) | 1C BİT.FİNANS-a OData üzərindən giriş | 1C OData konfiqurasiyası |
[!NOTE]
web_fetchvəhttp_requestdir SSRF tərəfindən qorunan — onlar tələbləri rədd edirlər daxili ünvanlar və digər təhlükəsiz olmayan hədəflər, buna görə model onları istifadə edə bilməz şəxsi şəbəkənizə çatmaq.
Daimi brauzer profili
Standart olaraq computer hər sorğu üçün təmiz brauzer açır. 1.3
versiyasından alət açıq şəkildə təyin olunmuş şəxsi profili (cookie-lər və
sayt sessiyaları) sorğular arasında saxlaya bilər — məsələn, əməkdaşın hər
dəfə yenidən daxil olmadan öz hesablarını idarə etməsi üçün. Profil heç vaxt
model arqumentlərindəki ada və ya yola görə seçilmir — yalnız operatorun açıq
bağlaması ilə:
AIHUMMER_BROWSER_PROFILE_SOCKET— quraşdırılmış brauzer xidmətinin şəxsimanaged-profiles.socksoketinə mütləq yol; boş (standart) — daimi profillər söndürülüb.AIHUMMER_BROWSER_PROFILE_BINDINGS— bağlamaların JSON massivi:profile_id,tenant_id,user_id,agent_idsvəconversation_ids(64-ə qədər profil, hər birinin bir sahibi).
Profil yalnız cari istifadəçi onun sahibi olduqda, agent və dialoq bağlamada
sadalandıqda açılır; dialoq başqa insan iştirakçılar olmadan şəxsi olmalıdır.
Sahib və hüquqlar yalnız ilk açılışda deyil, hər əməliyyatda yoxlanılır. Daimi
profillər aktiv olduqda computer əməliyyatları yalnız uyğun bağlama ilə icra
olunur. Brauzerin açıq şəbəkə siyasəti tələb olunur — təyin edilmiş
AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK (true və ya false) və ya
AIHUMMER_BROWSER_ALLOWED_HOSTNAMES siyahısı; xarici brauzerin cookie-ləri
idxal olunmur. Hər iki parametr təhlükəli sayılır: idarə olunan buludda və demo
instansda onlar kilidlənib.
Ümumi bacarıqlar
A bacarıq təkrar istifadə oluna bilən bir təlimatdır (sual fraqmenti) ki, agentlərə əlavə edilə bilər. Kitabxana admin UI-nin üzərində yerləşir Paylaşılan bacarıqlar səhifə: birini yaratmaq üçün, ad və mətn kifayətdir — identifikator (slug) avtomatik olaraq yaranır. Satıcı tərəfindən qutudan çıxan bacarıqlar daşıyır Qutudan çıxanda nişan; onlar deaktiv edilə bilər, amma siyahıda qalır. Qoşulmuş bacarıqlar agentin sistem sorğusunun sabit prefiksinə verilmişdir.
Alətlərin aktivləşdirilməsi
Əksər alətlər onların konfiqurasiyasını təqdim etdiyiniz zaman işləyir. Ümumi açarlar:
AIHUMMER_FS_ROOT=/srv/agent-files # filesystem_read qum qutusunu DARALDIR (boş = bütün server)
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] İstifadə et
AIHUMMER_APPROVAL_TOOLShər hansı bir əlavə ilə nəyəsə icazə tələb etmək təsir — e-poçt göndərmək, kod işlətmək — oxumaq üçün olan alətləri məhdudiyyətsiz buraxmaqla.
Növbəti haradır
- Hər bir alət üçün tam istinadını burada görün alətlər kataloqu.
- Bu alətləri çağıran döngəni başa düşün Orkestrasiya və sub-agentlər.
- Sənədlərinizdə cavabları yerli mənbələrə əsaslandırır Bilik / RAG.
HTML sənədləri
Agent doc_generate və format: "html" ilə 4 MiB-dək UTF-8 HTML əlavəsi yaradır. CSS və JavaScript saxlanılır. Uyğun yenilənmiş tətbiq mənbə və bütövlüyü yoxladıqdan sonra saxlanmış faylı təcrid olunmuş baxışda açır. Tətbiqin giriş məlumatları ötürülmür; fayl, mənbə və ya sessiya dəyişdikdə baxış etibarsız olur.