Araçlar
Araçlar bir ajanın dünyada nasıl hareket ettiğidir — bir sayfa getirme, arama yapma, mail gönderme, veri tabanına sorgu yapma, bir belge oluşturma. AiHummer zengin bir şekilde gelir yerleşik katalog ve bir Araç Çalışma Zamanı araçlar yapılandırıldığında bunları etkinleştirir, yeniden başlatma olmadan tekrar yükler, riskli olanları insan onayının arkasına alır ve hava boşluklu modda çıkışı tamamen kilitleyebilir.
Bu sayfa çalışma zamanının nasıl davrandığını kapsar ve yerleşik öğeleri listeler. Tam referans için bkz. araçlar kataloğu.
Araç Çalışma Zamanının nasıl davrandığı
- Yapılandırmada etkinleştir. Bir araç sadece önkoşulu karşılandığında kullanılabilir hale gelir yapılandırma mevcut — genellikle bir ortama değişken olarak işaret eder gereken hizmet. Konfigürasyon yok, araç yok.
- Sıcak yeniden yükleme. Araç etkinleştirme geçerlidir sıcak, yeniden başlatmadan geçit, böylece çalışma zamanında yetenekleri açıp kapatabilirsiniz.
- Onay kapısı. Riskli araçlar insan döngüsündeki birinin arkasına yerleştirilebilir
onay kapısı üzerinden
AIHUMMER_APPROVAL_TOOLS. Reddedilen arama değil idam edildi. - Hava aralıklı mod. Ayar
AIHUMMER_AIRGAPPED=1model kontrollü bloklar kamusal çıkış, egemen veya izole dağıtımlar için.
[!WARNING]
code_execdır varsayılan olarak kapalı paylaşılan sunucularda. Sadece şurada etkinleştirin sandbox ve host, model tarafından yazılan kodu çalıştırmak için kabul edilebilir ve göz önünde bulundurulmalıdır onayı geçidin arkasına koymak.
Yerleşik araçlar
| Araç | Ne yapar | Etkinleştir ile |
|---|---|---|
web_fetch |
Bir URL al (SSRF korumalı) | varsayılan olarak açık |
http_request |
Bir HTTP isteği yap (SSRF korumalı) | varsayılan olarak açık |
web_search |
Yerleşik SearXNG ile web araması | varsayılan olarak açık; yükleyici bayrağı --no-search ile kapatın |
browser |
Gerçek bir tarayıcıyı CDP üzerinden çalıştır | varsayılan olarak açık; yükleyici bayrağı --no-browser ile kapatın |
computer |
CDP üzerinden bilgisayar kullanımı | varsayılan olarak açık; yükleyici bayrağı --no-browser ile kapatın |
memory_store |
Uzun süreli belleğe bir gerçek kaydet; yakalama modu auto (varsayılan) iken hemen aranabilir, review/off iken onay bekleyen bir aday olur |
varsayılan olarak açık |
memory_search |
Uzun süreli bellekte arama yap | varsayılan olarak açık |
filesystem_read |
Sunucu diskindeki bir dosyayı okuma veya dizin listeleme | varsayılan olarak açık; AIHUMMER_FS_ROOT kum havuzunu daraltır, boş = sunucunun tamamı |
db_query |
Salt okunur veritabanı sorgusu | AIHUMMER_DB_QUERY_DSN |
mail |
Posta gönder/al (SMTP/IMAP) | posta kimlik bilgileri (kasa) |
code_exec |
Kodu bir kum havuzunda çalıştırın (paylaşılan sunucularda varsayılan olarak kapalıdır) | AIHUMMER_CODE_EXEC |
doc_generate |
CSV / TSV / XLSX veya HTML belgesi oluşturur. | varsayılan olarak açık |
tts |
Metinden konuşmaya | TTS yan arabası |
image_generate / edit_image |
Görüntü oluştur ve düzenle | yapılandırılmış görüntü arkası |
github_get_file |
GitHub’tan bir dosya al | varsayılan olarak açık |
generate_pairing_code |
Bir cihaz eşleştirme kodu ver | varsayılan olarak açık |
search_knowledge / deep_research |
Bilgi edinme ve çok adımlı araştırma | bilgi tabanı |
| Bitrix24 CRM / görev / takvim | Bitrix24 CRM, görev ve takvim işlemleri | Bitrix24 eklentisi |
| 1C (BIT.FİNANS OData) | 1C BIT.FİNANS OData üzerinden erişim | 1C OData yapılandırması |
[!NOTE]
web_fetchvehttp_requestolmak SSRF korumalı — talepleri reddediyorlar dahili adresler ve diğer güvensiz hedefler, bu yüzden bir model bunları kullanamaz özel ağınıza erişin.
Kalıcı tarayıcı profili
Varsayılan olarak computer her istek için temiz bir tarayıcı açar. 1.3
sürümünden itibaren araç, açıkça atanmış kişisel profili (çerezler ve site
oturumları) istekler arasında koruyabilir — örneğin bir çalışanın her seferinde
yeniden giriş yapmadan kendi hesaplarını yönetmesi için. Profil hiçbir zaman
model argümanlarından gelen ad veya yola göre seçilmez — yalnızca operatörün
açık bağlamasıyla:
AIHUMMER_BROWSER_PROFILE_SOCKET— kurulu tarayıcı hizmetinin özelmanaged-profiles.socksoketinin mutlak yolu; boş (varsayılan) — kalıcı profiller kapalı.AIHUMMER_BROWSER_PROFILE_BINDINGS— bağlamaların JSON dizisi:profile_id,tenant_id,user_id,agent_idsveconversation_ids(en çok 64 profil, her birinin tek sahibi).
Profil yalnızca geçerli kullanıcı sahibiyse ve ajan ile diyalog bağlamada
listelenmişse açılır; diyalog başka insan katılımcı olmadan kişisel olmalıdır.
Sahip ve haklar yalnızca ilk açılışta değil, her eylemde denetlenir. Kalıcı
profiller açıkken computer eylemleri yalnızca uygun bağlamayla yürütülür.
Tarayıcının açık ağ politikası gereklidir — ayarlanmış
AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK (true veya false) ya da
AIHUMMER_BROWSER_ALLOWED_HOSTNAMES listesi; dış tarayıcının çerezleri içe
aktarılmaz. Her iki ayar da tehlikeli sayılır: yönetilen bulutta ve demo
örneğinde kilitlidir.
Paylaşılan beceriler
A beceri ajanlara eklenebilen yeniden kullanılabilir bir talimattır (bir istem parçacığı). Kütüphane, yönetici kullanıcı arayüzünde bulunur Paylaşılan beceriler sayfa: bir tane oluşturmak için, bir isim ve metin yeterlidir — tanımlayıcı (slug) otomatik olarak türetilir. Satıcı tarafından kutudan çıkan beceriler bir Kutudan çıktığı gibi rozet; devre dışı bırakılabilirler ama listede kalırlar. Eklenti yetenekler, ajanın sistem komut isteminin sabit ön ekine aktarılır.
Araçları etkinleştirme
Çoğu araç, yapılandırmalarını sağladığınızda açılır. Yaygın anahtarlar:
AIHUMMER_FS_ROOT=/srv/agent-files # filesystem_read kum havuzunu DARALTIR (boş = sunucunun tamamı)
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] Kullan
AIHUMMER_APPROVAL_TOOLSyanında bir şey için onay gerektirmek etki — posta gönderme, kod çalıştırma — yalnızca okunabilir araçları engellemeden bırakma.
Sonra nereye?
- Tam araç başına referansı şurada görün araçlar kataloğu.
- Bu araçları çağıran döngüyü anlayın Orkestrasyon ve alt ajanlar.
- Belge yanıtlarınızı araçla temellendirin Bilgi / RAG.
HTML belgeleri
Aracı, doc_generate ve format: "html" ile en fazla 4 MiB UTF-8 HTML eki oluşturur. CSS ve JavaScript korunur. Uyumlu ve güncel uygulama, kaynağı ve bütünlüğü doğruladıktan sonra kayıtlı dosyayı yalıtılmış önizlemede açar. Uygulamanın erişim bilgileri aktarılmaz; dosya, kaynak veya oturum değişirse önizleme geçersiz olur.