⚠️ هذه ترجمة آلية. للاطلاع على أحدث إصدار، راجع English README.
🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית
الترجمات: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית
المراقبة والفرض لكل محاولة يشغلها وكلاؤك. أينما يعمل وكلاؤك، نحن نراهم — ويمكننا أن نرفضهم. يتصل failproofai بـ 12 محاولة وكيل — واجهات برمجة الترميز مثل Claude Code و Codex، بوابات الدردشة مثل Hermes، المساعدين المستضافين ذاتيًا مثل OpenClaw — ويلتقط كل عملية ويحجب استدعاءات الأدوات الخطرة قبل تنفيذها. 40 سياسة مدمجة. بدون كمون. يعمل محليًا.
اثنا عشر محاولة في فئتين — عشرة واجهات برمجة ترميز، وبوابتين للدردشة والمساعدين (Hermes و OpenClaw). نفس الأحداث، نفس السياسات، نفس سجل الجلسة، أيًا كانت المحاولة التي يعمل فيها وكيلك.
الوكلاء الذين لا يعملون في أي منها يبلغون من خلال Python SDK، والذي يوفر لك التتبع والجلسات والتدقيق. يتطلب الفرض هناك دخل في وقتك — تحدث إلينا وسنقوم بتعيينه.
{/* A 6-column table instead of inline runs: table columns never re-wrap,
so the grid stays 2×6 at any window width (scrolling on very narrow screens
instead of collapsing into ragged orphan rows). */}
|
|
|
|
|
|
|
|
|
|
|
|
npm install -g failproofai
failproofai policies --install # أو ما عليك سوى تشغيل `failproofai` وقبول موجه التشغيل الأول
failproofaiتنشط 40 سياسة مدمجة فورًا. لوحة معلومات في localhost:8020. عطّل موجه التشغيل الأول باستخدام FAILPROOFAI_NO_FIRST_RUN=1.
| السياسة | ما يحجبه |
|---|---|
sanitize-api-keys |
مفاتيح API التي تتسرب إلى سياق الوكيل |
block-env-files |
قراءة ملفات .env والملفات السرية الأخرى |
warn-repeated-tool-calls |
الوكيل الذي يحلق في نفس الاستدعاء |
block-sudo |
تصعيد الامتيازات |
warn-destructive-sql |
DROP، TRUNCATE، DELETE غير محدود |
block-terraform / block-kubectl |
تغييرات غير مراجعة للبنية التحتية المباشرة |
block-rm-rf |
حذف الملفات العودي |
block-force-push / block-push-master |
git push --force، الدفع المباشر إلى main |
ينطبق الخمسة الأولى على أي وكيل يمكنه استدعاء أداة. الثلاثة الأخيرة هي المفضلة لدى المطورين — واجهات برمجة الترميز هي فئة المحاولة التي نغطيها بعمق.
أفلت ملف إلى .failproofai/policies/ — يتم تحميله تلقائيًا، بدون حاجة لأعلام.
تأكد منه والفريق بأكمله يحصل عليه في السحب التالي.
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("Writes to production paths are blocked.");
return allow();
},
});ثلاثة قرارات متاحة لكل سياسة:
| القرار | التأثير |
|---|---|
allow() |
السماح بالعملية |
deny(message) |
حجبها — تعود الرسالة إلى الوكيل |
instruct(message) |
دعها تمر، لكن أضف سياقًا إلى موجه الوكيل التالي |
الفرض نصف واحد. النصف الآخر هو رؤية ما فعله الوكيل بالفعل.
قم بتشغيل failproofai بدون حجج وسيعمل لوحة معلومات على localhost:8020 قراءة سجل التشغيل الموجود بالفعل على جهازك — بدون حساب، بدون تسجيل، لا شيء يغادر الصندوق. تحصل على قائمة الجلسة، والتسلسل من استدعاءات النموذج، واستدعاءات الأدوات وقرارات الخطاف داخل كل عملية، ما تم حجبه وما قالته السياسة للوكيل، وتدقيق غير متصل (failproofai audit) الذي يفحص سجلك عن الأنماط الخطرة ويقترح السياسات لإيقافها.
→ لوحة المعلومات المحلية · قراءة تتبع · التدقيق المحلي
Failproof AI Observability هي الجانب المستضاف لنفس نموذج البيانات، للفرق التي تدير الوكلاء عبر أسطول: كل عملية من كل محاولة في مكان واحد، رسم بياني للتنفيذ مع وكلاء فرعيين متوازيين على مساراتهم الخاصة، مدة الكمون p50/p95/p99 للنماذج والأدوات والخطافات، التكلفة لكل نموذج وتتبع نافذة السياق، تتبع الأخطاء، SQL على تتبعاتك الخاصة مع لوحات معلومات قابلة للمشاركة، التقييمات المسجلة بواسطة خدمتك الخاصة، التدقيقات المجدولة التي تحول الفشل المتكرر إلى نتائج مدعومة بالأدلة، والتنبيهات الموجهة إلى Slack أو البريد الإلكتروني أو webhook موقع. يتوفر الاستضافة الذاتية في مجموعتك الخاصة في خطة Enterprise.
→ الجلسات · التدقيقات · احجز عرضًا توضيحيًا
| ابدأ | |
|---|---|
| البدء السريع | التثبيت، واتصل بمحاولة، واعرض التشغيل الأول |
| المفاهيم | كيف يعمل نظام الخطاف |
| المحاولات المدعومة | جميع الـ 12، وما يمكن لكل منها فرضه |
| لاحظ | |
|---|---|
| الجلسات | اتبع التشغيل: النماذج، الأدوات، الأخطاء، الكمون |
| قراءة تتبع | ما يخبرك به الرسم البياني للتنفيذ |
| التدقيقات | ابحث عن أنماط الفشل عبر العديد من الجلسات |
| لوحة المعلومات المحلية | localhost:8020، بدون حاجة لحساب |
| فرض | |
|---|---|
| السياسات المدمجة | جميع السياسات 40 مع المعاملات |
| السياسات المخصصة | اكتب الخاصة بك |
| التكوين | نطاقات التكوين وقواعد الدمج |
| أداتك الخاصة بوكيل | |
|---|---|
| Python SDK | التقرير يعمل من وكيل بدون محاولة |
| سياسة SDK | allow / deny / instruct مرجع |
MIT مع Commons Clause — مجاني للاستخدام الداخلي والشخصي؛ يتطلب إعادة البيع التجاري لـ failproofai نفسه اتفاقية منفصلة. انظر LICENSE للنص الكامل.
انظر CONTRIBUTING.md. السياسات الجديدة والحالات الحدية والترجمات موضع الترحيب.
ابن قبل أن تبدأ. قم بتشغيل
bun install && bun run buildأولاً. يشغل هذا المستودع خطافات failproofai الخاصة به على نفسه، وهم يحلون استيرادfailproofaiمقابل حزمةdist/المترجمة — بدون بناء ستضربCannot find package 'failproofai'أخطاء الخطاف. أعد البناء بعد تغييرsrc/. انظر البناء قبل أن تعمل خطافات المطورين داخل المستودع.
مبني بـ ❤️ بواسطة befailproof.ai في SF و Bengaluru.