AgentFuse
Döngüye giren ajanı fark edin, çağrı sınırını koyun.
Marka: Tunedness
AgentFuse, bir ajanın araç çağrıları için devre kesicidir. Ajan ile kullandığı MCP sunucuları arasına şeffaf bir proxy olarak girer; aynı çağrıyı durmadan tekrarlayan ya da bütçesini aşan oturumları fark eder. Tunedness’ın açık kaynak projelerinden biridir.
Döngü tespiti
Kural katmanı aynı çağrının tekrarını, tekrarlanan hatayı ve kısa döngüleri yakalar; model ya da ağ gerektirmez. İsteğe bağlı bir gömme paketi, anlamsal bir katman ekler.
Bütçeler ve kurallar
Her oturum için süre, çağrı sayısı, tahmini token ve tahmini dolar bütçesi tanımlanır. Token ve dolar rakamları yalnızca araç girdi ve çıktılarına dayanan alt sınır tahminleridir. Araç bazında kurallar glob ile eşlenir ve allow, warn, deny ya da require_approval değerlerinden birini alır. Onay gerektiren çağrılar CLI ya da webhook üzerinden bir insana gider; gerekçe (--reason) zorunludur.
Gözlemle, sonra uygula
Varsayılan mod warn’dır: AgentFuse gözlemler ve raporlar, hiçbir şeyi engellemez. enforce ile devreye girer. Her şey tek bir YAML dosyasında (fusepolicy.yaml) toplanır; dosyanın JSON Schema’sı yayınlanmıştır. CLI wrap, serve, init, validate, report, approve, deny ve models install komutlarını sunar. Telemetri OTLP ile tunedness.* olayları olarak akar. AgentFuse, McpGuard ile zincirlenebilir; zincirde McpGuard en dışta durur.
Kurulum ve kapsam
AgentFuse GitHub deposundan kurulur: depoyu klonlayıp derlersiniz. Henüz npm’de yayınlanmış paketi yoktur ve npm’deki agentfuse adlı paket bu projeye ait değildir. Node.js 20.19 ya da üzeri gerekir. Bilerek kapsam dışı bırakılanlar: korumalı HTTP geçidi, Python süreç içi SDK, kullanım verisi alımı, A2A trafiği, çerçeve eklentileri ve maliyet paneli.
Lisans
Apache-2.0. Kaynak kodu GitHub üzerinde geliştirilir.
Öne çıkan özellikler
- Şeffaf MCP proxy'si: ajan ve araç tarafında kod değişikliği gerekmez
- Döngü tespiti: aynı çağrının tekrarı, tekrarlanan hata, kısa döngüler; isteğe bağlı anlamsal katman
- Oturum başına süre, çağrı sayısı, tahmini token ve tahmini maliyet bütçeleri
- Araç bazında kural: izin ver, uyar, engelle, onay iste
- CLI ya da webhook ile insan onayı
- Tek YAML politika dosyası ve yayınlanmış JSON Schema
Sıkça sorulan sorular
AgentFuse ne yapıyor?+
Bir ajanın araç çağrıları için devre kesicidir. Ajan ile MCP sunucuları arasına şeffaf bir proxy olarak girer; döngüye giren ya da bütçesini aşan oturumları fark eder ve kurala göre uyarır, engeller ya da insan onayı ister.
Hangi ajan çerçeveleriyle çalışıyor?+
Çerçeveden bağımsızdır: LangGraph, CrewAI, Claude Agent SDK ya da elle yazılmış bir döngü. Araçlara MCP ile eriştiği sürece iki tarafta da kod değişikliği gerekmez.
Hemen engellemeye başlar mı?+
Hayır. Varsayılan mod warn'dır: gözlemler ve raporlar, engellemez. Engelleme enforce moduyla devreye girer.
Nasıl kuruluyor?+
AgentFuse GitHub deposundan kurulur: depo klonlanır, derlenir ve komut satırı aracı yerel olarak çalıştırılır. Henüz npm'de yayınlanmış bir paketi yoktur. npm'deki agentfuse adlı paket bu projeye ait değildir.
Maliyet bütçesi ne kadar kesin?+
Çağrı sayısı ve süre kesin sayılır. Token ve dolar bütçeleri yalnızca araç girdi ve çıktılarına dayanan alt sınır tahminleridir; proje bunu açıkça belirtir.
Lisansı nedir?+
Apache-2.0. Açık kaynaktır; kaynak kodu GitHub'dadır.
Bir sonraki projenizi birlikte kuralım
Fikrinizi anlatın, size en uygun çözümü tasarlayalım.
İletişime geç