README.tr.md

⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית

---

---

Desteklenen ortamlar

İki sınıfta on iki ortam — on kodlama CLI'ı ve iki sohbet ve asistan ağ geçidi (Hermes, OpenClaw). Tüm ortamlar arasında bir ilke API'ı ve bir oturum geçmişi. Bir ilkenin engelleyebileceği ortama özgüdür: bir araç çağrısını çalıştırmadan önce durdurmak tüm on ikide doğrulanır, oturum sonu kapıları sekizde açılır. Ortama özgü matris, her birinin hangi olayları onurlandırdığını listeler.

Bunlardan hiçbirinde çalışmayan aracılar Python SDK aracılığıyla raporlanır; bu size izleme, oturumlar ve denetimler verir. Orada zorlama, kendi çalışma zamanınıza bir kanca takılmasını gerektirir — bizimle iletişime geçin ve biz onu eşleştireceğiz.

{/* Satır içi çalışmalarının yerine 6 sütunlu bir tablo: tablo sütunları hiçbir zaman yeniden kaydırılmaz, bu nedenle ızgara herhangi bir pencere genişliğinde 2×6 kalır (çok dar ekranlarda kaydırma bunun yerine düzensiz yetim satırlara çökmek). */}

Yükleme

npm install -g failproofai
failproofai config                             # aracılarınızı ve daemon'u bağlayın
failproofai policies add FailproofAI/policies  # neleri uygulayacağınızı seçin
failproofai                                    # localhost:8020 üzerinde kontrol paneli

Kurulum, kancaları bağlar ve hiçbir ilke seçmez — ikinci komut, makinede güvenlik duvarları koyan şeydir ve herhangi bir paket aynı şekilde yazılır (failproofai policies add <owner>/<repo>; policies show <owner>/<repo> önce birini okur). Terminal olmadan failproofai config çalıştırın — CI, bir konteyner, onu yöneten bir aracı — ve sorular sormak yerine uygular. Hiçbir zaman kurulmamış bir makinede, başka herhangi bir komut önce aynı sihirbazı çalıştırır; bunu FAILPROOFAI_NO_FIRST_RUN=1 ile devre dışı bırakın.

Bir paket gelene kadar, uygulamayı yapan tek şey block-failproofai-commands, her zaman açık olan ve kapatılamayan veya duraklatılamayan şeydir: zorlamayı duraklatabilecek bir aracı, diğer her ilkeyi açabilir.

---

Neyi engeller

İlke	Neyi engeller
block-env-files	.env ve diğer gizli dosyaların okunması
warn-repeated-tool-calls	Aracının aynı çağrıda döngüye girmesi
block-sudo	Ayrıcalık yükseltme
warn-destructive-sql	DROP, TRUNCATE, sınırlanmamış DELETE
block-terraform / block-kubectl	Canlı altyapıya gözden geçirilmemiş değişiklikler
block-rm-rf	Özyinelemeli dosya silme
block-force-push / block-push-master	git push --force, main üzerine doğrudan itme

Bu komutların hepsi çağrısı çalıştırmadan önce kapıdan geçer, bu nedenle tüm on iki ortamda geçerlidirler. İlk dördü, bir aracı çağrı yapabilen herhangi bir araçla geçerlidir; sonuncu üçü geliştirici favorileridir — kodlama CLI'ları en derin kapladığımız ortam sınıfıdır. sanitize-* ailesi ayrıdır: bir araç döndükten sonra çalışır, bu nedenle bağlamdan onu tutmak yerine araç çıktısında bir gizli kodunu bildirir.

→ Tüm 39 yerleşik ilke

---

Kendi ilkeleriniz

.failproofai/policies/ içine bir dosya bırakın — otomatik olarak yüklenir, bayrak gerekmez. Onu işleyin ve tüm takım bir sonraki çekişte onu alır.

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

customPolicies.add({
  name: "no-production-writes",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolInput?.file_path?.includes("production"))
      return deny("Üretim yollarına yazma engellenir.");
    return allow();
  },
});

Her ilke için kullanılabilir üç karar:

