Araçlar Kataloğu
Bir dönüş sırasında temsilci çağrı yapabilir araçlar. AiHummer yerleşik bir araç çalışma zamanı ile gelir: bazı araçlar varsayılan olarak açıktır, diğerleri ise yalnızca gerekli yapılandırmayı sağladığınızda etkinleşir. Araçlar, ilgili yerlerde SSRF korumalı ve izole edilmiş (sandboxed) durumdadır ve riskli araçlar insan onayı gerektiren bir kapı arkasına alınabilir.
Varsayılan olarak etkin
Bu araçlar kutudan çıktığı gibi çalışır (bazıları yapılandırılmış bir modele veya bilgi tabanına bağlıdır).
| Araç | Ne yapar | Nasıl etkinleştirilir |
|---|---|---|
web_fetch |
Bir URL’nin içeriğini al. SSRF korumalı. | Varsayılan olarak açık |
http_request |
Bir çıkış HTTP isteği yapın. SSRF korumalı. | Varsayılan olarak açık |
web_search |
Yerleşik SearXNG üzerinden web’de arama yapın. | Varsayılan olarak açık (yükleyiciyle birlikte gelir); --no-search ile kapatın |
browser / computer |
Gerçek bir tarayıcıyı Chrome Geliştirici Araçları Protokolü üzerinden yönetin. | Varsayılan olarak açık (yükleyiciyle birlikte gelir); --no-browser ile kapatın |
memory_store |
Uzun süreli belleğe bir gerçek kaydedin (Einstein). Yakalama modu auto (varsayılan) iken gerçek hemen aranabilir; review/off iken onay bekleyen bir aday olur. Sonuç bir searchable_now alanı taşır. |
Varsayılan olarak açık |
memory_search |
Uzun süreli bellekte arama yapın (Einstein). | Varsayılan olarak açık |
doc_generate |
CSV / TSV / XLSX veya HTML belgesi oluşturur. | Varsayılan olarak açık |
image_generate / edit_image |
Resimler oluşturun veya düzenleyin. | Yapılandırılmış bir görsel arka ucu gerekir; düzenleme için bu arka ucun görsel düzenlemeyi de desteklemesi gerekir. |
github_get_file |
Bir GitHub deposundan tek bir dosya alın. | Varsayılan olarak açık |
generate_pairing_code |
Bir cihaz eşleştirme kodu verin. | Varsayılan olarak açık |
search_knowledge |
Bilgi tabanında (RAG) arama yapın ve cevapları alıntılarla destekleyin. | Bir bilgi tabanı yapılandırılmış olarak |
deep_research |
Çok adımlı araştırma yapın ve kaynak gösterilmiş bir rapor hazırlayın. | Varsayılan olarak açık |
docs_search |
Arama yap bu belgelendirmenin çevrimdışı kopyası (docs.aihummer.ru anlık görüntüsü sürümde yer alır, share/docs, ru/en) — ajan, internet olmadan ürün sorularını yanıtlayabilir. |
Belgeler anlık görüntüsü mevcutken (standart kurulum) |
docs_read |
Vasıtasıyla bulunan tam bir dokümantasyon sayfasını okuyun docs_search. |
Belgeler anlık görüntüsü mevcutken (standart kurulum) |
filesystem_read |
Sunucunun diskindeki bir dosyayı okur veya bir dizinin içeriğini listeler. | Varsayılan olarak aracının kendi çalışma klasörü; ana makine erişimi için sahibin bu aracının yalıtım kipini açıkça seçmesi gerekir. Yönetilen bulutta ve demoda kullanılamaz. |
[!NOTE]
AIHUMMER_FS_ROOTizin verilen kökü daha da daraltır; boş değer tüm sunucuya erişim vermez. Kurulumun ayarları, veritabanı kimlik bilgileri ve şifreleme anahtarları ile süreç ortamları okunamaz. Onay, izin verilen dosya kapsamını genişletmez.
Yapılandırmada etkinleştir
Bu araçlar, ihtiyaç duydukları kaynağa yöneltinceye kadar kapalı kalır. Tüm etkinleştirme düğmeleri (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) …dır Ayarlar-katalog anahtarlar: bunları web yönetici kullanıcı arayüzünde ayarlayın (Yönetim → Ayarlar, arama) veya ile aihummer settings set <KEY> <VALUE>. Onları koymak gateway.env sahip etki yok — bu anahtarlar için ortam göz ardı edilir.
| Araç | Ne yapar | Nasıl etkinleştirilir |
|---|---|---|
db_query |
Sadece okunabilir SQL sorguları çalıştırın. | AIHUMMER_DB_QUERY_DSN |
mail |
E-posta gönder ve oku. | SMTP / IMAP kimlik bilgileri |
tts |
Konuşma sentezle (metni konuşmaya dönüştür). | AIHUMMER_TTS_URL (TTS yan aracı) |
code_exec |
Kodu bir kum havuzunda yürütün. | AIHUMMER_CODE_EXEC |
[!DANGER]
code_execvarsayılan olarak kapalıdır. Yalnızca kontrol ettiğiniz ve güvendiğiniz bir ortamda etkinleştirin: modelin yazdığı kodu yürütür ve yalıtılmış ortamda bile ayrıcalıklı bir yetenek olarak kalır.
Entegrasyon araçları
Eşleşen bağlantı yapılandırıldığında, ajan ayrıca alan araçlarını da alır:
| Araç | Ne yapar | Nasıl etkinleştirilir |
|---|---|---|
| Bitrix24 CRM / görev / takvim araçları | Bitrix24 CRM kayıtlarını, görevleri ve takvimi okuyun ve işlem yapın. | Bitrix24 bağlantısı yapılandırıldı |
| 1C (BIT.FİNANS OData) | БИТ.ФИНАНС OData arayüzü üzerinden 1C muhasebe verilerini sorgulayın. | 1C OData bağlantısı yapılandırıldı |
Onay geçidi
Herhangi bir araç bir şeyin arkasına konabilir insan müdahaleli onay kapısı. Araç adlarını listeleyin AIHUMMER_APPROVAL_TOOLS ayar (web yönetici UI: Yönetim → Ayarlar); böyle bir araç çalışmadan önce, bir operatör çağrıyı onaylamalıdır. Reddedilen bir çağrı değil idam edildi.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
Hava boşluklu mod
Ayarla AIHUMMER_AIRGAPPED ayarlamak 1 model kontrollü genel çıkışı engellemek için. Bu modda ajan, araçlar aracılığıyla açık internete erişemez; bu, egemen veya izole dağıtımlar için uygundur.
aihummer settings set AIHUMMER_AIRGAPPED 1
[!NOTE] Yerleşik katalogun ötesinde, AiHummer herhangi bir OpenAPI 3.x’ten araçlar sentezleyebilir herhangi bir MCP sunucusunun araçlarını herhangi bir entegrasyon kodu olmadan belirtin ve ortaya çıkarın. Bakınız Belgelerin Marketplace ve Eklentiler bölümü.
Sonra nereye?
- Burada tam olarak referans verilen değişkenler: Ortam değişkenleri.
- Çalışan örneği yönetin: CLI referansı.
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.