Ajan araçları - Failproof AI

Araç, ajanınızın gerçekte çalıştığı her şeydir. Failproof AI bunlardan on ikisini destekler ve iki sınıfa ayrılır:

Kodlama CLI’ları (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose
Sohbet ve asistan ağ geçitleri (2) — Hermes (Slack, Telegram, cron), OpenClaw (kendi kendine barındırılan asistan)

Aynı politikalar ve aynı oturum geçmişi, bir ajanın hangi araçta çalıştığından bağımsız olarak geçerlidir. Bir adaptör katmanı, her araçın yerel olay adlarını, araç adlarını ve araç-giriş alanlarını 29 kanonik olayıyla eşler ve herhangi bir politika çalışmadan önce bunu yapar. On ikiden hiçbirinde çalışmayan bir ajan, Python SDK ile doğrudan araçlanır. Bu farklı bir sözleşmedir ve açıkça ifade etmek değerdir: SDK izleme, oturumlar, değerlendirmeler ve denetimler sağlar — kendi başına politikaları uygulamaz. Güvenli olmayan bir eylemi yürütülmeden önce engelleme, çalışma zamanınızın araç sınırında bir uygulama kancası gerektirir; bizimle iletişime geçin ve bunu eşleştireceğiz.

Araç	Desteklenen kanca kapsamları
Claude Code	Kullanıcı, proje, yerel
Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi	Kullanıcı, proje
Factory Droid, Devin CLI, Antigravity CLI, Goose	Kullanıcı, proje
Hermes, OpenClaw	Kullanıcı

Her entegrasyon, politikalar çalışmadan önce yerel kanca olay adlarını, araç adlarını ve araç-giriş alanlarını normalleştirir. Bir politika yalnızca araçın açığa çıkardığı olaylara etki edebilir; dağıttığınız tam araç ve sürümde dönem sonu ve talimat davranışını test edin.

Uygulama yeteneği

“Engelle” şu anlama gelir: geçerli adaptörün döndürdüğü karar, adlandırılan araç tarafından tüketilir. Araç sonrası engelleme, modele gösterilen sonucu değiştirebilir ancak zaten gerçekleşen bir araç yan etkisini geri alamaz.

Araç	Doğrulanmış engelleme olayları	Yalnızca gözlem veya engellemeyen uyarılar
Claude Code	`PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` ve birkaç görev/yapılandırma olayı	`PostToolUse`, oturum yaşam döngüsü, bildirimler ve başarısızlık sonrası olaylar gözlemseldir.
Codex	`PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse`	Araç sonrası engelleme, yürütülmeden sonra sonucu değiştirir; oturum başlatma ve kompakt olaylar geçerli adaptöde gözlemseldir.
GitHub Copilot CLI	`PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse`	Araç sonrası engelleme, yürütülmeden sonra sonucu değiştirir; oturum ve bildirim olayları gözlemseldir.
Cursor	`PreToolUse`, `UserPromptSubmit`, `Stop`	`PostToolUse` ve oturum olayları gözlemseldir.
OpenCode	`PreToolUse`	Araç sonrası ve yaşam döngüsü olayları gözlemseldir; geçerli durma işleme, daha sonraki bir dönüş için rehberlik olup doğrulanmış bir kapı değildir.
Pi	`PreToolUse`, `UserPromptSubmit`	Araç sonrası ve yaşam döngüsü olayları gözlemseldir; durma rehberliği daha sonraki bir dönüşe uygulanır.
Hermes	`PreToolUse`	Yerel bir eklenti, `instruct()` olayını daha sonraki bir API yinelemesine izin vermeden önce sınırlandırılmış, model tarafından görünen bir kesinti olarak sağlar. Araç sonrası, oturum ve alt ajan-durma kararları kapı değildir.
OpenClaw	`PreToolUse`, `UserPromptSubmit`, `Stop`	Araç sonrası, oturum, alt ajan-durma ve kompakt olaylar gözlemseldir.
Factory Droid	`PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact`	Araç sonrası ve alt ajan-durma kararları gözlemseldir.
Devin CLI	`PreToolUse`, `UserPromptSubmit`, `Stop`, koşullu `PermissionRequest`	İzin kancaları her izin modunda çalışmaz; araç sonrası ve oturum olayları gözlemseldir.
Antigravity CLI	`PreToolUse`, `Stop`	Kullanıcı isteği ve araç sonrası kararları gözlemseldir; istem talimatları yine de enjekte edilebilir.
Goose	`PreToolUse`	Kullanıcı isteği, araç sonrası ve oturum olayları gözlemseldir. Yerel engelleme durma kancası yukarı akışta bulunur ancak geçerli adaptör tarafından yüklenmez.

Yetenekler sürüme duyarlıdır. Bir ajan CLI’sini yükselttikten sonra yeniden test edin, özellikle bir politika yaygın ön araç kapısı yerine istemi, durma, izin veya araç sonrası davranışına dayalı olduğunda.

Hermes yerel eklentisi

Hermes, bir shell komutu yerine profil-yerel yerel bir eklenti aracılığıyla entegre edilir. Yükleme, eklentiyi her varsayılan ve adlandırılmış Hermes profiline kopyalar, bu profilde etkinleştirir config.yaml ve yalnızca eski FailproofAI shell-kanca girişlerini taşır. Bu, her kancanın işlem başlatmaktan kaçınır ve instruct() modele Hermes’in yerel engellenen araç sonucu aracılığıyla ulaşmasına izin verir. İlk eşleşen talimat bekleyen çağrıyı engeller. Aynı API isteği engellenir kalır; daha sonraki bir model yinelemesi yeniden deneyebilir. Kalıcı, profil kapsamlı bir defteri ve her dönüş için bir sınır, danışman bir tavsiyenin sınırsız bir döngü haline gelmesini önler. deny() sabit bir blok kalır. Çalıştırın failproofai config --status devre dışı, eksik, yinelenen veya yeni yapılandırılmamış bir profili tespit etmek için.

Yakalama ve politika kancalarını yükleyin

Gösterge Paneli
CLI

Yönetim → Anahtarlar açın ve events:add ve policies:pull ile makine veya ortam için adlandırılmış bir anahtar oluşturun.
Hedef makinede, yerel CLI’yi görüntülenen anahtarla bağlayın ve araç kancalarını yükleyin.
Yeni bir ajan oturumu başlatın, ardından Gözlemle → Olaylar altında kanca ve oturum olaylarını onaylayın.
Aynı zaman penceresi için Gözlemle → politika açın ve bir politika kararı makineye atfedildiğini onaylayın.

Bağlantı bir makine anahtarı ile başlar. Gizliliğini kopyalamadan önce hem alma hem de politika sunumu izinlerini içerdiğini onaylayın.

Olay alımı ve politika sunumu izinleri vermek için kullanılan yeni API anahtar çekmecesi.

Kancaları yükledikten sonra, Olaylar akışı bağladığınız makineden ve ortamdan yeni olayları göstermelidir.

Yeni yüklenen bir aracın rapor ettiğini onaylamak için kullanılan canlı Olaylar akışı.

Son olarak, politika kararlarının aynı makineye atfedildiğini doğrulayın. Bu, aracının izleme olaylarının yanı sıra politika etkinliğini de rapor ettiğini onaylar.

Yeni bağlı bir araçtan politika kararlarını doğrulamak için kullanılan Politika sayfası.

Makine anahtarını kabuk içine okuyun. read -s bunu yankı yapmayan bir isteme alır, bu nedenle hiçbir zaman bir komutta veya kabuk geçmişinde görünmez:

read -rs FAILPROOFAI_CLOUD_TOKEN && export FAILPROOFAI_CLOUD_TOKEN

Ardından makineyi kurun — bu her algılanan araç için kancaları bağlar, daemon’u yükler ve Cloud’a bağlanır:

failproofai config
failproofai policies add FailproofAI/policies

Kurulum kendi başına politika sağlamaz, ikinci komut bunu yapar.Veya adlandırılmış araçları ve bir yapılandırma kapsamını hedefleyin:

failproofai policies --install \
  --cli claude codex cursor \
  --scope user

Proje kapsamı, kanca yapılandırmasını bir depo ile tutar. Kullanıcı kapsamı depolardaki işi kapsar. Claude Code yerel kapsamı da destekler; destek araçlara göre değişir ve CLI desteklenmeyen kombinasyonları reddeder.Makineyi ve olaylarını doğrulayın:

failproofai config --status
failproofai flush --wait
fp events --since 1h --event-type hook_triggered,hook_completed

Varsayılan olmayan bir oturum yolu ekleyin

Gösterge Paneli
CLI

Fazladan yollar makinede kaydedilir, Cloud’da değil. Bir tane ekledikten sonra, Gözlemle → Oturumlar açın, ortamı makinenin ortamına filtreleyin ve yeni yoldan oturumlar görüntülendiğini onaylayın. Bir oturumu açın ve denetimde buna güvenmeden önce ajanı, aracı ve olay zaman damgalarını kontrol edin.

Ek yakalama yolundan veri alan ortama filtrelenen Oturumlar listesi.

İsteğe bağlı bir etiket ile bir yol ekleyin, ardından yapılandırılmış yolları inceleyin:

failproofai harness add-path claude checkout=/srv/checkout/.claude
failproofai harness list claude
failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d

failproofai harness remove-path claude checkout ile bir yolu kaldırın.

Yüklemeden sonra bir yeni oturum çalıştırın. Dağıtımı genişletmeden önce hem canlı olay akışını hem de gerçek bir politika kararını doğrulayın.

​Uygulama yeteneği

​Hermes yerel eklentisi

​Yakalama ve politika kancalarını yükleyin

​Varsayılan olmayan bir oturum yolu ekleyin

Uygulama yeteneği

Hermes yerel eklentisi

Yakalama ve politika kancalarını yükleyin

Varsayılan olmayan bir oturum yolu ekleyin