Karar	Etki
allow()	İşleme izin ver
deny(message)	Engelle — ileti aracıya geri gider
instruct(message)	Geçmesine izin ver, ancak aracının sonraki komutuna bağlam ekle

→ İlke yaz

---

Gözlemlenebilirlik

Zorlama bir yarısıdır. Diğer yarısı, aracının gerçekten ne yaptığını görmektir.

failproofaiyi argument olmadan çalıştırın ve localhost:8020 üzerinde makinenizde zaten olan çalıştırma geçmişini okuyan bir kontrol paneli sunar — hesap yok, kaydolma yok, hiçbir şey kutunun dışına çıkmaz. Oturum listesini, her çalıştırmanın içinde model çağrılarının, araç çağrılarının ve kanca kararlarının sırasını, neyin engellendiğini ve ilkenin aracıya ne söylediğini alırsınız ve risky modelleri taradığınız ve onları durdurmak için ilkeler önerdiği çevrimdışı bir denetim (failproofai audit).

→ Yerel kontrol paneli · İz oku · Yerel denetim

Failproof AI Gözlemlenebilirliği, aynı veri modelinin barındırılan tarafıdır, bir filo genelinde aracılar çalıştıran takımlar için: her ortamın her çalıştırması tek bir yerde, paralel alt-aracıların kendi şeritlerinde olduğu bir yürütme grafiği, modeller, araçlar ve kancalar için p50/p95/p99 gecikme, modele göre maliyet ve bağlam-penceresi izleme, hata izleme, kendi izleriiniz üzerinde SQL paylaşılabilir panolarla, kendi hizmetiniz tarafından puanlanan değerlendirmeler, yinelenen başarısızlıkları kanıta dayalı bulgulara dönüştüren planlanan denetimler ve uyarılar Slack, e-posta veya imzalı bir webhook'a yönlendirilir. Kendi kümenizde kendi kendine barındırma, Enterprise planında mevcuttur.

→ Oturumlar · Denetimler · Demo kitapla

---

Belgeler

Başlat
Hızlı başlangıç	Yükle, bir ortamı bağla, ilk çalıştırmayı gör
Konseptler	Kanca sistemi nasıl çalışır
Desteklenen ortamlar	Tüm 12 ve her birinin neleri uygulayabileceği

Gözlemle
Oturumlar	Bir çalıştırmayı takip et: modeller, araçlar, hatalar, gecikme
İz oku	Yürütme grafiği sana ne söylüyor
Denetimler	Birçok oturum arasında başarısızlık modellerini bul
Yerel kontrol paneli	localhost:8020, hesap gerekli değil

Uygula
İlke paketleri	Failproof AI ilkeleri ve ilke merkezi'nden paketler
İlke yaz	Bir denetimden veya kodda
Yapılandırma	Konfigürasyon kapsamları, birleştirme kuralları ve ilke parametreleri

Kendi aracınızı enstrüman edin
Python SDK	Ortamı olmayan bir aracıdan çalıştırmaları raporla
İlke SDK	allow / deny / instruct referansı

---

Lisans

MIT Commons Clause — dahili ve kişisel kullanım için ücretsiz; failproofai'in ticari yeniden satışı ayrı bir anlaşma gerektirir. Tam metin için LİSANS bölümüne bakın.

---

Katkıda bulunma

CONTRIBUTING.md bölümüne bakın. Yeni ilkeler, edge case'ler ve çeviriler hepsi hoş geldiniz.

Başlamadan önce oluşturun. Önce bun install && bun run build çalıştırın. Bu depo, failproofai'in kendi kancalarını kendisinde çalıştırır ve failproofai içe aktarmasını derlenmiş dist/ paketine karşı çözerler — bir derleme olmadan Cannot find package 'failproofai' kanca hatalarına çarparsınız. src/ değiştirildikten sonra yeniden derleyin. Bkz. İçi repo dev kancaları çalışmaya başlayacak şekilde önce oluşturun.

---

SF ve Bengaluru'da befailproof.ai tarafından ❤️ ile inşa edildi.