Custom - Failproof AI

title: “Özel politikalar” description: “Agent iş akışınıza özgü bir hata modu için bir politika yazın.” icon: “shield-plus”

.failproofai/policies/ dizini altında policies.js, policies.mjs veya policies.ts ile biten bir dosya oluşturun. Kural dosyaları proje ve kullanıcı kapsamında otomatik olarak yüklenir.

Politikayı Cloud yayınından önce test edin

Dashboard
CLI

Özel politikayı bir test makinesine yükleyin ve hem eşleşen bir işlemi hem de meşru bir eşleşmeyen işlemi tetikleyin.
Observe → policy bölümüne gidin ve iki kararı karşılaştırın.
Her bağlantılı oturumu açın ve olay yükünün kural için yeterli kanıt içerip içermediğini doğrulayın.
Davranış doğru olduğunda, incelenen kaynağı Admin → policy editor bölümüne taşıyın ve bir sürüm yayınlayın.

failproofai policies --install --custom ./security.policies.ts \
  --cli claude --scope project
failproofai policies

.failproofai/policies/ altındaki kural dosyaları --custom olmadan yüklenir. Doğrulama bozuk bir modülde başarısız olması gerektiğinde CI’de açık bir yükleme komutu tutun.

import { customPolicies, allow, deny } from "failproofai";

customPolicies.add({
  name: "protect-production-paths",
  description: "Block writes to production configuration",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
    const path = String(ctx.toolInput?.file_path ?? "").replaceAll("\\", "/");
    if (path.split("/").includes("production")) {
      return deny("Writes to production configuration require approval.");
    }
    return allow();
  },
});

Bu, production/config.yml, /srv/production/config.yml, /srv/production ve C:\\production\\config.yml ile Write ve Edit için eşleşir. production-backup gibi adlarla eşleşmez çünkü production tam bir yol segmenti olmalıdır. Açık bir dosyayı doğrulayın ve yükleyin:

failproofai policies --install --custom ./security.policies.ts

Politika bağlamı olay türünü, normalleştirilmiş yükü, araç adını ve girdisini, oturum meta verilerini, parametreleri ve mevcut olduğunda kaynak CLI’yi içerir.

Hata yollarını test edin

Giriş dosyasını veya içeri aktardığı herhangi bir yerel modülü değiştirdikten sonra doğrulamayı çalıştırın:

failproofai policies --install --custom ./security.policies.ts --scope project

Katı CLI yolu eksik dosyalar, sözdizimi hataları, çözülmeyen içeri aktarmalar, üst düzey istisnalar ve modül yükleme zaman aşımları için başarısız olur. Zorlama sırasında, bozuk bir özel dosya günlüğe kaydedilir ve atlanır, böylece yerleşik politikalar devam edebilir. Herhangi bir yükleme uyarısını beklenen zorlama kaybı olarak kabul edin ve üretim günlüklerinde bunu uyarın. Açık, kural ve Cloud tarafından yönetilen politikalar arasında genel olarak benzersiz adlar kullanın. Politika işlevlerini deterministik tutun, dış çağrıları kısa zaman aşımları ile sınırlayın ve her yolda kasten allow, instruct veya deny döndürün.

Özel politika zorlama kodudur. Eksik alanları, alternatif araç adlarını ve kötü biçimlendirilmiş girdileri test edin—yalnızca beklenen eşleşmeyi değil.

​title: “Özel politikalar” description: “Agent iş akışınıza özgü bir hata modu için bir politika yazın.” icon: “shield-plus”

​Politikayı Cloud yayınından önce test edin

​Hata yollarını test edin

title: “Özel politikalar” description: “Agent iş akışınıza özgü bir hata modu için bir politika yazın.” icon: “shield-plus”

Politikayı Cloud yayınından önce test edin

Hata yollarını test edin