Araçlar Kataloğu — AiHummer Belgeler

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`	Belgeler oluşturun (CSV / TSV / XLSX).	Varsayılan olarak açık
`image_generate` / `edit_image`	Resimler oluşturun veya düzenleyin.	Varsayılan olarak açık
`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.	Her zaman açık. `AIHUMMER_FS_ROOT` aracı açmaz, yalnızca kum havuzunu daraltır: değer boş kaldığı sürece kum havuzunun kökü sunucunun tamamıdır (`/`).

[!DANGER] Ne olur: ajan, ağ geçidi servis kullanıcısının okuyabildiği her dosyayı okur — veritabanı bağlantı bilgilerini tutan dosya ve gizli depoyu şifreleyen anahtar dâhil. Hangi koşulda: AIHUMMER_FS_ROOT ayarı boş olduğu sürece. Kendi sunucunuza kurulumdan hemen sonraki varsayılan durum budur. Nasıl düzeltilir: Yönetim → Ayarlar’ı açın, AIHUMMER_FS_ROOT anahtarını bulun, ajanın gerçekten ihtiyaç duyduğu dizini yazın (örneğin /srv/agent-files) ve kaydedin. Değer veritabanında tutulur — bu anahtar için gateway.env içindeki satır yok sayılır. Ayrıca filesystem_read adını AIHUMMER_APPROVAL_TOOLS listesine ekleyerek her çağrının onayınızı beklemesini sağlayın.

AiHummer yönetilen bulutunda bu araç ajana hiç verilmez — kökü yalnızca kendi kurulumunuzda daraltmanız gerekir.

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_exec dır paylaşılan sunucularda varsayılan olarak kapalı. Bunu yalnızca bir çalıştırdığı model-yazılmış kod nedeniyle kontrol ettiğiniz ve güvendiğiniz bir ortam. Hatta sandbox içinde, bunu ayrıcalıklı bir yetenek olarak ele alın.

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ı.