diff --git a/docs/ar/index.mdx b/docs/ar/index.mdx index 03d05e8a8..dd3ba4c9d 100644 --- a/docs/ar/index.mdx +++ b/docs/ar/index.mdx @@ -1,40 +1,41 @@ --- ---- -title: "اجعل وكيلك آمناً تماماً" -description: "يتتبع Failproof AI سلوك الوكيل، ويدقق في الجلسات للبحث عن الأعطال، وينشر السياسات التي توقف تكرار الحوادث." +title: "اجعل وكيلك آمناً من الأعطال" +description: "المراقبة والإنفاذ لكل بيئة تشغيل يعمل بها وكيلك — واجهات سطر الأوامر للترميز، بوابات الدردشة، المساعدات المستضافة ذاتياً، ووكلاؤك المجهزون بأدوات المراقبة." icon: "shield-check" --- -يساعد Failproof AI الفرق على فهم ما فعله الوكيل، والعثور على مكان فشله، ونشر الحماية قبل حدوث نفس السلوك مرة أخرى. +يساعد Failproof AI الفرق على فهم ما فعله الوكيل، واكتشاف مكان فشله، ونشر الحماية قبل تكرار السلوك نفسه مرة أخرى. + +**البيئة التشغيلية** هي ما يعمل وكيلك بداخله فعلياً. يتصل Failproof AI بـ 12 منها — واجهات سطر الأوامر للترميز مثل Claude Code و Codex، بوابات الدردشة مثل Hermes، المساعدات المستضافة ذاتياً مثل OpenClaw — وتطبق الأحداث والسياسات وسجل الجلسات نفسه على كل واحدة منها. يرسل الوكلاء بدون بيئة تشغيلية البيانات من خلال [Python SDK](/ar/reference/python-sdk)، الذي يتتبع ويدقق فيها؛ لإنفاذ سياسة هناك تحتاج إلى hook في runtime الخاص بك. - استخدم المهارة لآلية مشروعك والاتصال به والتحقق من وصول سجلات الوكيل. + استخدم المهارة لتجهيز مشروعك، واتصل به، وتحقق من وصول سجلات الوكيل. - حلل واستعلم وأنشئ لوحات معلومات وقم بتشغيل عمليات تدقيق باللغة الطبيعية على سجلات الوكيل. + حلل واستعلم وأنشئ لوحات معلومات وقم بعمليات تدقيق باللغة الطبيعية على سجلات الوكيل. - تابع استدعاءات النموذج والأدوات والأخطاء ومدخلات المستخدم والكمون وقرارات السياسة في جلسة واحدة. + تابع استدعاءات النموذج والأدوات والأخطاء والمدخلات البشرية والكمون وقرارات السياسة في جلسة واحدة. - دقق في مجموعة محددة من الجلسات واستعرض النتائج المدعومة بالأدلة وتابع العلاج كمشاكل. + دقق مجموعة محددة من الجلسات، راجع النتائج المدعومة بالأدلة، وتتبع التصحيح كمشاكل. - حول وضع فشل معروف إلى سياسة ولاحظ تأثيره ونشره عبر أسطولك. + حول طريقة فشل معروفة إلى سياسة، راقب تأثيرها، ونشرها عبر أسطولك. -> **الجلسة → التدقيق → النتيجة → المشكلة → السياسة**
-> تتبع ما حدث ابحث عن الفشل أدر الاستجابة ثم منع نفس السلوك في التشغيلات المستقبلية. +> **الجلسة → التدقيق → البحث → المشكلة → السياسة**
+> تتبع ما حدث، ابحث عن الفشل، أدر الاستجابة، ثم منع السلوك نفسه في الأدوار المستقبلية. ## ابدأ من هنا -إذا كنت تنشر وكيلك الأول مع الآلية، ابدأ بـ [دليل البدء السريع](/ar/start/quickstart). إذا كانت البيانات تصل بالفعل، افتح [الجلسات](/ar/sessions/overview) وفتش تشغيلاً حقيقياً قبل تكوين عمليات التدقيق أو السياسات. +إذا كنت تنشر وكيلك المجهز بأدوات المراقبة للمرة الأولى، ابدأ بـ [الدليل السريع](/ar/start/quickstart). إذا كانت البيانات تصل بالفعل، افتح [الجلسات](/ar/sessions/overview) وفتش عملية تشغيل حقيقية قبل تكوين عمليات التدقيق أو السياسات. - أكمل سير العمل من البداية إلى النهاية من الالتقاط إلى نشر سياسة آمنة. + أكمل سير العمل الشامل من الالتقاط إلى سياسة تم نشرها بأمان. \ No newline at end of file diff --git a/docs/ar/reference/harnesses.mdx b/docs/ar/reference/harnesses.mdx index 06e626d91..3788dccef 100644 --- a/docs/ar/reference/harnesses.mdx +++ b/docs/ar/reference/harnesses.mdx @@ -1,64 +1,72 @@ --- -title: "أدوات التكامل للعملاء (Agent harnesses)" -description: "التقط الجلسات وفرض السياسات في واجهات سطر الأوامر المدعومة للعملاء." +--- +title: "خوادم الوكيل" +description: "التقط الجلسات وفرض السياسات عبر 12 خادم وكيل مدعوم." icon: "plug-zap" --- -يدعم Failproof AI Claude Code و Codex و GitHub Copilot CLI و Cursor و OpenCode و Pi و Hermes و OpenClaw و Factory Droid و Devin CLI و Antigravity CLI و Goose. +الخادم هو البيئة التي يعمل فيها الوكيل بالفعل. يدعم Failproof AI اثنا عشر منها، في فئتين: + +- **أدوات سطر الأوامر لكتابة الأكواد** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **بوابات الدردشة والمساعدات** (2) — Hermes (Slack, Telegram, cron), OpenClaw (مساعد موثوق بنفسك) + +نفس السياسات وسجل الجلسة ذاته ينطبقان على أي خادم يعمل فيه الوكيل. طبقة محول واحدة تحول أسماء الأحداث الأصلية لكل خادم وأسماء الأدوات وحقول إدخال الأدوات إلى 29 حدثاً قياسياً قبل تطبيق أي سياسة. + +وكيل يعمل في **لا أحد** من الاثني عشر خادم يتم توظيفه مباشرة باستخدام [Python SDK](/ar/reference/python-sdk). هذا عقد مختلف، ويستحق الإشارة بوضوح: SDK يوفر التتبع والجلسات والتقييمات والتدقيق — **إنه لا يفرض السياسات بمفرده.** منع الإجراء غير الآمن قبل تنفيذه يتطلب خطاف إنفاذ على حدود أداة وقتك؛ [اتصل بنا](mailto:support@befailproof.ai) وسنقوم بتعيينها. -| أداة التكامل | نطاقات hook المدعومة | +| الخادم | نطاقات الخطاف المدعومة | | --- | --- | -| Claude Code | User, project, local | -| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | -| Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | -| Hermes, OpenClaw | User | +| Claude Code | المستخدم، المشروع، محلي | +| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | المستخدم، المشروع | +| Factory Droid, Devin CLI, Antigravity CLI, Goose | المستخدم، المشروع | +| Hermes, OpenClaw | المستخدم | -يقوم كل تكامل بتطبيع أسماء أحداث hook الأصلية وأسماء الأدوات وحقول مدخلات الأدوات قبل تشغيل السياسات. لا يمكن للسياسة أن تتصرف إلا على الأحداث التي تعرضها أداة التكامل؛ اختبر سلوك نهاية الدور والتعليمات على أداة التكامل والإصدار المحدد الذي تنشره. +تقوم كل عملية دمج بتطبيع أسماء أحداث الخطاف الأصلية وأسماء الأدوات وحقول إدخال الأدوات قبل تطبيق السياسات. لا يمكن لأي سياسة التصرف إلا على الأحداث التي يكشفها الخادم؛ اختبر السلوك في نهاية الدور والتعليمات على الخادم والإصدار بالضبط الذي تنشره. -## قدرة الفرض +## قدرة الإنفاذ -"Block" (حجب) يعني أن الحكم المرجعي للمحول الحالي يتم استهلاكه بواسطة أداة التكامل المسماة. قد يستبدل الحجب بعد الأداة النتيجة المعروضة للنموذج لكن لا يمكنه التراجع عن تأثير جانبي للأداة حدث بالفعل. +"البلوك" يعني أن الحكم المرتجع من المحول الحالي يتم استهلاكه بواسطة الخادم المسمى. قد يستبدل الحجب بعد الأداة النتيجة المعروضة للنموذج ولكن لا يمكنه الرجوع في تأثير جانبي للأداة حدث بالفعل. -| أداة التكامل | أحداث الحجب المتحقق منها | تحذيرات الملاحظة فقط أو عدم الحجب | +| الخادم | أحداث الحجب المتحقق منها | تحذيرات الملاحظة فقط أو عدم الحجب | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` وعدة أحداث مهام/إعدادات | `PostToolUse` و دورة حياة الجلسة والإخطارات وأحداث ما بعد الفشل تكون ملاحظة فقط. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | يستبدل الحجب بعد الأداة النتيجة بعد التنفيذ؛ أحداث بداية الجلسة والضغط ملاحظة فقط في المحول الحالي. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | يستبدل الحجب بعد الأداة النتيجة بعد التنفيذ؛ أحداث الجلسة والإخطارات ملاحظة فقط. | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` وأحداث الجلسة ملاحظة فقط. | -| OpenCode | `PreToolUse` | أحداث ما بعد الأداة ودورة الحياة ملاحظة فقط؛ معالجة التوقف الحالية توجيه للدور لاحق بدلاً من بوابة محققة. | -| Pi | `PreToolUse`, `UserPromptSubmit` | أحداث ما بعد الأداة ودورة الحياة ملاحظة فقط؛ يطبق توجيه التوقف على دور لاحق. | -| Hermes | `PreToolUse` | أحكام ما بعد الأداة والجلسة وتوقف العميل ليست بوابات. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | أحداث ما بعد الأداة والجلسة وتوقف العميل والضغط ملاحظة فقط. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | أحكام ما بعد الأداة وتوقف العميل ملاحظة فقط. | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, مشروط `PermissionRequest` | لا تعمل hooks الإذن في كل وضع إذن؛ أحداث ما بعد الأداة والجلسة ملاحظة فقط. | -| Antigravity CLI | `PreToolUse`, `Stop` | أحكام موجه المستخدم وما بعد الأداة ملاحظة فقط؛ يمكن حقن تعليمات الموجه. | -| Goose | `PreToolUse` | أحداث موجه المستخدم وما بعد الأداة والجلسة ملاحظة فقط. يوجد hook توقف حجب أصلي في المنطقة الأعلى لكن لم يتم تثبيته بواسطة المحول الحالي. | - -القدرات حساسة للإصدار. أعد الاختبار بعد ترقية واجهة سطر أوامر العميل، خاصة عندما تعتمد السياسة على سلوك الموجه أو التوقف أو الإذن أو ما بعد الأداة بدلاً من بوابة ما قبل الأداة الشائعة. - -## تثبيت hooks الالتقاط والسياسة +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, وعدة أحداث مهمة/إعدادات | `PostToolUse`, دورة حياة الجلسة، الإخطارات، وأحداث ما بعد الفشل قابلة للملاحظة. | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | الحجب بعد الأداة يستبدل النتيجة بعد التنفيذ؛ أحداث بداية الجلسة والضغط قابلة للملاحظة في المحول الحالي. | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | الحجب بعد الأداة يستبدل النتيجة بعد التنفيذ؛ أحداث الجلسة والإخطار قابلة للملاحظة. | +| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` وأحداث الجلسة قابلة للملاحظة. | +| OpenCode | `PreToolUse` | أحداث ما بعد الأداة ودورة الحياة قابلة للملاحظة؛ معالجة التوقف الحالية عبارة عن إرشاد لدور لاحق وليس بوابة موثوقة. | +| Pi | `PreToolUse`, `UserPromptSubmit` | أحداث ما بعد الأداة ودورة الحياة قابلة للملاحظة؛ إرشاد التوقف ينطبق على دور لاحق. | +| Hermes | `PreToolUse` | أحكام ما بعد الأداة والجلسة وتوقف الوكيل الفرعي ليست بوابات. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | أحداث ما بعد الأداة والجلسة وتوقف الوكيل الفرعي والضغط قابلة للملاحظة. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | أحكام ما بعد الأداة وتوقف الوكيل الفرعي قابلة للملاحظة. | +| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` مشروط | لا تعمل خطافات الإذن في كل وضع إذن؛ أحداث ما بعد الأداة والجلسة قابلة للملاحظة. | +| Antigravity CLI | `PreToolUse`, `Stop` | أحكام مطالبة المستخدم وما بعد الأداة قابلة للملاحظة؛ يمكن بالتزامن تعليمات الموجه. | +| Goose | `PreToolUse` | أحداث مطالبة المستخدم وما بعد الأداة والجلسة قابلة للملاحظة. خطاف توقف حجب أصلي موجود في الأعلى لكن لا يتم تثبيته بواسطة المحول الحالي. | + +القدرات حساسة للإصدار. أعد الاختبار بعد ترقية CLI وكيل، خاصة عندما تعتمد سياسة على سلوك الموجه أو التوقف أو الإذن أو ما بعد الأداة بدلاً من بوابة ما قبل الأداة الشائعة. + +## تثبيت خطافات الالتقاط والسياسة - 1. افتح **Administration → Keys** وأنشئ مفتاحاً باستخدام `events:add` و `policies:pull`، وسمه باسم الجهاز أو البيئة. - 2. على الجهاز الهدف، اربط واجهة سطر الأوامر المحلية بالمفتاح المعروض وثبت hooks أداة التكامل. - 3. ابدأ جلسة عميل جديدة، ثم تأكد من أحداث hook والجلسة الخاصة بها تحت **Observe → Events**. - 4. افتح **Observe → policy** لنفس نطاق الوقت وتأكد من أن قرار السياسة ينسب إلى الجهاز. + 1. افتح **الإدارة → المفاتيح** وأنشئ مفتاحاً مع `events:add` و `policies:pull`، مسمى للجهاز أو البيئة. + 2. على الجهاز المستهدف، اربط CLI المحلي بالمفتاح المعروض وثبت خطافات الخادم. + 3. ابدأ جلسة وكيل جديدة، ثم أكد أحداث الخطاف والجلسة تحت **مراقبة → الأحداث**. + 4. افتح **مراقبة → السياسة** لنفس نطاق الوقت وأكد أن قرار السياسة يُنسب للجهاز. - يبدأ الاتصال بمفتاح الجهاز. تأكد من أنه يتضمن أذونات الاستهلاك وتسليم السياسة قبل نسخ سره. + يبدأ الاتصال بمفتاح آلة. تأكد من أنه يتضمن أذونات الهضم وتسليم السياسة قبل نسخ سره. - ![درج مفتاح API الجديد المستخدم لمنح أذونات استهلاك الأحداث وتسليم السياسة.](/images/dashboard/key-create.png) + ![درج مفتاح API الجديد المستخدم لمنح أذونات هضم الأحداث وتسليم السياسة.](/images/dashboard/key-create.png) - بعد تثبيت hooks، يجب أن يعرض دفق الأحداث أحداثاً جديدة من الجهاز والبيئة التي وصلت إليها. + بعد تثبيت الخطافات، يجب أن يعرض دفق الأحداث أحداثاً جديدة من الجهاز والبيئة التي اتصلت بها. - ![دفق الأحداث المباشر المستخدم لتأكيد أن أداة التكامل المثبتة حديثاً تقدم تقارير.](/images/dashboard/events-stream.png) + ![دفق الأحداث المباشر المستخدم للتأكد من أن خادماً مثبتاً حديثاً يقدم تقارير.](/images/dashboard/events-stream.png) - أخيراً، تحقق من أن قرارات السياسة تنسب إلى نفس الجهاز. هذا يؤكد أن أداة التكامل تقدم تقارير عن أنشطة السياسة بالإضافة إلى أحداث التتبع. + أخيراً، تحقق من أن قرارات السياسة تُنسب للجهاز ذاته. هذا يؤكد أن الخادم يقدم تقارير عن نشاط السياسة وكذلك أحداث التتبع. - ![صفحة السياسة المستخدمة للتحقق من قرارات السياسة من أداة تكامل متصلة حديثاً.](/images/dashboard/policy-observe.png) + ![صفحة السياسة المستخدمة للتحقق من قرارات السياسة من خادم موصول حديثاً.](/images/dashboard/policy-observe.png) - ثبت hooks لكل أداة تكامل مكتشفة: + ثبت الخطافات لكل خادم مكتشف: ```bash failproofai config \ @@ -67,7 +75,7 @@ icon: "plug-zap" failproofai policies --install ``` - أو استهدف أدوات التكامل المسماة ونطاق الإعدادات: + أو استهدف خوادم بأسماء ونطاق إعدادات: ```bash failproofai policies --install \ @@ -75,7 +83,7 @@ icon: "plug-zap" --scope user ``` - يحتفظ نطاق المشروع بإعدادات hook مع مستودع. يغطي نطاق المستخدم العمل عبر المستودعات. يدعم Claude Code أيضاً نطاق local؛ الدعم يختلف حسب أداة التكامل وواجهة سطر الأوامر ترفض المجموعات غير المدعومة. + يحتفظ نطاق المشروع بتكوين الخطاف مع مستودع. يغطي النطاق ذو المستخدم العمل عبر المستودعات. Claude Code يدعم أيضاً النطاق المحلي؛ يختلف الدعم حسب الخادم ويرفض CLI المجموعات غير المدعومة. تحقق من الجهاز وأحداثه: @@ -91,12 +99,12 @@ icon: "plug-zap" - يتم تسجيل المسارات الإضافية على الجهاز، وليس في السحابة. بعد إضافة واحد، افتح **Observe → Sessions** وصفّي البيئة الخاصة بالجهاز، وتأكد من ظهور الجلسات من المسار الجديد. افتح جلسة وتحقق من العميل و أداة التكامل و طوابع الوقت للأحداث قبل الاعتماد عليها في التدقيق. + يتم تسجيل المسارات الإضافية على الجهاز، وليس في السحابة. بعد إضافة واحد، افتح **مراقبة → الجلسات**، وصفّي بيئة الجهاز، وأكد ظهور الجلسات من المسار الجديد. افتح جلسة وتحقق من الوكيل والخادم وطوابع زمن الحدث قبل الاعتماد عليها في تدقيق. - ![قائمة الجلسات مصفاة للبيئة التي تتلقى البيانات من مسار الالتقاط الإضافي.](/images/dashboard/sessions-list.png) + ![قائمة الجلسات المصفاة إلى البيئة التي تتلقى البيانات من مسار التقاط إضافي.](/images/dashboard/sessions-list.png) - أضف مسار مع تسمية اختيارية، ثم افحص المسارات المعدة: + أضف مساراً مع تسمية اختيارية، ثم فتش المسارات المكونة: ```bash failproofai harness add-path claude checkout=/srv/checkout/.claude @@ -105,10 +113,10 @@ icon: "plug-zap" failproofai backfill --since 7d ``` - أزل مسار باستخدام `failproofai harness remove-path claude checkout`. + أزل مساراً باستخدام `failproofai harness remove-path claude checkout`. - قم بتشغيل جلسة جديدة واحدة بعد التثبيت. تحقق من كل من دفق الأحداث المباشر وقرار السياسة الفعلي قبل توسيع الطرح. + قم بتشغيل جلسة واحدة جديدة بعد التثبيت. تحقق من دفق الأحداث المباشر وقرار سياسة فعلي قبل توسيع الطرح. \ No newline at end of file diff --git a/docs/ar/sessions/live-events.mdx b/docs/ar/sessions/live-events.mdx index 0e3b1203d..ec5daf22e 100644 --- a/docs/ar/sessions/live-events.mdx +++ b/docs/ar/sessions/live-events.mdx @@ -5,18 +5,18 @@ description: "شاهد نشاط الوكيل يصل أثناء تشغيل الج icon: "radio" --- -تساعدك الأحداث المباشرة على تأكيد التجهيز ومراقبة تشغيل محفوف بالمخاطر دون انتظار انتهاء الجلسة. +تساعدك الأحداث المباشرة على تأكيد الأداة المساعدة ومراقبة عملية محفوفة بالمخاطر دون انتظار انتهاء الجلسة. ## مراقبة النشاط - + 1. انتقل إلى **Observe → Events**. - 2. ابدأ بإطار الوقت الحالي وبدون مرشحات لتأكيد وصول البيانات. - 3. قم بالتصفية حسب البيئة أو نوع الحدث أو الوكيل أو الجلسة. استخدم البحث عن نص الحمولة. - 4. حدد حدثًا لفحص ملخصه والتفاصيل. اتبع رابط جلسته للحصول على التتبع الكامل. + 2. ابدأ بنطاق الوقت الحالي وبدون مرشحات لتأكيد وصول البيانات. + 3. صفّي حسب البيئة أو نوع الحدث أو الوكيل أو الجلسة. استخدم البحث لنص الحمولة. + 4. اختر حدثاً لفحص ملخصه والتفاصيل. اتبع رابط الجلسة للحصول على التتبع الكامل. - ![تيار الأحداث المباشر مع مرشحات الوقت والبيئة ونوع الحدث والوكيل والنموذج والسياق والجلسة والنص.](/images/dashboard/events-stream-current.png) + ![تيار الأحداث المباشر يعرض حركة المرور من بوابة محادثة Hermes إلى جانب عمليات تشغيل الترميز عبر سطر الأوامر، مفصولة حسب الوقت والبيئة ونوع الحدث والوكيل والنموذج والسياق والجلسة.](/images/dashboard/events-stream-current.png) ```bash @@ -25,20 +25,22 @@ icon: "radio" fp --json events --full --session-id --all ``` - يستبعد التغذية الافتراضية الحمولات الخام. استخدم `--full` فقط لتحقيق محدود الجلسة. + يحذف العرض الافتراضي الحمولات الخام. استخدم `--full` فقط للتحقيق في جلسة محدودة. استخدم تيار الأحداث للإجابة على ثلاثة أسئلة فورية: -- هل الوكيل المتوقع يقدم تقارير إلى البيئة الصحيحة؟ -- هل استدعاءات النموذج واستدعاءات الأداة وقرارات السياسة تصل بالترتيب الصحيح؟ -- هل توقفت الجلسة عن الإحراز تقدم أو بدأت بتكرار إجراء؟ +- هل الوكيل المتوقع يبلّغ عن البيئة الصحيحة؟ +- هل تصل استدعاءات النموذج واستدعاءات الأداة وقرارات السياسة بالترتيب الصحيح؟ +- هل توقفت الجلسة عن إحراز تقدم أم بدأت في تكرار إجراء ما؟ -تشمل أنواع الأحداث أحداث دورة حياة الوكيل وطلبات النموذج والردود وحالات الاستخدام والنتائج وتنفيذ الخطاف والانتظار البشري والمقاطعات والأخطاء الصريحة. تربط معرفات الارتباط الأحداث المقترنة مثل استدعاء الأداة ونتيجتها. +تتضمن أنواع الأحداث أحداث دورة حياة الوكيل وطلبات واستجابات النموذج واستخدام الأداة والنتائج وتنفيذ الخطاف والانتظارات البشرية والمقاطعات والأخطاء الصريحة. تجمع معرّفات الارتباط بين الأحداث المقترنة مثل استدعاء الأداة ونتيجتها. - حافظ على العرض المباشر واسعًا أثناء التحقق من التكامل الجديد. أضف المرشحات فقط بعد رؤية الحدث الأول؛ قد يبدو المرشح غير الصحيح كفشل في الاستيعاب. + احتفظ بالعرض المباشر واسعاً أثناء التحقق من تكامل جديد. أضف مرشحات فقط بعد رؤية الحدث الأول؛ يمكن لمرشح غير صحيح أن يبدو وكأنه فشل في الاستقبال. -إذا لم تظهر أي أحداث، قم بتشغيل `failproofai config --status`، ثم [استكشف مشاكل الاستيعاب](/ar/reference/troubleshooting). \ No newline at end of file +إذا لم تظهر أحداث، قم بتشغيل `failproofai config --status`، ثم [استكشف أخطاء الاستقبال](/ar/reference/troubleshooting). + +الوكلاء الذين لا يعملون في أحد الـ 12 [الأطر العمل](/ar/reference/harnesses) المدعومة يبلّغون عن نفس أنواع الأحداث من خلال [Python SDK](/ar/reference/python-sdk)، بما في ذلك أحداث التفاعل البشري (`human_wait` و `human_input` و `human_interrupt`) التي تعتمد عليها وكلاء البوابة والإنتاج. \ No newline at end of file diff --git a/docs/ar/sessions/overview.mdx b/docs/ar/sessions/overview.mdx index 5eead6f58..e0c0aa9b6 100644 --- a/docs/ar/sessions/overview.mdx +++ b/docs/ar/sessions/overview.mdx @@ -1,56 +1,58 @@ --- --- title: "الجلسات" -description: "ابدأ بسجل كامل لتشغيل وكيل واحد." +description: "ابدأ بالسجل الكامل لتشغيل وكيل واحد." icon: "workflow" --- -الجلسة هي أفضل نقطة انطلاق عندما يتصرف الوكيل بشكل غير متوقع. فهي تجمع طلبات النموذج والاستجابات واستدعاءات الأدوات والتفاعلات البشرية والأخطاء والتقييمات وقرارات السياسة التي تتعلق بتشغيل واحد. +الجلسة هي أفضل نقطة انطلاق عندما يتصرف وكيل بشكل غير متوقع. فهي تجمع بين طلبات النموذج والاستجابات واستدعاءات الأدوات والتفاعلات البشرية والأخطاء والتقييمات وقرارات السياسة التي تنتمي إلى تشغيل واحد. + +تبدو الجلسات متطابقة بغض النظر عن الأداة التي أنتجتها. سواء كان تشغيل Claude Code يعيد كتابة مستودع، أو وكيل Hermes يجيب على عميل في Slack، أو خدمة Python مزودة بـ Agents SDK، فإنها جميعاً تصل إلى نفس صيغة التتبع، لذا عرض واحد يغطي أسطول كامل.
-تابع تشغيل وكيل واحد من هدفه عبر استدعاءات النموذج والأدوات والاستجابة النهائية. +اتبع تشغيل وكيل واحد من هدفه عبر استدعاءات النموذج والأدوات والاستجابة النهائية. ## البحث عن جلسة - - 1. في شريط Cloud الجانبي، انتقل إلى **Observe → Sessions**. - 2. عيّن نافذة زمنية، ثم صفّ حسب البيئة أو الحالة أو الوكيل أو معرّف الجلسة. - 3. أضف نطاقات النقاط أو المقاييس عندما تحتاج إلى قطاع الجودة أو التكلفة أو الرمز المميز أو الكمون. - 4. حدد صفًا لفتح تتبعه. استخدم عنصر النسخ بجانب معرّف الجلسة عند مشاركتها. + + 1. في الشريط الجانبي للسحابة، انتقل إلى **Observe → Sessions**. + 2. عيّن نافذة زمنية، ثم صفّي حسب البيئة والحالة والوكيل أو معرّف الجلسة. + 3. أضف نطاقات الدرجات أو المقاييس عندما تحتاج إلى شرائح الجودة أو التكلفة أو الرموز أو الكمون. + 4. حدد صفاً لفتح تتبعه. استخدم عنصر النسخ بجانب معرّف الجلسة عند مشاركتها. - ![قائمة الجلسات تعرض صفًا واحدًا لكل تشغيل مع فلاتر البيئة والوكيل والحالة ونقاط التقييم.](/images/dashboard/sessions-list.png) + ![قائمة الجلسات تعرض صفاً واحداً لكل تشغيل مع مرشحات البيئة والوكيل والحالة ودرجة التقييم.](/images/dashboard/sessions-list.png) - + ```bash fp sessions --env production --since 24h fp sessions --status error,timeout --agent-id checkout-agent fp --json sessions --session-id ``` - أضف `--agents` لتوسيع التشغيلات متعددة الوكيلات، أو `--all` للترقيم، أو `--fields` لاختيار أعمدة الإخراج. + أضف `--agents` لتوسيع تشغيلات متعددة الوكلاء، أو `--all` للترقيم، أو `--fields` لاختيار أعمدة الإخراج. -## ما يمكنك فعله +## ما يمكنك القيام به -- ابحث عن تشغيل حسب الوكيل أو البيئة أو الوقت أو النموذج أو نوع الحدث أو حالة الخطأ. +- ابحث عن تشغيل حسب الوكيل والبيئة والوقت والنموذج ونوع الحدث أو حالة الخطأ. - اتبع التسلسل الدقيق الذي أنتج النتيجة. - قارن بين التشغيلات الناجحة والفاشلة. -- افتح الأدلة المستخدمة من قبل نتيجة تدقيق أو حادث تنبيه. -- صدّر جلسة عندما تحتاج إلى سجل غير متصل. +- افتح الأدلة المستخدمة من قبل نتيجة التدقيق أو حادثة تنبيه. +- صدّر جلسة عندما تحتاج إلى سجل دون اتصال. -## ترتيب تحقيق موثوق به +## ترتيب التحقيق الموثوق -1. أكّد هدف الجلسة والبيئة. -2. ابحث عن الخطأ الأول أو القرار غير المتوقع—وليس فقط الفشل النهائي. -3. افحص سياق النموذج ومدخلات الأداة مباشرة قبله. -4. تحقق من إعادة المحاولات والكمون والمقاطعات البشرية. -5. راجع نقاط التقييم وقرارات السياسة. +1. أكد هدف الجلسة والبيئة. +2. ابحث عن أول خطأ أو قرار غير متوقع—ليس الفشل النهائي فقط. +3. افحص سياق النموذج ومدخل الأداة قبل ذلك مباشرة. +4. تحقق من المحاولات الجديدة والكمون والمقاطعات البشرية. +5. راجع درجات التقييم وقرارات السياسة. - - تعلم كيفية الانتقال من ملخص الجلسة إلى الحدث الذي تسبب في النتيجة. + + تعرف على كيفية الانتقال من ملخص الجلسة إلى الحدث الذي تسبب في النتيجة. \ No newline at end of file diff --git a/docs/ar/start/quickstart.mdx b/docs/ar/start/quickstart.mdx index 09c90ad11..7742b7bcf 100644 --- a/docs/ar/start/quickstart.mdx +++ b/docs/ar/start/quickstart.mdx @@ -1,11 +1,12 @@ --- ---- title: "البدء السريع" -description: "التقط جلسة وكيل، اعثر على عطل، وابدأ في منعه." +description: "التقط جلسة وكيل، وجد عطلاً، وابدأ في منعه." icon: "zap" --- -يوفر هذا البدء السريع إعداد جهاز واحد للإبلاغ عن الجلسات، وتشغيل تدقيق، ونشر سياسة. استخدم المهارة لإعداد Failproof AI، أو اتبع الخطوات اليدوية. تحتاج إلى Node.js 20.9 أو إصدار أحدث. +يوفر هذا البدء السريع تشغيل جهاز واحد لإرسال الجلسات، وتشغيل تدقيق، ونشر سياسة. استخدم المهارة لإعداد Failproof AI، أو اتبع الخطوات اليدوية. + +**أي المسارات تناسبك؟** إذا كان وكيلك يعمل في أحد [الأطر المدعومة](/ar/reference/harnesses) الـ 12 — واجهة سطر أوامر برمجية أو بوابة مثل Hermes أو OpenClaw — اتبع الخطوات أدناه؛ تحتاج إلى Node.js 20.9 أو إصدار أحدث. إذا لم يكن لدى وكيلك إطار عمل، فقم بتجهيزه باستخدام [Python SDK](/ar/reference/python-sdk) للتتبع والتدقيق، ثم عد إلى [تشغيل فحص الفشل الأول](/ar/start/first-audit)؛ الإنفاذ في هذا المسار يحتاج إلى hook في وقت التشغيل. @@ -20,16 +21,16 @@ icon: "zap" Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - يفحص الوكيل المشروع، ويختار التكامل ذا الصلة، ويقوم بالإعداد، ويتحقق منه. راجع [مستودع مهارات FailproofAI](https://github.com/FailproofAI/skills) للحصول على المهارات الفردية وخيارات التثبيت المتقدمة. + يتفحص وكيلك المشروع، ويختار التكامل ذا الصلة، ويجري الإعداد، ويتحقق منه. راجع [مستودع مهارات FailproofAI](https://github.com/FailproofAI/skills) للحصول على المهارات الفردية وخيارات التثبيت المتقدمة. ## قبل أن تبدأ -1. افتح [لوحة معلومات Failproof AI](https://app.befailproof.ai) وأنشئ حسابًا أو سجّل الدخول باستخدام بريدك الإلكتروني للعمل. -2. انتقل إلى **Administration → Keys** وأنشئ مفتاحًا باستخدام `events:add` و `policies:pull`. -3. انسخ السر لمرة واحدة وخزّنه على الجهاز الهدف: +1. افتح [لوحة تحكم Failproof AI](https://app.befailproof.ai) وأنشئ حساباً أو سجل الدخول باستخدام بريدك الإلكتروني للعمل. +2. انتقل إلى **Administration → Keys** وأنشئ مفتاحاً باستخدام `events:add` و `policies:pull`. +3. انسخ السر لمرة واحدة وقم بتخزينه على الجهاز المستهدف: ```bash export FAILPROOFAI_KEY="" @@ -38,15 +39,15 @@ export FAILPROOFAI_KEY="" ## التثبيت - + ```bash npm install -g failproofai failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - يتم إرسال نصوص الجلسات بشكل افتراضي. أضف `--no-transcripts` للإبلاغ عن نشاط الخطاف وقرارات السياسة دون محتوى النص. + يتم إرسال نصوص الجلسات بشكل افتراضي. أضف `--no-transcripts` للإبلاغ عن نشاط hook وقرارات السياسة دون محتوى النص. - إذا كان هذا الجهاز يحتوي بالفعل على سجل وكيل، فاعرض واستيراد آخر سبعة أيام، ثم انتظر انتهاء التسليم. تخطَّ هذه الخطوة على جهاز جديد. + إذا كان لدى هذا الجهاز بالفعل سجل وكيل، معاينة واستيراد آخر سبعة أيام، ثم انتظر انتهاء التسليم. تخطَّ هذه الخطوة على جهاز جديد. ```bash failproofai backfill --since 7d --dry-run @@ -54,27 +55,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - افتح **Sessions** في Failproof AI وحدد جلسة مستوردة. + افتح **Sessions** في Failproof AI واختر جلسة مستوردة. - - يؤدي هذا إلى إرفاق Failproof AI بواجهة سطر أوامر الوكيل الخاص بك وتثبيت السياسات المدمجة. استخدمها لرؤية قرارات السياسة المحلية وجرب الإنفاذ قبل أن يقوم Failproof AI بتدقيق جلساتك وكتابة السياسات للوكلاء الخاصين بك. + + يربط Failproof AI بإطار العمل الخاص بك وينصب السياسات المدمجة الـ 40. استخدمها لرؤية قرارات السياسة المحلية وجرب الإنفاذ قبل أن يقوم Failproof AI بتدقيق جلساتك وكتابة السياسات لوكلائك. - دع المثبِّت يكتشف واجهة سطر أوامر الوكيل الخاص بك، أو سمِّ واحدة بشكل صريح. + دع المثبت يكتشف إطار العمل الخاص بك، أو قم بتسمية واحد صراحةً. كل واحد من الـ 12 هو قيمة `--cli` صحيحة — `claude`، `codex`، `copilot`، `cursor`، `opencode`، `pi`، `hermes`، `openclaw`، `factory`، `devin`، `antigravity`، `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # a coding CLI + failproofai policies --install --cli hermes --scope user # a Slack/Telegram gateway ``` + + يتم التحقق من حظر استدعاء أداة قبل تشغيله في جميع الـ 12. يتم التحقق من بوابات نهاية الدور في 8 — راجع [قدرة الإنفاذ](/ar/reference/harnesses#enforcement-capability) للحصول على مصفوفة لكل إطار عمل. - - اتبع [تشغيل فحص الفشل الأول](/ar/start/first-audit). استخدم هدفًا ملموسًا مثل "ابحث عن الجلسات التي أعاد فيها الوكيل محاولة أداة فاشلة دون تغيير نهجه." + + اتبع [تشغيل فحص الفشل الأول](/ar/start/first-audit). استخدم هدفاً ملموساً مثل "ابحث عن الجلسات حيث أعاد الوكيل محاولة أداة فاشلة دون تغيير نهجه." - اتبع [منع الفشل الأول باستخدام سياسة](/ar/start/first-policy). ابدأ في وضع المراقبة، افحص التطابقات، ثم طبّق النسخة المراجعة. + اتبع [منع فشلك الأول بسياسة](/ar/start/first-policy). ابدأ بوضع المراقبة، افحص المطابقات، ثم طبق الإصدار المراجع. - شغّل `failproofai config --status`. يبلغ الإعداد السليم عن اتصال السحابة وحالة daemon والعملية الموقوفة. + قم بتشغيل `failproofai config --status`. يبلغ الإعداد الصحي عن اتصال السحابة وحالة daemon وما إذا كان الإنفاذ معلقاً. \ No newline at end of file diff --git a/docs/de/index.mdx b/docs/de/index.mdx index 58dc15f35..6476ea377 100644 --- a/docs/de/index.mdx +++ b/docs/de/index.mdx @@ -1,39 +1,41 @@ --- title: "Mach deinen Agenten ausfallsicher" -description: "Failproof AI verfolgt das Verhalten von Agenten, überprüft Sitzungen auf Fehler und setzt Richtlinien ein, die Wiederholungsvorfälle verhindern." +description: "Observability und Durchsetzung für jede Umgebung, in der deine Agenten laufen — Coding-CLIs, Chat-Gateways, selbstgehostete Assistenten und eigene instrumentierte Agenten." icon: "shield-check" --- -Failproof AI hilft Teams zu verstehen, was Agenten getan haben, Fehler zu finden und Schutzmaßnahmen bereitzustellen, bevor dasselbe Verhalten erneut auftritt. +Failproof AI hilft Teams dabei zu verstehen, was Agenten getan haben, herauszufinden, wo sie gescheitert sind, und Schutzmaßnahmen einzurichten, bevor dasselbe Verhalten erneut auftritt. + +Ein **Harness** ist die Umgebung, in der dein Agent tatsächlich ausgeführt wird. Failproof AI unterstützt 12 davon — Coding-CLIs wie Claude Code und Codex, Chat-Gateways wie Hermes, selbstgehostete Assistenten wie OpenClaw — und dieselben Ereignisse, dieselben Richtlinien und dieselbe Sitzungshistorie gelten für alle. Agenten ohne Harness melden sich über das [Python SDK](/de/reference/python-sdk) an, das sie verfolgt und prüft; die Durchsetzung einer Richtlinie dort erfordert einen Hook in deiner eigenen Laufzeitumgebung. - Verwende das Skill, um dein Projekt zu instrumentieren, es zu verbinden und sicherzustellen, dass Agenten-Logs ankommen. + Nutze die Skill-Funktion, um dein Projekt zu instrumentieren, es zu verbinden und zu überprüfen, dass Agenten-Logs ankommen. - Analysiere, stelle Abfragen, erstelle Dashboards und führe Audits in natürlicher Sprache auf deinen Agenten-Logs aus. + Analysiere, frage ab, erstelle Dashboards und führe Audits in natürlicher Sprache auf deinen Agenten-Logs durch. - + Verfolge Modellaufrufe, Tools, Fehler, menschliche Eingaben, Latenz und Richtlinienentscheidungen in einer einzigen Sitzung. - Prüfe eine definierte Menge von Sitzungen, überprüfe evidenzbasierte Erkenntnisse und verfolge die Behebung als Issues. + Prüfe eine definierte Menge von Sitzungen, überprüfe evidenzbasierte Befunde und verfolge die Behebung als Issues. - Verwandle einen bekannten Fehlerfall in eine Richtlinie, beobachte deren Auswirkung und setze sie in deiner gesamten Flotte ein. + Wandle einen bekannten Fehlerfall in eine Richtlinie um, beobachte ihre Wirkung und setze sie in deiner gesamten Flotte ein. -> **Sitzung → Audit → Erkenntnis → Issue → Richtlinie**
-> Verfolge, was passiert ist, finde den Fehler, verwalte die Reaktion und verhindere dasselbe Verhalten in zukünftigen Ausführungen. +> **Sitzung → Audit → Befund → Issue → Richtlinie**
+> Verfolge, was passiert ist, finde den Fehler, steuere die Reaktion und verhindere dasselbe Verhalten in zukünftigen Ausführungen. -## Hier anfangen +## Hier starten -Wenn du deinen ersten instrumentierten Agenten bereitstellst, beginne mit dem [Quickstart](/de/start/quickstart). Wenn bereits Daten eintreffen, öffne [Sessions](/de/sessions/overview) und untersuche einen echten Durchlauf, bevor du Audits oder Richtlinien konfigurierst. +Wenn du deinen ersten instrumentierten Agenten bereitstellst, beginne mit dem [Quickstart](/de/start/quickstart). Wenn bereits Daten eingehen, öffne [Sessions](/de/sessions/overview) und untersuche einen echten Durchlauf, bevor du Audits oder Richtlinien konfigurierst. - Führe den vollständigen Workflow von der Erfassung bis zur sicher bereitgestellten Richtlinie durch. + Durchlaufe den End-to-End-Workflow von der Erfassung bis zur sicher eingesetzten Richtlinie. \ No newline at end of file diff --git a/docs/de/reference/harnesses.mdx b/docs/de/reference/harnesses.mdx index 2462dd43d..7ef4ad3ba 100644 --- a/docs/de/reference/harnesses.mdx +++ b/docs/de/reference/harnesses.mdx @@ -1,61 +1,68 @@ --- title: "Agent-Harnesses" -description: "Sitzungen erfassen und Richtlinien in unterstützten Agent-CLIs durchsetzen." +description: "Sitzungen erfassen und Richtlinien für alle 12 unterstützten Agent-Harnesses durchsetzen." icon: "plug-zap" --- -Failproof AI unterstützt Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI und Goose. +Ein Harness ist die Umgebung, in der Ihr Agent tatsächlich ausgeführt wird. Failproof AI unterstützt zwölf davon, in zwei Klassen: -| Harness | Unterstützte Hook-Bereiche | +- **Coding-CLIs** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **Chat- und Assistant-Gateways** (2) — Hermes (Slack, Telegram, Cron), OpenClaw (selbst gehosteter Assistent) + +Dieselben Richtlinien und dieselbe Sitzungshistorie gelten unabhängig davon, in welchem Harness ein Agent ausgeführt wird. Eine Adapterschicht bildet die nativen Ereignisnamen, Tool-Namen und Tool-Eingabefelder jedes Harnesses auf 29 kanonische Ereignisse ab, bevor eine Richtlinie ausgeführt wird. + +Ein Agent, der in **keinem** der zwölf Harnesses läuft, wird direkt mit dem [Python SDK](/de/reference/python-sdk) instrumentiert. Das ist ein anderer Vertrag, und es lohnt sich, dies klar zu benennen: Das SDK liefert Tracing, Sitzungen, Evaluierungen und Audits — **es setzt Richtlinien nicht eigenständig durch.** Um eine unsichere Aktion zu blockieren, bevor sie ausgeführt wird, ist ein Enforcement-Hook an der Tool-Grenze Ihrer Laufzeitumgebung erforderlich. [Kontaktieren Sie uns](mailto:support@befailproof.ai), und wir werden die Zuordnung vornehmen. + +| Harness | Unterstützte Hook-Scopes | | --- | --- | | Claude Code | User, project, local | | Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | | Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | | Hermes, OpenClaw | User | -Jede Integration normalisiert die nativen Hook-Ereignisnamen, Tool-Namen und Tool-Eingabefelder, bevor Richtlinien ausgeführt werden. Eine Richtlinie kann nur auf Ereignisse reagieren, die der Harness bereitstellt; testen Sie das Verhalten bei Gesprächsende und Anweisungen auf dem genauen Harness und der Version, die Sie einsetzen. +Jede Integration normalisiert ihre nativen Hook-Ereignisnamen, Tool-Namen und Tool-Eingabefelder, bevor Richtlinien ausgeführt werden. Eine Richtlinie kann nur auf Ereignisse reagieren, die der Harness bereitstellt. Testen Sie das Verhalten am Ende eines Turns und das Verhalten bei Anweisungen auf dem genauen Harness und der genauen Version, die Sie einsetzen. ## Durchsetzungsfähigkeit -„Blockieren" bedeutet, dass das zurückgegebene Urteil des aktuellen Adapters vom genannten Harness verarbeitet wird. Post-Tool-Blockierung kann das dem Modell angezeigte Ergebnis ersetzen, kann aber einen bereits eingetretenen Tool-Nebeneffekt nicht rückgängig machen. +„Blockieren" bedeutet, dass das vom aktuellen Adapter zurückgegebene Urteil vom genannten Harness verarbeitet wird. Post-Tool-Blockierung kann das dem Modell angezeigte Ergebnis ersetzen, aber keine Tool-Nebenwirkung rückgängig machen, die bereits eingetreten ist. -| Harness | Verifizierte blockierende Ereignisse | Nur-Beobachtungs- oder nicht-blockierende Hinweise | +| Harness | Verifizierte Blockierungsereignisse | Nur-Beobachtungs- oder nicht-blockierende Hinweise | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` sowie mehrere Task-/Konfigurations-Ereignisse | `PostToolUse`, Sitzungslebenszyklus, Benachrichtigungen und Post-Fehler-Ereignisse sind beobachtend. | +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` und mehrere Task-/Konfigurationsereignisse | `PostToolUse`, Sitzungslebenszyklus, Benachrichtigungen und Post-Fehler-Ereignisse sind beobachtend. | | Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Post-Tool-Blockierung ersetzt das Ergebnis nach der Ausführung; Sitzungsstart- und Compact-Ereignisse sind im aktuellen Adapter beobachtend. | | GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Post-Tool-Blockierung ersetzt das Ergebnis nach der Ausführung; Sitzungs- und Benachrichtigungsereignisse sind beobachtend. | | Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` und Sitzungsereignisse sind beobachtend. | -| OpenCode | `PreToolUse` | Post-Tool- und Lebenszyklus-Ereignisse sind beobachtend; die aktuelle Stop-Behandlung ist eine Anleitung für einen späteren Gesprächszug, kein verifiziertes Gate. | -| Pi | `PreToolUse`, `UserPromptSubmit` | Post-Tool- und Lebenszyklus-Ereignisse sind beobachtend; Stop-Anleitung gilt für einen späteren Gesprächszug. | +| OpenCode | `PreToolUse` | Post-Tool- und Lebenszyklusereignisse sind beobachtend; die aktuelle Stop-Behandlung ist eine Empfehlung für einen späteren Turn, kein verifiziertes Gate. | +| Pi | `PreToolUse`, `UserPromptSubmit` | Post-Tool- und Lebenszyklusereignisse sind beobachtend; Stop-Empfehlungen gelten für einen späteren Turn. | | Hermes | `PreToolUse` | Post-Tool-, Sitzungs- und Subagent-Stop-Urteile sind keine Gates. | | OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Post-Tool-, Sitzungs-, Subagent-Stop- und Compaction-Ereignisse sind beobachtend. | | Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Post-Tool- und Subagent-Stop-Urteile sind beobachtend. | | Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, bedingtes `PermissionRequest` | Permission-Hooks laufen nicht in jedem Permission-Modus; Post-Tool- und Sitzungsereignisse sind beobachtend. | -| Antigravity CLI | `PreToolUse`, `Stop` | User-Prompt- und Post-Tool-Urteile sind beobachtend; Prompt-Anweisungen können dennoch injiziert werden. | +| Antigravity CLI | `PreToolUse`, `Stop` | User-Prompt- und Post-Tool-Urteile sind beobachtend; Prompt-Anweisungen können weiterhin injiziert werden. | | Goose | `PreToolUse` | User-Prompt-, Post-Tool- und Sitzungsereignisse sind beobachtend. Ein nativer blockierender Stop-Hook existiert im Upstream, wird aber vom aktuellen Adapter nicht installiert. | -Die Fähigkeiten sind versionsabhängig. Testen Sie erneut nach einem Upgrade einer Agent-CLI, insbesondere wenn eine Richtlinie auf Prompt-, Stop-, Permission- oder Post-Tool-Verhalten statt auf das übliche Pre-Tool-Gate angewiesen ist. +Die Fähigkeiten sind versionsabhängig. Führen Sie nach dem Upgrade einer Agent-CLI erneut Tests durch, insbesondere wenn eine Richtlinie auf Prompt-, Stop-, Permission- oder Post-Tool-Verhalten statt auf das übliche Pre-Tool-Gate angewiesen ist. -## Erfassungs- und Richtlinien-Hooks installieren +## Capture- und Policy-Hooks installieren - 1. Öffnen Sie **Administration → Keys** und erstellen Sie einen Schlüssel mit `events:add` und `policies:pull`, benannt nach der Maschine oder Umgebung. + 1. Öffnen Sie **Verwaltung → Schlüssel** und erstellen Sie einen Schlüssel mit `events:add` und `policies:pull`, benannt nach der Maschine oder Umgebung. 2. Verbinden Sie auf der Zielmaschine die lokale CLI mit dem angezeigten Schlüssel und installieren Sie die Harness-Hooks. - 3. Starten Sie eine neue Agent-Sitzung und bestätigen Sie deren Hook- und Sitzungsereignisse unter **Observe → Events**. - 4. Öffnen Sie **Observe → policy** für dasselbe Zeitfenster und bestätigen Sie, dass eine Richtlinienentscheidung der Maschine zugeordnet wird. + 3. Starten Sie eine neue Agent-Sitzung und bestätigen Sie deren Hook- und Sitzungsereignisse unter **Beobachten → Ereignisse**. + 4. Öffnen Sie **Beobachten → Richtlinie** für dasselbe Zeitfenster und bestätigen Sie, dass eine Richtlinienentscheidung der Maschine zugeordnet wird. - Die Verbindung beginnt mit einem Maschinenschlüssel. Stellen Sie sicher, dass er sowohl Ingestion- als auch Richtlinien-Übermittlungsberechtigungen enthält, bevor Sie sein Secret kopieren. + Die Verbindung beginnt mit einem Maschinenschlüssel. Vergewissern Sie sich, dass er sowohl Ingestion- als auch Policy-Delivery-Berechtigungen enthält, bevor Sie sein Secret kopieren. - ![Die neue API-Schlüssel-Schublade zum Erteilen von Ereignis-Ingestion- und Richtlinien-Übermittlungsberechtigungen.](/images/dashboard/key-create.png) + ![Die Schublade für neue API-Schlüssel zum Erteilen von Ereigniserfassungs- und Richtlinienlieferberechtigungen.](/images/dashboard/key-create.png) Nach der Installation der Hooks sollte der Ereignis-Stream neue Ereignisse von der verbundenen Maschine und Umgebung anzeigen. - ![Der Live-Ereignis-Stream zur Bestätigung, dass ein neu installierter Harness Daten meldet.](/images/dashboard/events-stream.png) + ![Der Live-Ereignis-Stream zur Bestätigung, dass ein neu installierter Harness meldet.](/images/dashboard/events-stream.png) - Vergewissern Sie sich abschließend, dass Richtlinienentscheidungen derselben Maschine zugeordnet werden. Dies bestätigt, dass der Harness sowohl Richtlinienaktivitäten als auch Trace-Ereignisse meldet. + Überprüfen Sie abschließend, ob Richtlinienentscheidungen derselben Maschine zugeordnet werden. Dies bestätigt, dass der Harness sowohl Richtlinienaktivitäten als auch Trace-Ereignisse meldet. - ![Die Richtlinien-Seite zur Überprüfung von Richtlinienentscheidungen eines neu verbundenen Harness.](/images/dashboard/policy-observe.png) + ![Die Richtlinienseite zur Überprüfung von Richtlinienentscheidungen eines neu verbundenen Harnesses.](/images/dashboard/policy-observe.png) Hooks für alle erkannten Harnesses installieren: @@ -67,7 +74,7 @@ Die Fähigkeiten sind versionsabhängig. Testen Sie erneut nach einem Upgrade ei failproofai policies --install ``` - Oder bestimmte Harnesses und einen Konfigurationsbereich angeben: + Oder gezielt benannte Harnesses und einen Konfigurationsscope angeben: ```bash failproofai policies --install \ @@ -87,16 +94,16 @@ Die Fähigkeiten sind versionsabhängig. Testen Sie erneut nach einem Upgrade ei -## Nicht-standardmäßigen Sitzungspfad hinzufügen +## Einen nicht standardmäßigen Sitzungspfad hinzufügen - Zusätzliche Pfade werden auf der Maschine registriert, nicht in der Cloud. Öffnen Sie nach dem Hinzufügen eines Pfads **Observe → Sessions**, filtern Sie nach der Umgebung der Maschine und bestätigen Sie, dass Sitzungen aus dem neuen Pfad erscheinen. Öffnen Sie eine Sitzung und überprüfen Sie Agent, Harness und Ereignis-Zeitstempel, bevor Sie ihn für ein Audit verwenden. + Zusätzliche Pfade werden auf der Maschine registriert, nicht in der Cloud. Nachdem Sie einen hinzugefügt haben, öffnen Sie **Beobachten → Sitzungen**, filtern Sie nach der Umgebung der Maschine und bestätigen Sie, dass Sitzungen aus dem neuen Pfad erscheinen. Öffnen Sie eine Sitzung und überprüfen Sie Agent, Harness und Ereigniszeitstempel, bevor Sie ihn in einem Audit verwenden. - ![Die Sitzungsliste gefiltert nach der Umgebung, die Daten aus dem zusätzlichen Erfassungspfad empfängt.](/images/dashboard/sessions-list.png) + ![Die Sitzungsliste, gefiltert nach der Umgebung, die Daten aus dem zusätzlichen Capture-Pfad empfängt.](/images/dashboard/sessions-list.png) - Einen Pfad mit optionalem Label hinzufügen und die konfigurierten Pfade einsehen: + Einen Pfad mit optionalem Label hinzufügen und die konfigurierten Pfade anzeigen: ```bash failproofai harness add-path claude checkout=/srv/checkout/.claude @@ -105,10 +112,10 @@ Die Fähigkeiten sind versionsabhängig. Testen Sie erneut nach einem Upgrade ei failproofai backfill --since 7d ``` - Einen Pfad mit `failproofai harness remove-path claude checkout` entfernen. + Einen Pfad entfernen mit `failproofai harness remove-path claude checkout`. - Führen Sie nach der Installation eine neue Sitzung durch. Überprüfen Sie sowohl den Live-Ereignis-Stream als auch eine tatsächliche Richtlinienentscheidung, bevor Sie den Rollout ausweiten. + Führen Sie nach der Installation eine neue Sitzung aus. Überprüfen Sie sowohl den Live-Ereignis-Stream als auch eine tatsächliche Richtlinienentscheidung, bevor Sie den Rollout ausweiten. \ No newline at end of file diff --git a/docs/de/sessions/live-events.mdx b/docs/de/sessions/live-events.mdx index e50c3a0bc..c868fd500 100644 --- a/docs/de/sessions/live-events.mdx +++ b/docs/de/sessions/live-events.mdx @@ -1,21 +1,21 @@ --- title: "Live-Events" -description: "Agent-Aktivitäten in Echtzeit verfolgen, während eine Session läuft." +description: "Beobachte Agenten-Aktivität in Echtzeit, während eine Sitzung läuft." icon: "radio" --- -Live-Events helfen dabei, die Instrumentierung zu bestätigen und einen risikobehafteten Lauf zu beobachten, ohne auf das Ende der Session warten zu müssen. +Live-Events helfen dir, die Instrumentierung zu bestätigen und einen riskanten Lauf zu beobachten, ohne auf das Ende der Sitzung warten zu müssen. -## Aktivitäten beobachten +## Aktivität beobachten - 1. Navigiere zu **Observe → Events**. + 1. Gehe zu **Observe → Events**. 2. Beginne mit dem aktuellen Zeitfenster und ohne Filter, um zu bestätigen, dass Daten ankommen. - 3. Filtere nach Umgebung, Event-Typ, Agent oder Session. Nutze die Suche für Payload-Text. - 4. Wähle ein Event aus, um dessen Zusammenfassung und Details einzusehen. Folge dem Session-Link für den vollständigen Trace. + 3. Filtere nach Umgebung, Event-Typ, Agent oder Sitzung. Nutze die Suche für Payload-Text. + 4. Wähle ein Event aus, um dessen Zusammenfassung und Details einzusehen. Folge dem Sitzungslink für den vollständigen Trace. - ![Der Live-Events-Stream mit Filtern für Zeit, Umgebung, Event-Typ, Agent, Modell, Kontext, Session und Text.](/images/dashboard/events-stream-current.png) + ![Der Live-Events-Stream zeigt Traffic von einem Hermes-Chat-Gateway neben Coding-CLI-Läufen, gefiltert nach Zeit, Umgebung, Event-Typ, Agent, Modell, Kontext und Sitzung.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ Live-Events helfen dabei, die Instrumentierung zu bestätigen und einen risikobe fp --json events --full --session-id --all ``` - Der Standard-Feed lässt rohe Payloads aus. Verwende `--full` nur für eine eingegrenzte Session-Analyse. + Der Standard-Feed lässt rohe Payloads aus. Verwende `--full` nur für eine zeitlich begrenzte Sitzungsuntersuchung. Nutze den Event-Stream, um drei unmittelbare Fragen zu beantworten: -- Meldet sich der erwartete Agent an die richtige Umgebung? +- Meldet sich der erwartete Agent in der richtigen Umgebung? - Kommen Modellaufrufe, Tool-Aufrufe und Policy-Entscheidungen in der richtigen Reihenfolge an? -- Hat die Session aufgehört, Fortschritte zu machen, oder wiederholt sie eine Aktion? +- Hat die Sitzung aufgehört, Fortschritte zu machen, oder beginnt sie, eine Aktion zu wiederholen? -Event-Typen umfassen Agent-Lifecycle-Events, Modellanfragen und -antworten, Tool-Nutzung und Ergebnisse, Hook-Ausführung, menschliche Wartezeiten und Unterbrechungen sowie explizite Fehler. Correlation-IDs verknüpfen zusammengehörige Events, beispielsweise einen Tool-Aufruf und sein Ergebnis. +Event-Typen umfassen Agent-Lifecycle-Events, Modellanfragen und -antworten, Tool-Nutzung und -Ergebnisse, Hook-Ausführung, Human-Waits und Interrupts sowie explizite Fehler. Korrelations-IDs verbinden zusammengehörige Events, wie etwa einen Tool-Aufruf und sein Ergebnis. - Halte die Live-Ansicht zunächst breit gefächert, während du eine neue Integration überprüfst. Füge Filter erst hinzu, nachdem du das erste Event gesehen hast – ein falscher Filter kann wie eine fehlgeschlagene Ingestion aussehen. + Halte die Live-Ansicht zunächst breit gefächert, wenn du eine neue Integration überprüfst. Füge Filter erst hinzu, nachdem du das erste Event gesehen hast – ein falscher Filter kann wie eine fehlgeschlagene Datenaufnahme aussehen. -Wenn keine Events erscheinen, führe `failproofai config --status` aus und [behebe Ingestion-Probleme](/de/reference/troubleshooting). \ No newline at end of file +Falls keine Events erscheinen, führe `failproofai config --status` aus und [behebe Ingestion-Probleme](/de/reference/troubleshooting). + +Agenten, die nicht in einem der 12 unterstützten [Harnesses](/de/reference/harnesses) laufen, melden dieselben Event-Typen über das [Python SDK](/de/reference/python-sdk), einschließlich der Human-in-the-Loop-Events (`human_wait`, `human_input`, `human_interrupt`), auf die Gateway- und Produktionsagenten angewiesen sind. \ No newline at end of file diff --git a/docs/de/sessions/overview.mdx b/docs/de/sessions/overview.mdx index 14df69faa..7e6407066 100644 --- a/docs/de/sessions/overview.mdx +++ b/docs/de/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "Sessions" -description: "Beginne mit der vollständigen Aufzeichnung eines Agenten-Durchlaufs." +description: "Beginnen Sie mit der vollständigen Aufzeichnung eines Agent-Runs." icon: "workflow" --- -Eine Session ist der beste Ausgangspunkt, wenn sich ein Agent unerwartet verhält. Sie vereint Modellanfragen, Antworten, Tool-Aufrufe, Interaktionen mit Menschen, Fehler, Auswertungen und Richtlinienentscheidungen, die zu einem Durchlauf gehören. +Eine Session ist der beste Ausgangspunkt, wenn ein Agent sich unerwartet verhält. Sie vereint die Modellanfragen, Antworten, Tool-Aufrufe, menschliche Interaktionen, Fehler, Auswertungen und Policy-Entscheidungen, die zu einem einzigen Run gehören. + +Sessions sehen gleich aus, egal welches Harness sie erzeugt hat. Ein Claude Code-Run, der ein Repository umschreibt, ein Hermes-Agent, der einem Kunden in Slack antwortet, und ein Python-Dienst, der mit dem SDK instrumentiert wurde – alle landen im gleichen Trace-Format, sodass eine einzige Ansicht die gesamte Flotte abdeckt.
-Verfolge einen Agenten-Durchlauf von seinem Ziel über Modellaufrufe und Tools bis hin zur abschließenden Antwort. +Verfolgen Sie einen Agent-Run von seinem Ziel über Modellaufrufe und Tools bis hin zur abschließenden Antwort. ## Eine Session finden - 1. Gehe in der Cloud-Seitenleiste zu **Observe → Sessions**. - 2. Lege das Zeitfenster fest und filtere nach Umgebung, Status, Agent oder Session-ID. - 3. Füge Score- oder Metrikbereiche hinzu, wenn du nach Qualität, Kosten, Token oder Latenz filtern möchtest. - 4. Wähle eine Zeile aus, um den zugehörigen Trace zu öffnen. Nutze das Kopiersymbol neben der Session-ID, wenn du sie teilen möchtest. + 1. Navigieren Sie in der Cloud-Seitenleiste zu **Observe → Sessions**. + 2. Legen Sie das Zeitfenster fest und filtern Sie nach Umgebung, Status, Agent oder Session-ID. + 3. Fügen Sie Score- oder Metrikbereiche hinzu, wenn Sie einen Qualitäts-, Kosten-, Token- oder Latenz-Slice benötigen. + 4. Wählen Sie eine Zeile aus, um den zugehörigen Trace zu öffnen. Verwenden Sie das Kopier-Steuerelement neben der Session-ID, wenn Sie sie teilen möchten. - ![Die Sessions-Liste mit je einer Zeile pro Durchlauf sowie Filtern für Umgebung, Agent, Status und Auswertungsscore.](/images/dashboard/sessions-list.png) + ![Die Sessions-Liste mit einer Zeile pro Run sowie Filtern für Umgebung, Agent, Status und Bewertungsscore.](/images/dashboard/sessions-list.png) ```bash @@ -30,26 +32,26 @@ Verfolge einen Agenten-Durchlauf von seinem Ziel über Modellaufrufe und Tools b fp --json sessions --session-id ``` - Füge `--agents` hinzu, um Multi-Agenten-Durchläufe aufzuklappen, `--all` für die Paginierung oder `--fields`, um Ausgabespalten auszuwählen. + Fügen Sie `--agents` hinzu, um Multi-Agent-Runs aufzuklappen, `--all` für die Paginierung oder `--fields`, um Ausgabespalten auszuwählen. -## Was du tun kannst +## Was Sie tun können -- Einen Durchlauf nach Agent, Umgebung, Zeitraum, Modell, Ereignistyp oder Fehlerzustand finden. -- Die genaue Abfolge nachvollziehen, die zu einem Ergebnis geführt hat. -- Erfolgreiche und fehlgeschlagene Durchläufe vergleichen. -- Die Belege einsehen, die einem Audit-Befund oder einem Alert-Vorfall zugrunde liegen. -- Eine Session exportieren, wenn du eine Offline-Aufzeichnung benötigst. +- Einen Run nach Agent, Umgebung, Zeit, Modell, Ereignistyp oder Fehlerstatus finden. +- Die genaue Abfolge nachverfolgen, die zu einem Ergebnis geführt hat. +- Erfolgreiche und fehlgeschlagene Runs vergleichen. +- Die Belege öffnen, die einem Audit-Befund oder Alert-Vorfall zugrunde liegen. +- Eine Session exportieren, wenn Sie eine Offline-Aufzeichnung benötigen. -## Eine bewährte Reihenfolge für die Fehleranalyse +## Eine zuverlässige Untersuchungsreihenfolge 1. Ziel und Umgebung der Session bestätigen. 2. Den ersten Fehler oder die erste unerwartete Entscheidung finden – nicht nur den abschließenden Fehler. -3. Den Modellkontext und die Tool-Eingabe unmittelbar davor prüfen. +3. Den Modellkontext und den Tool-Input unmittelbar davor prüfen. 4. Wiederholungsversuche, Latenz und menschliche Unterbrechungen überprüfen. -5. Auswertungsscores und Richtlinienentscheidungen durchsehen. +5. Bewertungsscores und Policy-Entscheidungen durchsehen. - Erfahre, wie du vom Session-Überblick zu dem Ereignis navigierst, das das Ergebnis verursacht hat. + Erfahren Sie, wie Sie von der Session-Zusammenfassung zum Ereignis gelangen, das das Ergebnis verursacht hat. \ No newline at end of file diff --git a/docs/de/start/quickstart.mdx b/docs/de/start/quickstart.mdx index 13e3ee954..95fb0630d 100644 --- a/docs/de/start/quickstart.mdx +++ b/docs/de/start/quickstart.mdx @@ -1,33 +1,35 @@ --- -title: "Quickstart" -description: "Zeichne eine Agentensitzung auf, finde einen Fehler und verhindere ihn künftig." +title: "Schnellstart" +description: "Zeichne eine Agent-Session auf, finde einen Fehler und beginne, ihn zu verhindern." icon: "zap" --- -Dieser Quickstart sorgt dafür, dass eine Maschine Sitzungen meldet, führt ein Audit durch und stellt eine Richtlinie bereit. Nutze dazu den Skill oder folge den manuellen Schritten. Du benötigst Node.js 20.9 oder neuer. +Dieser Schnellstart bringt eine Maschine dazu, Sessions zu melden, führt ein Audit durch und stellt eine Policy bereit. Nutze die Skill-Methode oder folge den manuellen Schritten. + +**Welchen Weg nimmst du?** Wenn dein Agent in einem der 12 unterstützten [Harnesses](/de/reference/harnesses) läuft — einer Coding-CLI oder einem Gateway wie Hermes oder OpenClaw — folge den Schritten unten; du benötigst Node.js 20.9 oder höher. Wenn dein Agent kein Harness hat, instrumentiere ihn mit dem [Python SDK](/de/reference/python-sdk) für Tracing und Audits und steige dann bei [Führe deine erste Fehlerprüfung durch](/de/start/first-audit) wieder ein; Enforcement auf diesem Pfad erfordert einen Hook in deiner Laufzeitumgebung. - + ```bash npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - Dein Agent analysiert das Projekt, wählt die passende Integration aus, führt die Einrichtung durch und verifiziert sie. Einzelne Skills und erweiterte Installationsoptionen findest du im [FailproofAI Skills-Repository](https://github.com/FailproofAI/skills). + Dein Agent untersucht das Projekt, wählt die passende Integration, führt das Setup durch und verifiziert es. Im [FailproofAI Skills-Repository](https://github.com/FailproofAI/skills) findest du einzelne Skills und erweiterte Installationsoptionen. - + ## Bevor du beginnst 1. Öffne das [Failproof AI Dashboard](https://app.befailproof.ai) und erstelle ein Konto oder melde dich mit deiner Arbeits-E-Mail an. -2. Gehe zu **Administration → Keys** und erstelle einen Schlüssel mit `events:add` und `policies:pull`. +2. Gehe zu **Administration → Keys** und erstelle einen Key mit `events:add` und `policies:pull`. 3. Kopiere das einmalige Secret und speichere es auf der Zielmaschine: ```bash @@ -43,9 +45,9 @@ export FAILPROOFAI_KEY="" failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - Sitzungstranskripte werden standardmäßig übermittelt. Füge `--no-transcripts` hinzu, um Hook-Aktivitäten und Richtlinienentscheidungen ohne Transkriptinhalt zu melden. + Session-Transkripte werden standardmäßig gesendet. Füge `--no-transcripts` hinzu, um Hook-Aktivitäten und Policy-Entscheidungen ohne Transkriptinhalt zu melden. - Wenn diese Maschine bereits Agentenhistorie besitzt, kannst du die letzten sieben Tage vorab anzeigen und importieren — warte anschließend, bis die Übertragung abgeschlossen ist. Auf einer neuen Maschine kannst du diesen Schritt überspringen. + Wenn diese Maschine bereits Agent-Verlauf hat, kannst du die letzten sieben Tage vorab ansehen und importieren — warte dann, bis die Übertragung abgeschlossen ist. Überspringe diesen Schritt auf einer neuen Maschine. ```bash failproofai backfill --since 7d --dry-run @@ -53,27 +55,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - Öffne **Sessions** in Failproof AI und wähle eine importierte Sitzung aus. + Öffne **Sessions** in Failproof AI und wähle eine importierte Session aus. - - Damit wird Failproof AI an deine Agenten-CLI angebunden und die integrierten Richtlinien werden installiert. Nutze sie, um lokale Richtlinienentscheidungen einzusehen und die Durchsetzung auszuprobieren, bevor Failproof AI deine Sitzungen prüft und Richtlinien für deine Agenten erstellt. + + Damit wird Failproof AI an dein Harness angebunden und die 40 integrierten Policies werden installiert. Nutze sie, um lokale Policy-Entscheidungen zu sehen und Enforcement auszuprobieren, bevor Failproof AI deine Sessions auditiert und Policies für deine Agents schreibt. - Lass den Installer deine Agenten-CLI automatisch erkennen oder gib sie explizit an. + Lass den Installer dein Harness erkennen oder gib eines explizit an. Alle 12 sind gültige `--cli`-Werte — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # eine Coding-CLI + failproofai policies --install --cli hermes --scope user # ein Slack/Telegram-Gateway ``` + + Das Blockieren eines Tool-Calls vor der Ausführung ist auf allen 12 verifiziert. Turn-End-Gates sind auf 8 verifiziert — siehe [Enforcement-Fähigkeiten](/de/reference/harnesses#enforcement-capability) für die harness-spezifische Matrix. - - Folge der Anleitung unter [Erste Fehlerprüfung durchführen](/de/start/first-audit). Verwende ein konkretes Ziel, z. B. „Sitzungen finden, in denen der Agent ein fehlgeschlagenes Tool ohne Änderung seines Vorgehens erneut ausgeführt hat." + + Folge [Führe deine erste Fehlerprüfung durch](/de/start/first-audit). Verwende ein konkretes Ziel, z. B. „Finde Sessions, in denen der Agent ein fehlgeschlagenes Tool wiederholt hat, ohne seine Vorgehensweise zu ändern." - - Folge der Anleitung unter [Ersten Fehler mit einer Richtlinie verhindern](/de/start/first-policy). Beginne im Beobachtungsmodus, prüfe Treffer und setze dann die überprüfte Version durch. + + Folge [Verhindere deinen ersten Fehler mit einer Policy](/de/start/first-policy). Beginne im Beobachtungsmodus, prüfe die Treffer und erzwinge dann die überprüfte Version. - Führe `failproofai config --status` aus. Eine funktionierende Einrichtung meldet die Cloud-Verbindung, den Daemon-Status und ob die Durchsetzung pausiert ist. + Führe `failproofai config --status` aus. Ein gesundes Setup meldet die Cloud-Verbindung, den Daemon-Status und ob Enforcement pausiert ist. \ No newline at end of file diff --git a/docs/es/index.mdx b/docs/es/index.mdx index 717f0a900..56ee149cd 100644 --- a/docs/es/index.mdx +++ b/docs/es/index.mdx @@ -1,14 +1,16 @@ --- -title: "Haz tu agente a prueba de fallos" -description: "Failproof AI rastrea el comportamiento de los agentes, audita sesiones en busca de fallos y despliega políticas que evitan incidentes repetidos." +title: "Haz que tu agente sea infalible" +description: "Observabilidad y control de cumplimiento para cada entorno en que se ejecutan tus agentes — CLIs de codificación, gateways de chat, asistentes autoalojados y tus propios agentes instrumentados." icon: "shield-check" --- Failproof AI ayuda a los equipos a entender qué hicieron los agentes, encontrar dónde fallaron y desplegar salvaguardas antes de que el mismo comportamiento vuelva a ocurrir. +Un **entorno de ejecución** (harness) es el contexto donde tu agente corre realmente. Failproof AI se conecta a 12 de ellos — CLIs de codificación como Claude Code y Codex, gateways de chat como Hermes, asistentes autoalojados como OpenClaw — y los mismos eventos, las mismas políticas y el mismo historial de sesiones se aplican a todos. Los agentes sin harness reportan a través del [SDK de Python](/es/reference/python-sdk), que los rastrea y audita; aplicar una política en ese caso requiere un hook en tu propio entorno de ejecución. + - Usa la habilidad para instrumentar tu proyecto, conectarlo y verificar que los registros del agente lleguen correctamente. + Usa la skill para instrumentar tu proyecto, conectarlo y verificar que los registros del agente lleguen correctamente. Analiza, consulta, crea dashboards y ejecuta auditorías en lenguaje natural sobre los registros de tu agente. @@ -16,24 +18,24 @@ Failproof AI ayuda a los equipos a entender qué hicieron los agentes, encontrar - - Sigue las llamadas al modelo, herramientas, errores, entradas humanas, latencia y decisiones de política en una sola sesión. + + Sigue las llamadas al modelo, herramientas, errores, entrada humana, latencia y decisiones de política en una sola sesión. - - Audita un conjunto definido de sesiones, revisa hallazgos respaldados por evidencia y haz seguimiento de la remediación como incidencias. + + Audita un conjunto definido de sesiones, revisa hallazgos respaldados por evidencia y haz seguimiento de la corrección como issues. - - Convierte un modo de fallo conocido en una política, observa su impacto y despliégala en toda tu flota. + + Convierte un fallo conocido en una política, observa su impacto y despliégala en toda tu flota. -> **Sesión → Auditoría → Hallazgo → Incidencia → Política**
-> Rastrea lo que ocurrió, encuentra el fallo, gestiona la respuesta y luego evita el mismo comportamiento en ejecuciones futuras. +> **Sesión → Auditoría → Hallazgo → Issue → Política**
+> Rastrea lo que ocurrió, encuentra el fallo, gestiona la respuesta y previene el mismo comportamiento en ejecuciones futuras. ## Empieza aquí -Si vas a desplegar tu primer agente instrumentado, comienza con el [inicio rápido](/es/start/quickstart). Si los datos ya están llegando, abre [Sessions](/es/sessions/overview) e inspecciona una ejecución real antes de configurar auditorías o políticas. +Si estás desplegando tu primer agente instrumentado, comienza con el [inicio rápido](/es/start/quickstart). Si los datos ya están llegando, abre [Sesiones](/es/sessions/overview) e inspecciona una ejecución real antes de configurar auditorías o políticas. - - Completa el flujo de trabajo de extremo a extremo, desde la captura hasta el despliegue seguro de una política. + + Completa el flujo de trabajo de extremo a extremo desde la captura hasta una política desplegada de forma segura. \ No newline at end of file diff --git a/docs/es/reference/harnesses.mdx b/docs/es/reference/harnesses.mdx index 099290f71..c4e2adf61 100644 --- a/docs/es/reference/harnesses.mdx +++ b/docs/es/reference/harnesses.mdx @@ -1,64 +1,71 @@ --- -title: "Arneses de agentes" -description: "Captura sesiones y aplica políticas en los CLIs de agentes compatibles." +title: "Entornos de agente" +description: "Captura sesiones y aplica políticas en los 12 entornos de agente compatibles." icon: "plug-zap" --- -Failproof AI es compatible con Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI y Goose. +Un entorno es el contexto en el que tu agente se ejecuta realmente. Failproof AI es compatible con doce de ellos, en dos categorías: -| Arnés | Alcances de hooks compatibles | +- **CLIs de codificación** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **Pasarelas de chat y asistente** (2) — Hermes (Slack, Telegram, cron), OpenClaw (asistente autoalojado) + +Las mismas políticas y el mismo historial de sesiones se aplican independientemente del entorno en que se ejecute un agente. Una capa de adaptador mapea los nombres de eventos nativos, nombres de herramientas y campos de entrada de herramientas de cada entorno a 29 eventos canónicos antes de que se ejecute cualquier política. + +Un agente que no se ejecuta en **ninguno** de los doce se instrumenta directamente con el [SDK de Python](/es/reference/python-sdk). Ese es un contrato diferente, y vale la pena dejarlo claro: el SDK proporciona trazado, sesiones, evaluaciones y auditorías — **pero no aplica políticas por sí solo.** Bloquear una acción no segura antes de que se ejecute requiere un hook de aplicación en el límite de herramientas de tu entorno de ejecución; [contáctanos](mailto:support@befailproof.ai) y lo mapearemos. + +| Entorno | Ámbitos de hook compatibles | | --- | --- | | Claude Code | Usuario, proyecto, local | | Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | Usuario, proyecto | | Factory Droid, Devin CLI, Antigravity CLI, Goose | Usuario, proyecto | | Hermes, OpenClaw | Usuario | -Cada integración normaliza los nombres de eventos de hook nativos, los nombres de herramientas y los campos de entrada de herramientas antes de que se ejecuten las políticas. Una política solo puede actuar sobre los eventos que expone el arnés; prueba el comportamiento de fin de turno e instrucciones en el arnés y versión exactos que vayas a desplegar. +Cada integración normaliza sus nombres de eventos de hook nativos, nombres de herramientas y campos de entrada de herramientas antes de que se ejecuten las políticas. Una política solo puede actuar sobre los eventos que expone el entorno; prueba el comportamiento de fin de turno e instrucciones en el entorno y versión exactos que despliegues. ## Capacidad de aplicación -"Bloquear" significa que el veredicto devuelto por el adaptador actual es consumido por el arnés indicado. El bloqueo posterior a la herramienta puede reemplazar el resultado mostrado al modelo, pero no puede deshacer un efecto secundario de herramienta que ya ocurrió. +"Bloquear" significa que el veredicto devuelto por el adaptador actual es consumido por el entorno indicado. El bloqueo post-herramienta puede reemplazar el resultado mostrado al modelo, pero no puede deshacer un efecto secundario de herramienta que ya se produjo. -| Arnés | Eventos de bloqueo verificados | Advertencias de solo observación o sin bloqueo | +| Entorno | Eventos de bloqueo verificados | Observación o advertencias sin bloqueo | | --- | --- | --- | | Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` y varios eventos de tarea/configuración | `PostToolUse`, ciclo de vida de sesión, notificaciones y eventos post-fallo son observacionales. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | El bloqueo post-herramienta reemplaza el resultado tras la ejecución; los eventos de inicio de sesión y compactación son observacionales en el adaptador actual. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | El bloqueo post-herramienta reemplaza el resultado tras la ejecución; los eventos de sesión y notificación son observacionales. | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | Los eventos `PostToolUse` y de sesión son observacionales. | -| OpenCode | `PreToolUse` | Los eventos post-herramienta y de ciclo de vida son observacionales; el manejo de stop actual es una guía para un turno posterior, no una barrera verificada. | -| Pi | `PreToolUse`, `UserPromptSubmit` | Los eventos post-herramienta y de ciclo de vida son observacionales; la guía de stop se aplica a un turno posterior. | -| Hermes | `PreToolUse` | Los veredictos post-herramienta, de sesión y de subagent-stop no actúan como barreras. | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | El bloqueo post-herramienta reemplaza el resultado después de la ejecución; los eventos de inicio de sesión y compactación son observacionales en el adaptador actual. | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | El bloqueo post-herramienta reemplaza el resultado después de la ejecución; los eventos de sesión y notificación son observacionales. | +| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` y los eventos de sesión son observacionales. | +| OpenCode | `PreToolUse` | Los eventos post-herramienta y de ciclo de vida son observacionales; el manejo de detención actual es orientación para un turno posterior, no una puerta verificada. | +| Pi | `PreToolUse`, `UserPromptSubmit` | Los eventos post-herramienta y de ciclo de vida son observacionales; la orientación de detención se aplica a un turno posterior. | +| Hermes | `PreToolUse` | Los veredictos post-herramienta, de sesión y de subagent-stop no son puertas. | | OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Los eventos post-herramienta, de sesión, subagent-stop y compactación son observacionales. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Los veredictos post-herramienta y de subagent-stop son observacionales. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Los veredictos post-herramienta y subagent-stop son observacionales. | | Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` condicional | Los hooks de permiso no se ejecutan en todos los modos de permiso; los eventos post-herramienta y de sesión son observacionales. | | Antigravity CLI | `PreToolUse`, `Stop` | Los veredictos de prompt de usuario y post-herramienta son observacionales; las instrucciones de prompt aún pueden inyectarse. | -| Goose | `PreToolUse` | Los eventos de prompt de usuario, post-herramienta y de sesión son observacionales. Existe un hook de stop nativo con bloqueo en upstream, pero el adaptador actual no lo instala. | +| Goose | `PreToolUse` | Los eventos de prompt de usuario, post-herramienta y de sesión son observacionales. Existe un hook de detención de bloqueo nativo upstream, pero el adaptador actual no lo instala. | -Las capacidades son sensibles a la versión. Vuelve a realizar pruebas tras actualizar un CLI de agente, especialmente cuando una política depende del comportamiento de prompt, stop, permiso o post-herramienta en lugar de la barrera pre-herramienta habitual. +Las capacidades dependen de la versión. Vuelve a probar tras actualizar una CLI de agente, especialmente cuando una política depende del comportamiento de prompt, detención, permiso o post-herramienta en lugar de la puerta pre-herramienta habitual. ## Instalar hooks de captura y políticas - 1. Abre **Administración → Claves** y crea una clave con `events:add` y `policies:pull`, con un nombre que identifique la máquina o el entorno. - 2. En la máquina de destino, conecta el CLI local con la clave mostrada e instala los hooks del arnés. + 1. Abre **Administración → Claves** y crea una clave con `events:add` y `policies:pull`, con un nombre para la máquina o entorno. + 2. En la máquina de destino, conecta la CLI local con la clave mostrada e instala los hooks del entorno. 3. Inicia una nueva sesión de agente y confirma sus eventos de hook y sesión en **Observar → Eventos**. 4. Abre **Observar → política** para el mismo intervalo de tiempo y confirma que una decisión de política está atribuida a la máquina. - La conexión comienza con una clave de máquina. Confirma que incluye permisos de ingesta y entrega de políticas antes de copiar su secreto. + La conexión comienza con una clave de máquina. Confirma que incluye permisos tanto de ingesta como de entrega de políticas antes de copiar su secreto. - ![El cajón de nueva clave de API utilizado para conceder permisos de ingesta de eventos y entrega de políticas.](/images/dashboard/key-create.png) + ![El panel de creación de clave API usado para conceder permisos de ingesta de eventos y entrega de políticas.](/images/dashboard/key-create.png) Tras instalar los hooks, el flujo de Eventos debería mostrar nuevos eventos de la máquina y el entorno que conectaste. - ![El flujo de Eventos en vivo utilizado para confirmar que un arnés recién instalado está reportando.](/images/dashboard/events-stream.png) + ![El flujo de Eventos en vivo usado para confirmar que un entorno recién instalado está reportando.](/images/dashboard/events-stream.png) - Por último, verifica que las decisiones de política estén atribuidas a la misma máquina. Esto confirma que el arnés está reportando actividad de políticas además de eventos de trazas. + Por último, verifica que las decisiones de política están atribuidas a la misma máquina. Esto confirma que el entorno está reportando actividad de políticas además de eventos de trazado. - ![La página de Política utilizada para verificar decisiones de política de un arnés recién conectado.](/images/dashboard/policy-observe.png) + ![La página de Política usada para verificar decisiones de política de un entorno recién conectado.](/images/dashboard/policy-observe.png) - Instala hooks para todos los arneses detectados: + Instala hooks para todos los entornos detectados: ```bash failproofai config \ @@ -67,7 +74,7 @@ Las capacidades son sensibles a la versión. Vuelve a realizar pruebas tras actu failproofai policies --install ``` - O apunta a arneses específicos y un alcance de configuración: + O apunta a entornos específicos y un ámbito de configuración: ```bash failproofai policies --install \ @@ -75,7 +82,7 @@ Las capacidades son sensibles a la versión. Vuelve a realizar pruebas tras actu --scope user ``` - El alcance de proyecto mantiene la configuración de hooks junto al repositorio. El alcance de usuario cubre el trabajo en múltiples repositorios. Claude Code también admite alcance local; la compatibilidad varía según el arnés y el CLI rechaza combinaciones no soportadas. + El ámbito de proyecto mantiene la configuración de hooks con un repositorio. El ámbito de usuario cubre el trabajo a través de repositorios. Claude Code también admite ámbito local; el soporte varía según el entorno y la CLI rechaza las combinaciones no compatibles. Verifica la máquina y sus eventos: @@ -87,16 +94,16 @@ Las capacidades son sensibles a la versión. Vuelve a realizar pruebas tras actu -## Agregar una ruta de sesión no predeterminada +## Añadir una ruta de sesión no predeterminada - Las rutas adicionales se registran en la máquina, no en Cloud. Tras agregar una, abre **Observar → Sesiones**, filtra por el entorno de la máquina y confirma que aparecen sesiones de la nueva ruta. Abre una sesión y revisa el agente, el arnés y las marcas de tiempo de los eventos antes de utilizarla en una auditoría. + Las rutas adicionales se registran en la máquina, no en la nube. Después de añadir una, abre **Observar → Sesiones**, filtra al entorno de la máquina y confirma que aparecen sesiones de la nueva ruta. Abre una sesión y comprueba el agente, el entorno y las marcas de tiempo de los eventos antes de usarla en una auditoría. ![La lista de Sesiones filtrada al entorno que recibe datos de la ruta de captura adicional.](/images/dashboard/sessions-list.png) - Agrega una ruta con una etiqueta opcional y luego inspecciona las rutas configuradas: + Añade una ruta con una etiqueta opcional y luego inspecciona las rutas configuradas: ```bash failproofai harness add-path claude checkout=/srv/checkout/.claude diff --git a/docs/es/sessions/live-events.mdx b/docs/es/sessions/live-events.mdx index b73685f2d..0aa867f01 100644 --- a/docs/es/sessions/live-events.mdx +++ b/docs/es/sessions/live-events.mdx @@ -4,18 +4,18 @@ description: "Observa la actividad del agente en tiempo real mientras se ejecuta icon: "radio" --- -Los eventos en vivo te permiten confirmar la instrumentación y supervisar una ejecución arriesgada sin esperar a que la sesión finalice. +Los eventos en vivo te permiten confirmar la instrumentación y supervisar una ejecución de riesgo sin tener que esperar a que la sesión termine. -## Ver la actividad +## Ver actividad 1. Ve a **Observe → Events**. 2. Comienza con la ventana de tiempo actual y sin filtros para confirmar que los datos están llegando. - 3. Filtra por entorno, tipo de evento, agente o sesión. Usa la búsqueda para encontrar texto en el payload. - 4. Selecciona un evento para inspeccionar su resumen y detalles. Sigue el enlace de sesión para ver la traza completa. + 3. Filtra por entorno, tipo de evento, agente o sesión. Usa la búsqueda para texto en el payload. + 4. Selecciona un evento para inspeccionar su resumen y detalles. Sigue el enlace de sesión para ver el trazado completo. - ![El flujo de eventos en vivo con filtros de tiempo, entorno, tipo de evento, agente, modelo, contexto, sesión y texto.](/images/dashboard/events-stream-current.png) + ![El flujo en vivo de Events mostrando tráfico de una gateway de chat Hermes junto con ejecuciones de la CLI de codificación, filtrado por tiempo, entorno, tipo de evento, agente, modelo, contexto y sesión.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ Los eventos en vivo te permiten confirmar la instrumentación y supervisar una e fp --json events --full --session-id --all ``` - El feed predeterminado omite los payloads en bruto. Usa `--full` solo para investigar una sesión con límites definidos. + El feed predeterminado omite los payloads sin procesar. Usa `--full` solo para investigar una sesión acotada. -Usa el flujo de eventos para responder tres preguntas inmediatas: +Utiliza el flujo de eventos para responder tres preguntas inmediatas: - ¿El agente esperado está reportando al entorno correcto? -- ¿Las llamadas al modelo, las llamadas a herramientas y las decisiones de política están llegando en orden? +- ¿Están llegando en orden las llamadas al modelo, las llamadas a herramientas y las decisiones de políticas? - ¿La sesión ha dejado de avanzar o ha empezado a repetir una acción? -Los tipos de eventos incluyen eventos del ciclo de vida del agente, solicitudes y respuestas del modelo, uso de herramientas y resultados, ejecución de hooks, esperas e interrupciones humanas, y errores explícitos. Los IDs de correlación vinculan eventos relacionados, como una llamada a una herramienta y su resultado. +Los tipos de eventos incluyen eventos del ciclo de vida del agente, solicitudes y respuestas del modelo, uso de herramientas y resultados, ejecución de hooks, esperas e interrupciones humanas, y errores explícitos. Los IDs de correlación enlazan eventos pareados, como una llamada a herramienta y su resultado. - Mantén la vista en vivo sin filtros mientras verificas una nueva integración. Añade filtros solo después de ver el primer evento; un filtro incorrecto puede parecer un fallo de ingesta. + Mantén la vista en vivo sin filtros mientras verificas una nueva integración. Agrega filtros solo después de ver el primer evento; un filtro incorrecto puede parecer un fallo de ingesta. -Si no aparece ningún evento, ejecuta `failproofai config --status` y luego [soluciona problemas de ingesta](/es/reference/troubleshooting). \ No newline at end of file +Si no aparecen eventos, ejecuta `failproofai config --status` y luego [soluciona problemas de ingesta](/es/reference/troubleshooting). + +Los agentes que no se ejecutan en uno de los 12 [harnesses](/es/reference/harnesses) compatibles reportan los mismos tipos de eventos a través del [Python SDK](/es/reference/python-sdk), incluidos los eventos de human-in-the-loop (`human_wait`, `human_input`, `human_interrupt`) de los que dependen los agentes de gateway y producción. \ No newline at end of file diff --git a/docs/es/sessions/overview.mdx b/docs/es/sessions/overview.mdx index a48ad205a..df9a8342c 100644 --- a/docs/es/sessions/overview.mdx +++ b/docs/es/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "Sesiones" -description: "Comienza con el registro completo de una ejecución del agente." +description: "Comienza con el registro completo de una ejecución de agente." icon: "workflow" --- -Una sesión es el mejor punto de partida cuando un agente se comporta de forma inesperada. Reúne las solicitudes al modelo, las respuestas, las llamadas a herramientas, las interacciones humanas, los errores, las evaluaciones y las decisiones de política que pertenecen a una sola ejecución. +Una sesión es el mejor punto de partida cuando un agente se comporta de forma inesperada. Reúne las solicitudes al modelo, las respuestas, las llamadas a herramientas, las interacciones humanas, los errores, las evaluaciones y las decisiones de políticas que pertenecen a una ejecución. + +Las sesiones tienen el mismo aspecto independientemente del entorno que las generó. Una ejecución de Claude Code que reescribe un repositorio, un agente Hermes que responde a un cliente en Slack y un servicio Python instrumentado con el SDK llegan al mismo formato de traza, de modo que una sola vista cubre toda la flota.
-Sigue una ejecución del agente desde su objetivo, pasando por las llamadas al modelo y las herramientas, hasta la respuesta final. +Sigue una ejecución de agente desde su objetivo, pasando por las llamadas al modelo y las herramientas, hasta la respuesta final. ## Encontrar una sesión - 1. En la barra lateral de Cloud, ve a **Observe → Sessions**. - 2. Establece la ventana de tiempo y filtra por entorno, estado, agente o ID de sesión. - 3. Añade rangos de puntuación o métricas cuando necesites un subconjunto por calidad, costo, tokens o latencia. - 4. Selecciona una fila para abrir su traza. Usa el control de copia junto al ID de sesión cuando lo compartas. + 1. En la barra lateral de Cloud, ve a **Observar → Sesiones**. + 2. Establece el intervalo de tiempo y filtra por entorno, estado, agente o ID de sesión. + 3. Añade rangos de puntuación o métrica cuando necesites un corte por calidad, coste, tokens o latencia. + 4. Selecciona una fila para abrir su traza. Usa el control de copia junto al ID de sesión cuando la compartas. - ![La lista de sesiones con una fila por ejecución y filtros de entorno, agente, estado y puntuación de evaluación.](/images/dashboard/sessions-list.png) + ![La lista de sesiones mostrando una fila por ejecución con filtros de entorno, agente, estado y puntuación de evaluación.](/images/dashboard/sessions-list.png) ```bash @@ -30,7 +32,7 @@ Sigue una ejecución del agente desde su objetivo, pasando por las llamadas al m fp --json sessions --session-id ``` - Añade `--agents` para expandir ejecuciones multi-agente, `--all` para paginar, o `--fields` para elegir las columnas de salida. + Añade `--agents` para expandir ejecuciones multiagente, `--all` para paginar, o `--fields` para elegir las columnas de salida. @@ -40,16 +42,16 @@ Sigue una ejecución del agente desde su objetivo, pasando por las llamadas al m - Seguir la secuencia exacta que produjo un resultado. - Comparar ejecuciones exitosas y fallidas. - Abrir la evidencia utilizada por un hallazgo de auditoría o un incidente de alerta. -- Exportar una sesión cuando necesitas un registro sin conexión. +- Exportar una sesión cuando necesites un registro sin conexión. -## Un orden de investigación confiable +## Un orden de investigación fiable -1. Confirma el objetivo de la sesión y el entorno. +1. Confirma el objetivo y el entorno de la sesión. 2. Encuentra el primer error o decisión inesperada, no solo el fallo final. 3. Inspecciona el contexto del modelo y la entrada de la herramienta inmediatamente antes. -4. Revisa los reintentos, la latencia y las interrupciones humanas. -5. Revisa las puntuaciones de evaluación y las decisiones de política. +4. Comprueba los reintentos, la latencia y las interrupciones humanas. +5. Revisa las puntuaciones de evaluación y las decisiones de políticas. - Aprende a navegar desde el resumen de la sesión hasta el evento que causó el resultado. + Aprende a pasar del resumen de la sesión al evento que causó el resultado. \ No newline at end of file diff --git a/docs/es/start/quickstart.mdx b/docs/es/start/quickstart.mdx index 7cff2fc5e..0ac64c239 100644 --- a/docs/es/start/quickstart.mdx +++ b/docs/es/start/quickstart.mdx @@ -4,30 +4,32 @@ description: "Captura una sesión de agente, encuentra un fallo y empieza a prev icon: "zap" --- -Este inicio rápido conecta una máquina para que reporte sesiones, ejecuta una auditoría y despliega una política. Usa la skill para configurar Failproof, o sigue los pasos manuales. Necesitas Node.js 20.9 o posterior. +Este inicio rápido te permite tener una máquina reportando sesiones, ejecutar una auditoría e implementar una política. Usa el skill para configurar Failproof, o sigue los pasos manuales. + +**¿Cuál es tu camino?** Si tu agente se ejecuta en uno de los 12 [harnesses](/es/reference/harnesses) compatibles — una CLI de codificación, o un gateway como Hermes o OpenClaw — sigue los pasos a continuación; necesitas Node.js 20.9 o posterior. Si tu agente no tiene harness, instrumétalo con el [SDK de Python](/es/reference/python-sdk) para trazabilidad y auditorías, y luego continúa en [Ejecuta tu primera verificación de fallos](/es/start/first-audit); la aplicación de políticas en ese camino requiere un hook en tu runtime. - + - + ```bash npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - Tu agente inspecciona el proyecto, elige la integración adecuada, realiza la configuración y la verifica. Consulta el [repositorio de skills de FailproofAI](https://github.com/FailproofAI/skills) para ver skills individuales y opciones de instalación avanzadas. + Tu agente inspecciona el proyecto, elige la integración relevante, realiza la configuración y la verifica. Consulta el [repositorio de skills de FailproofAI](https://github.com/FailproofAI/skills) para ver skills individuales y opciones de instalación avanzadas. - ## Antes de comenzar + ## Antes de empezar -1. Abre el [panel de control de Failproof AI](https://app.befailproof.ai) y crea una cuenta o inicia sesión con tu correo de trabajo. -2. Ve a **Administration → Keys** y crea una clave con `events:add` y `policies:pull`. +1. Abre el [dashboard de Failproof AI](https://app.befailproof.ai) y crea una cuenta o inicia sesión con tu correo de trabajo. +2. Ve a **Administración → Claves** y crea una clave con `events:add` y `policies:pull`. 3. Copia el secreto de un solo uso y guárdalo en la máquina de destino: ```bash @@ -43,9 +45,9 @@ export FAILPROOFAI_KEY="" failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - Las transcripciones de sesiones se envían por defecto. Agrega `--no-transcripts` para reportar la actividad de hooks y las decisiones de políticas sin incluir el contenido de las transcripciones. + Las transcripciones de sesión se envían de forma predeterminada. Agrega `--no-transcripts` para reportar la actividad de hooks y las decisiones de políticas sin el contenido de la transcripción. - Si esta máquina ya tiene historial del agente, previsualiza e importa los últimos siete días, luego espera a que la entrega finalice. Omite este paso en una máquina nueva. + Si esta máquina ya tiene historial de agente, previsualiza e importa los últimos siete días, luego espera a que la entrega finalice. Omite este paso en una máquina nueva. ```bash failproofai backfill --since 7d --dry-run @@ -53,27 +55,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - Abre **Sessions** en Failproof AI y selecciona una sesión importada. + Abre **Sesiones** en Failproof AI y selecciona una sesión importada. - Esto conecta Failproof AI a la CLI de tu agente e instala las políticas integradas. Úsalas para ver las decisiones de políticas locales y probar la aplicación antes de que Failproof AI audite tus sesiones y escriba políticas para tus agentes. + Esto conecta Failproof AI a tu harness e instala las 40 políticas integradas. Úsalas para ver las decisiones de políticas locales y probar la aplicación antes de que Failproof AI audite tus sesiones y escriba políticas para tus agentes. - Deja que el instalador detecte la CLI de tu agente, o especifica una explícitamente. + Deja que el instalador detecte tu harness, o especifica uno explícitamente. Cada uno de los 12 es un valor válido para `--cli` — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # una CLI de codificación + failproofai policies --install --cli hermes --scope user # un gateway de Slack/Telegram ``` + + El bloqueo de una llamada a herramienta antes de que se ejecute está verificado en los 12. Las verificaciones al final del turno están verificadas en 8 — consulta la [capacidad de aplicación](/es/reference/harnesses#enforcement-capability) para ver la matriz por harness. Sigue [Ejecuta tu primera verificación de fallos](/es/start/first-audit). Usa un objetivo concreto como "encontrar sesiones donde el agente reintentó una herramienta fallida sin cambiar su enfoque". - Sigue [Previene tu primer fallo con una política](/es/start/first-policy). Comienza en modo observación, inspecciona las coincidencias y luego aplica la versión revisada. + Sigue [Previene tu primer fallo con una política](/es/start/first-policy). Empieza en modo observación, inspecciona las coincidencias y luego aplica la versión revisada. - Ejecuta `failproofai config --status`. Una configuración saludable muestra la conexión a la nube, el estado del daemon y si la aplicación de políticas está pausada. + Ejecuta `failproofai config --status`. Una configuración saludable reporta la conexión en la nube, el estado del daemon y si la aplicación de políticas está pausada. \ No newline at end of file diff --git a/docs/fr/index.mdx b/docs/fr/index.mdx index 02251ad84..bce49fc1a 100644 --- a/docs/fr/index.mdx +++ b/docs/fr/index.mdx @@ -1,39 +1,41 @@ --- title: "Rendez votre agent infaillible" -description: "Failproof AI trace le comportement des agents, audite les sessions en cas d'échec et déploie des politiques pour éviter la répétition des incidents." +description: "Observabilité et mise en application pour chaque environnement d'exécution de vos agents — CLI de codage, passerelles de chat, assistants auto-hébergés et vos propres agents instrumentés." icon: "shield-check" --- -Failproof AI aide les équipes à comprendre ce que les agents ont fait, à identifier leurs défaillances et à déployer des protections avant que le même comportement ne se reproduise. +Failproof AI aide les équipes à comprendre ce que les agents ont fait, à identifier là où ils ont échoué, et à déployer des garde-fous avant que le même comportement ne se reproduise. + +Un **harness** est l'environnement dans lequel votre agent s'exécute réellement. Failproof AI s'intègre à 12 d'entre eux — des CLI de codage comme Claude Code et Codex, des passerelles de chat comme Hermes, des assistants auto-hébergés comme OpenClaw — et les mêmes événements, les mêmes politiques et le même historique de session s'appliquent à chacun. Les agents sans harness remontent leurs données via le [SDK Python](/fr/reference/python-sdk), qui les trace et les audite ; l'application d'une politique dans ce cas nécessite un hook dans votre propre environnement d'exécution. - Utilisez le skill pour instrumenter votre projet, le connecter et vérifier que les logs des agents arrivent correctement. + Utilisez la compétence pour instrumenter votre projet, le connecter et vérifier que les logs d'agents arrivent bien. - Analysez, interrogez, construisez des tableaux de bord et lancez des audits en langage naturel sur vos logs d'agents. + Analysez, interrogez, créez des tableaux de bord et lancez des audits en langage naturel sur vos logs d'agents. - Suivez les appels de modèles, les outils, les erreurs, les entrées humaines, la latence et les décisions de politique dans une seule session. + Suivez les appels de modèle, les outils, les erreurs, les saisies humaines, la latence et les décisions de politique au sein d'une même session. - - Auditez un ensemble défini de sessions, examinez les résultats étayés par des preuves et suivez la remédiation sous forme de tickets. + + Auditez un ensemble défini de sessions, examinez les conclusions étayées par des preuves et suivez la remédiation sous forme de tickets. - Transformez un mode de défaillance connu en politique, observez son impact et déployez-la sur l'ensemble de votre parc. + Transformez un mode d'échec connu en politique, observez son impact et déployez-la sur l'ensemble de votre flotte. -> **Session → Audit → Résultat → Ticket → Politique**
-> Tracez ce qui s'est passé, identifiez la défaillance, gérez la réponse, puis empêchez le même comportement lors des exécutions futures. +> **Session → Audit → Constat → Ticket → Politique**
+> Tracez ce qui s'est passé, identifiez l'échec, gérez la réponse, puis évitez que le même comportement ne se reproduise lors des prochaines exécutions. ## Par où commencer -Si vous déployez votre premier agent instrumenté, commencez par le [guide de démarrage rapide](/fr/start/quickstart). Si des données arrivent déjà, ouvrez [Sessions](/fr/sessions/overview) et inspectez une exécution réelle avant de configurer les audits ou les politiques. +Si vous déployez votre premier agent instrumenté, commencez par le [démarrage rapide](/fr/start/quickstart). Si des données arrivent déjà, ouvrez [Sessions](/fr/sessions/overview) et inspectez une exécution réelle avant de configurer des audits ou des politiques. - - Suivez le flux de travail complet, de la capture à un déploiement sécurisé d'une politique. + + Parcourez le flux de travail de bout en bout, de la capture à une politique déployée en toute sécurité. \ No newline at end of file diff --git a/docs/fr/reference/harnesses.mdx b/docs/fr/reference/harnesses.mdx index 4bafe6f39..22adb3e94 100644 --- a/docs/fr/reference/harnesses.mdx +++ b/docs/fr/reference/harnesses.mdx @@ -1,61 +1,68 @@ --- title: "Harnais d'agents" -description: "Capturez les sessions et appliquez des politiques dans les CLI d'agents pris en charge." +description: "Capturez les sessions et appliquez des politiques sur l'ensemble des 12 harnais d'agents pris en charge." icon: "plug-zap" --- -Failproof AI prend en charge Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI et Goose. +Un harnais est l'environnement dans lequel votre agent s'exécute concrètement. Failproof AI en prend en charge douze, répartis en deux catégories : -| Harnais | Portées de hooks prises en charge | +- **CLI de développement** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **Passerelles de chat et d'assistant** (2) — Hermes (Slack, Telegram, cron), OpenClaw (assistant auto-hébergé) + +Les mêmes politiques et le même historique de session s'appliquent quel que soit le harnais utilisé. Une couche d'adaptation mappe les noms d'événements natifs, les noms d'outils et les champs d'entrée propres à chaque harnais vers 29 événements canoniques, avant toute exécution de politique. + +Un agent qui ne tourne dans **aucun** des douze harnais est instrumenté directement via le [SDK Python](/fr/reference/python-sdk). Ce contrat est différent, et mérite d'être énoncé clairement : le SDK fournit le traçage, les sessions, les évaluations et les audits — **il n'applique pas les politiques de lui-même.** Bloquer une action non sécurisée avant qu'elle ne s'exécute nécessite un hook d'application à la frontière des outils de votre runtime ; [contactez-nous](mailto:support@befailproof.ai) et nous l'adapterons. + +| Harnais | Scopes de hook pris en charge | | --- | --- | -| Claude Code | Utilisateur, projet, local | -| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | Utilisateur, projet | -| Factory Droid, Devin CLI, Antigravity CLI, Goose | Utilisateur, projet | -| Hermes, OpenClaw | Utilisateur | +| Claude Code | User, project, local | +| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | +| Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | +| Hermes, OpenClaw | User | -Chaque intégration normalise ses noms d'événements de hook natifs, ses noms d'outils et ses champs d'entrée d'outils avant l'exécution des politiques. Une politique ne peut agir que sur les événements exposés par le harnais ; testez le comportement en fin de tour et les instructions sur le harnais et la version exacts que vous déployez. +Chaque intégration normalise ses noms d'événements de hook natifs, ses noms d'outils et ses champs d'entrée avant l'exécution des politiques. Une politique ne peut agir que sur les événements exposés par le harnais ; testez le comportement en fin de tour et les instructions sur le harnais et la version exacts que vous déployez. -## Capacité d'application +## Capacités d'application -« Bloquer » signifie que le verdict retourné par l'adaptateur actuel est consommé par le harnais désigné. Le blocage post-outil peut remplacer le résultat présenté au modèle, mais ne peut pas annuler un effet secondaire d'outil déjà produit. +« Bloquer » signifie que le verdict retourné par l'adaptateur actuel est consommé par le harnais concerné. Un blocage post-outil peut remplacer le résultat présenté au modèle, mais ne peut pas annuler un effet de bord d'outil qui s'est déjà produit. -| Harnais | Événements de blocage vérifiés | Mises en garde d'observation seule ou non bloquants | +| Harnais | Événements de blocage vérifiés | Mises en garde observation seule ou non-bloquant | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, et plusieurs événements de tâche/configuration | `PostToolUse`, le cycle de vie de session, les notifications et les événements post-échec sont observationnels. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Le blocage post-outil remplace le résultat après exécution ; les événements de démarrage de session et de compaction sont observationnels dans l'adaptateur actuel. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Le blocage post-outil remplace le résultat après exécution ; les événements de session et de notification sont observationnels. | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` et les événements de session sont observationnels. | -| OpenCode | `PreToolUse` | Les événements post-outil et de cycle de vie sont observationnels ; la gestion actuelle des arrêts constitue une directive pour un tour ultérieur plutôt qu'une barrière vérifiée. | -| Pi | `PreToolUse`, `UserPromptSubmit` | Les événements post-outil et de cycle de vie sont observationnels ; la directive d'arrêt s'applique à un tour ultérieur. | -| Hermes | `PreToolUse` | Les verdicts post-outil, de session et d'arrêt de sous-agent ne sont pas des barrières. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Les événements post-outil, de session, d'arrêt de sous-agent et de compaction sont observationnels. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Les verdicts post-outil et d'arrêt de sous-agent sont observationnels. | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` conditionnel | Les hooks de permission ne s'exécutent pas dans tous les modes de permission ; les événements post-outil et de session sont observationnels. | -| Antigravity CLI | `PreToolUse`, `Stop` | Les verdicts de prompt utilisateur et post-outil sont observationnels ; des instructions de prompt peuvent néanmoins être injectées. | -| Goose | `PreToolUse` | Les événements de prompt utilisateur, post-outil et de session sont observationnels. Un hook d'arrêt bloquant natif existe en amont, mais n'est pas installé par l'adaptateur actuel. | - -Les capacités sont sensibles à la version. Retestez après la mise à niveau d'un CLI d'agent, en particulier lorsqu'une politique repose sur le comportement des prompts, des arrêts, des permissions ou des outils post-exécution plutôt que sur la barrière commune pre-tool. +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, et plusieurs événements de tâche/configuration | `PostToolUse`, le cycle de vie de session, les notifications et les événements post-échec sont en mode observation. | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Le blocage post-outil remplace le résultat après exécution ; les événements de démarrage de session et de compaction sont en mode observation dans l'adaptateur actuel. | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Le blocage post-outil remplace le résultat après exécution ; les événements de session et de notification sont en mode observation. | +| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` et les événements de session sont en mode observation. | +| OpenCode | `PreToolUse` | Les événements post-outil et de cycle de vie sont en mode observation ; la gestion de l'arrêt actuelle constitue une recommandation pour un tour ultérieur plutôt qu'une véritable barrière. | +| Pi | `PreToolUse`, `UserPromptSubmit` | Les événements post-outil et de cycle de vie sont en mode observation ; les recommandations d'arrêt s'appliquent à un tour ultérieur. | +| Hermes | `PreToolUse` | Les verdicts post-outil, de session et d'arrêt de sous-agent ne constituent pas des barrières. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Les événements post-outil, de session, d'arrêt de sous-agent et de compaction sont en mode observation. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Les verdicts post-outil et d'arrêt de sous-agent sont en mode observation. | +| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` conditionnel | Les hooks de permission ne s'exécutent pas dans tous les modes de permission ; les événements post-outil et de session sont en mode observation. | +| Antigravity CLI | `PreToolUse`, `Stop` | Les verdicts de prompt utilisateur et post-outil sont en mode observation ; les instructions de prompt peuvent tout de même être injectées. | +| Goose | `PreToolUse` | Les événements de prompt utilisateur, post-outil et de session sont en mode observation. Un hook d'arrêt bloquant natif existe en amont mais n'est pas installé par l'adaptateur actuel. | + +Les capacités dépendent de la version. Retestez après la mise à niveau d'un CLI d'agent, en particulier lorsqu'une politique repose sur le comportement du prompt, de l'arrêt, des permissions ou post-outil plutôt que sur la barrière pré-outil commune. ## Installer les hooks de capture et de politique - 1. Ouvrez **Administration → Clés** et créez une clé avec les permissions `events:add` et `policies:pull`, nommée selon la machine ou l'environnement. + 1. Ouvrez **Administration → Clés** et créez une clé avec les permissions `events:add` et `policies:pull`, nommée en fonction de la machine ou de l'environnement. 2. Sur la machine cible, connectez le CLI local avec la clé affichée et installez les hooks du harnais. 3. Démarrez une nouvelle session d'agent, puis confirmez ses événements de hook et de session sous **Observer → Événements**. 4. Ouvrez **Observer → Politique** pour la même fenêtre temporelle et confirmez qu'une décision de politique est attribuée à la machine. - La connexion commence avec une clé machine. Assurez-vous qu'elle inclut les permissions d'ingestion et de livraison de politique avant de copier son secret. + La connexion démarre avec une clé machine. Vérifiez qu'elle inclut bien les permissions d'ingestion et de livraison de politiques avant de copier son secret. - ![Le panneau de création de clé API permettant d'accorder les permissions d'ingestion d'événements et de livraison de politique.](/images/dashboard/key-create.png) + ![Le panneau de création de clé API utilisé pour accorder les permissions d'ingestion d'événements et de livraison de politiques.](/images/dashboard/key-create.png) - Après l'installation des hooks, le flux d'événements devrait afficher de nouveaux événements provenant de la machine et de l'environnement connectés. + Après l'installation des hooks, le flux d'événements doit afficher de nouveaux événements provenant de la machine et de l'environnement connectés. - ![Le flux d'événements en direct permettant de confirmer qu'un harnais nouvellement installé envoie bien des rapports.](/images/dashboard/events-stream.png) + ![Le flux d'événements en direct utilisé pour confirmer qu'un harnais nouvellement installé remonte bien des données.](/images/dashboard/events-stream.png) - Enfin, vérifiez que les décisions de politique sont attribuées à la même machine. Cela confirme que le harnais rapporte bien l'activité des politiques ainsi que les événements de trace. + Enfin, vérifiez que les décisions de politique sont attribuées à la même machine. Cela confirme que le harnais remonte bien l'activité des politiques ainsi que les événements de trace. - ![La page Politique permettant de vérifier les décisions de politique d'un harnais nouvellement connecté.](/images/dashboard/policy-observe.png) + ![La page Politique utilisée pour vérifier les décisions de politique d'un harnais nouvellement connecté.](/images/dashboard/policy-observe.png) Installez les hooks pour tous les harnais détectés : @@ -67,7 +74,7 @@ Les capacités sont sensibles à la version. Retestez après la mise à niveau d failproofai policies --install ``` - Ou ciblez des harnais nommés et une portée de configuration : + Ou ciblez des harnais précis et un scope de configuration : ```bash failproofai policies --install \ @@ -75,7 +82,7 @@ Les capacités sont sensibles à la version. Retestez après la mise à niveau d --scope user ``` - La portée projet conserve la configuration des hooks avec un dépôt. La portée utilisateur couvre le travail sur plusieurs dépôts. Claude Code prend également en charge la portée locale ; la prise en charge varie selon le harnais et le CLI rejette les combinaisons non prises en charge. + Le scope project conserve la configuration des hooks avec un dépôt. Le scope user couvre le travail sur plusieurs dépôts. Claude Code prend également en charge le scope local ; la prise en charge varie selon le harnais et le CLI rejette les combinaisons non supportées. Vérifiez la machine et ses événements : @@ -87,11 +94,11 @@ Les capacités sont sensibles à la version. Retestez après la mise à niveau d -## Ajouter un chemin de session non par défaut +## Ajouter un chemin de session non-défaut - Les chemins supplémentaires sont enregistrés sur la machine, pas dans le Cloud. Après en avoir ajouté un, ouvrez **Observer → Sessions**, filtrez sur l'environnement de la machine, et confirmez que les sessions provenant du nouveau chemin apparaissent. Ouvrez une session et vérifiez l'agent, le harnais et les horodatages des événements avant de vous y fier dans un audit. + Les chemins supplémentaires sont enregistrés sur la machine, et non dans le Cloud. Après en avoir ajouté un, ouvrez **Observer → Sessions**, filtrez sur l'environnement de la machine et vérifiez que les sessions provenant du nouveau chemin apparaissent. Ouvrez une session et vérifiez l'agent, le harnais et les horodatages des événements avant de l'utiliser dans un audit. ![La liste des sessions filtrée sur l'environnement recevant les données du chemin de capture supplémentaire.](/images/dashboard/sessions-list.png) @@ -110,5 +117,5 @@ Les capacités sont sensibles à la version. Retestez après la mise à niveau d - Lancez une nouvelle session après l'installation. Vérifiez à la fois le flux d'événements en direct et une décision de politique effective avant d'élargir le déploiement. + Lancez une nouvelle session après l'installation. Vérifiez à la fois le flux d'événements en direct et une décision de politique effective avant d'étendre le déploiement. \ No newline at end of file diff --git a/docs/fr/sessions/live-events.mdx b/docs/fr/sessions/live-events.mdx index aeece477d..9a3abefef 100644 --- a/docs/fr/sessions/live-events.mdx +++ b/docs/fr/sessions/live-events.mdx @@ -4,18 +4,18 @@ description: "Observez l'activité de l'agent en temps réel pendant qu'une sess icon: "radio" --- -Les événements en direct vous permettent de confirmer l'instrumentation et de surveiller une exécution risquée sans attendre la fin de la session. +Les événements en direct vous permettent de valider l'instrumentation et de surveiller une exécution à risque sans attendre la fin de la session. ## Surveiller l'activité 1. Accédez à **Observe → Events**. - 2. Commencez avec la fenêtre temporelle actuelle et sans filtres pour confirmer que les données arrivent. - 3. Filtrez par environnement, type d'événement, agent ou session. Utilisez la recherche pour filtrer par contenu de payload. - 4. Sélectionnez un événement pour inspecter son résumé et ses détails. Suivez le lien de sa session pour accéder à la trace complète. + 2. Commencez avec la fenêtre temporelle actuelle sans filtres pour confirmer que les données arrivent. + 3. Filtrez par environnement, type d'événement, agent ou session. Utilisez la recherche pour le texte des charges utiles. + 4. Sélectionnez un événement pour inspecter son résumé et ses détails. Suivez le lien de la session pour obtenir la trace complète. - ![Le flux d'événements en direct avec des filtres sur l'heure, l'environnement, le type d'événement, l'agent, le modèle, le contexte, la session et le texte.](/images/dashboard/events-stream-current.png) + ![Le flux d'événements en direct affichant le trafic d'une passerelle de chat Hermes aux côtés d'exécutions de l'interface CLI de programmation, filtré par heure, environnement, type d'événement, agent, modèle, contexte et session.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ Les événements en direct vous permettent de confirmer l'instrumentation et de fp --json events --full --session-id --all ``` - Le flux par défaut omet les payloads bruts. N'utilisez `--full` que pour une investigation ciblée sur une session délimitée. + Le flux par défaut omet les charges utiles brutes. N'utilisez `--full` que pour l'investigation d'une session délimitée. Utilisez le flux d'événements pour répondre à trois questions immédiates : -- L'agent attendu rapporte-t-il bien à l'environnement correct ? +- L'agent attendu rapporte-t-il au bon environnement ? - Les appels de modèle, les appels d'outils et les décisions de politique arrivent-ils dans l'ordre ? - La session a-t-elle cessé de progresser ou a-t-elle commencé à répéter une action ? -Les types d'événements comprennent les événements du cycle de vie de l'agent, les requêtes et réponses du modèle, l'utilisation des outils et leurs résultats, l'exécution des hooks, les attentes humaines et les interruptions, ainsi que les erreurs explicites. Les identifiants de corrélation relient les événements associés, comme un appel d'outil et son résultat. +Les types d'événements comprennent les événements du cycle de vie de l'agent, les requêtes et réponses du modèle, l'utilisation des outils et leurs résultats, l'exécution des hooks, les attentes et interruptions humaines, ainsi que les erreurs explicites. Les identifiants de corrélation relient les événements appariés, comme un appel d'outil et son résultat. Gardez la vue en direct large lors de la vérification d'une nouvelle intégration. N'ajoutez des filtres qu'après avoir vu le premier événement ; un filtre incorrect peut ressembler à un échec d'ingestion. -Si aucun événement n'apparaît, exécutez `failproofai config --status`, puis [dépannez l'ingestion](/fr/reference/troubleshooting). \ No newline at end of file +Si aucun événement n'apparaît, exécutez `failproofai config --status`, puis [résolvez les problèmes d'ingestion](/fr/reference/troubleshooting). + +Les agents qui ne s'exécutent pas dans l'un des 12 [harnais](/fr/reference/harnesses) pris en charge rapportent les mêmes types d'événements via le [SDK Python](/fr/reference/python-sdk), y compris les événements de supervision humaine (`human_wait`, `human_input`, `human_interrupt`) dont dépendent les agents de passerelle et de production. \ No newline at end of file diff --git a/docs/fr/sessions/overview.mdx b/docs/fr/sessions/overview.mdx index d518190cb..64aff7ffc 100644 --- a/docs/fr/sessions/overview.mdx +++ b/docs/fr/sessions/overview.mdx @@ -4,24 +4,26 @@ description: "Commencez par l'enregistrement complet d'une exécution d'agent." icon: "workflow" --- -Une session est le meilleur point de départ lorsqu'un agent se comporte de manière inattendue. Elle regroupe les requêtes au modèle, les réponses, les appels d'outils, les interactions humaines, les erreurs, les évaluations et les décisions de politique appartenant à une même exécution. +Une session est le meilleur point de départ lorsqu'un agent se comporte de manière inattendue. Elle regroupe les requêtes au modèle, les réponses, les appels d'outils, les interactions humaines, les erreurs, les évaluations et les décisions de politique qui appartiennent à une même exécution. + +Les sessions se présentent de la même façon quel que soit le harnais qui les a produites. Une exécution Claude Code réécrivant un dépôt, un agent Hermes répondant à un client dans Slack, et un service Python instrumenté avec le SDK aboutissent tous dans le même format de trace — une seule vue couvre donc l'ensemble de la flotte.
-Suivez une exécution d'agent depuis son objectif jusqu'à la réponse finale, en passant par les appels au modèle et les outils. +Suivez une exécution d'agent depuis son objectif jusqu'aux appels de modèle, aux outils et à la réponse finale. ## Trouver une session - - 1. Dans la barre latérale Cloud, accédez à **Observer → Sessions**. - 2. Définissez la fenêtre temporelle, puis filtrez par environnement, statut, agent ou identifiant de session. - 3. Ajoutez des plages de scores ou de métriques pour affiner par qualité, coût, tokens ou latence. - 4. Sélectionnez une ligne pour ouvrir sa trace. Utilisez le bouton de copie situé à côté de l'identifiant de session pour le partager. + + 1. Dans la barre latérale Cloud, accédez à **Observe → Sessions**. + 2. Définissez la fenêtre temporelle, puis filtrez par environnement, statut, agent ou ID de session. + 3. Ajoutez des plages de scores ou de métriques lorsque vous avez besoin d'un filtre sur la qualité, le coût, les tokens ou la latence. + 4. Sélectionnez une ligne pour ouvrir sa trace. Utilisez le contrôle de copie à côté de l'ID de session pour le partager. - ![La liste des sessions affichant une ligne par exécution avec des filtres par environnement, agent, statut et score d'évaluation.](/images/dashboard/sessions-list.png) + ![La liste des sessions affichant une ligne par exécution avec des filtres sur l'environnement, l'agent, le statut et le score d'évaluation.](/images/dashboard/sessions-list.png) ```bash @@ -36,19 +38,19 @@ Suivez une exécution d'agent depuis son objectif jusqu'à la réponse finale, e ## Ce que vous pouvez faire -- Retrouver une exécution par agent, environnement, période, modèle, type d'événement ou état d'erreur. +- Trouver une exécution par agent, environnement, heure, modèle, type d'événement ou état d'erreur. - Suivre la séquence exacte qui a produit un résultat. -- Comparer les exécutions réussies et échouées. -- Consulter les preuves utilisées par un résultat d'audit ou un incident d'alerte. -- Exporter une session pour en conserver un enregistrement hors ligne. +- Comparer des exécutions réussies et échouées. +- Ouvrir les preuves utilisées par un résultat d'audit ou un incident d'alerte. +- Exporter une session lorsque vous avez besoin d'un enregistrement hors ligne. ## Un ordre d'investigation fiable -1. Confirmez l'objectif et l'environnement de la session. -2. Identifiez la première erreur ou décision inattendue — pas seulement l'échec final. -3. Examinez le contexte du modèle et l'entrée de l'outil juste avant cet événement. -4. Vérifiez les nouvelles tentatives, la latence et les interruptions humaines. -5. Passez en revue les scores d'évaluation et les décisions de politique. +1. Confirmer l'objectif et l'environnement de la session. +2. Identifier la première erreur ou décision inattendue — pas seulement l'échec final. +3. Inspecter le contexte du modèle et l'entrée de l'outil immédiatement avant cela. +4. Vérifier les nouvelles tentatives, la latence et les interruptions humaines. +5. Examiner les scores d'évaluation et les décisions de politique. Apprenez à passer du résumé de session à l'événement qui a causé le résultat. diff --git a/docs/fr/start/quickstart.mdx b/docs/fr/start/quickstart.mdx index 382f82751..c147131c0 100644 --- a/docs/fr/start/quickstart.mdx +++ b/docs/fr/start/quickstart.mdx @@ -4,22 +4,24 @@ description: "Capturez une session d'agent, identifiez une défaillance et comme icon: "zap" --- -Ce guide de démarrage rapide vous permet de connecter une machine pour signaler des sessions, d'effectuer un audit et de déployer une politique. Utilisez la compétence pour configurer Failproof AI, ou suivez les étapes manuelles. Vous avez besoin de Node.js 20.9 ou version ultérieure. +Ce démarrage rapide permet de configurer une machine pour qu'elle rapporte des sessions, d'effectuer un audit et de déployer une politique. Utilisez le skill pour configurer Failproof, ou suivez les étapes manuelles. + +**Quelle est votre situation ?** Si votre agent s'exécute dans l'un des 12 [harnais](/fr/reference/harnesses) pris en charge — une CLI de codage, ou une passerelle comme Hermes ou OpenClaw — suivez les étapes ci-dessous ; vous aurez besoin de Node.js 20.9 ou version ultérieure. Si votre agent ne dispose pas de harnais, instrumentez-le avec le [SDK Python](/fr/reference/python-sdk) pour le traçage et les audits, puis rejoignez la section [Effectuer votre premier contrôle de défaillance](/fr/start/first-audit) ; l'application des politiques sur ce chemin nécessite un hook dans votre runtime. - + - + ```bash npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - Votre agent inspecte le projet, choisit l'intégration appropriée, effectue la configuration et la vérifie. Consultez le [dépôt des compétences FailproofAI](https://github.com/FailproofAI/skills) pour les compétences individuelles et les options d'installation avancées. + Votre agent inspecte le projet, choisit l'intégration appropriée, effectue la configuration et la vérifie. Consultez le [dépôt de skills FailproofAI](https://github.com/FailproofAI/skills) pour les skills individuels et les options d'installation avancées. @@ -27,7 +29,7 @@ Ce guide de démarrage rapide vous permet de connecter une machine pour signaler ## Avant de commencer 1. Ouvrez le [tableau de bord Failproof AI](https://app.befailproof.ai) et créez un compte ou connectez-vous avec votre adresse e-mail professionnelle. -2. Accédez à **Administration → Clés** et créez une clé avec `events:add` et `policies:pull`. +2. Accédez à **Administration → Keys** et créez une clé avec `events:add` et `policies:pull`. 3. Copiez le secret à usage unique et stockez-le sur la machine cible : ```bash @@ -43,7 +45,7 @@ export FAILPROOFAI_KEY="" failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - Les transcriptions de sessions sont envoyées par défaut. Ajoutez `--no-transcripts` pour signaler l'activité des hooks et les décisions de politique sans le contenu des transcriptions. + Les transcriptions de session sont envoyées par défaut. Ajoutez `--no-transcripts` pour rapporter l'activité des hooks et les décisions de politique sans le contenu des transcriptions. Si cette machine possède déjà un historique d'agent, prévisualisez et importez les sept derniers jours, puis attendez la fin de la livraison. Ignorez cette étape sur une nouvelle machine. @@ -55,17 +57,20 @@ export FAILPROOFAI_KEY="" Ouvrez **Sessions** dans Failproof AI et sélectionnez une session importée. - - Cela rattache Failproof AI à votre CLI d'agent et installe les politiques intégrées. Utilisez-les pour observer les décisions de politique locales et tester l'application avant que Failproof AI n'audite vos sessions et n'écrive des politiques pour vos agents. + + Ceci attache Failproof AI à votre harnais et installe les 40 politiques intégrées. Utilisez-les pour observer les décisions de politique locales et tester l'application des règles avant que Failproof AI n'audite vos sessions et n'écrive des politiques pour vos agents. - Laissez l'installateur détecter automatiquement votre CLI d'agent, ou indiquez-en un explicitement. + Laissez l'installateur détecter votre harnais, ou nommez-en un explicitement. Chacun des 12 est une valeur `--cli` valide — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # une CLI de codage + failproofai policies --install --cli hermes --scope user # une passerelle Slack/Telegram ``` + + Le blocage d'un appel d'outil avant son exécution est vérifié sur les 12. Les portes de fin de tour sont vérifiées sur 8 — consultez [la capacité d'application](/fr/reference/harnesses#enforcement-capability) pour la matrice par harnais. - Suivez [Effectuer votre premier contrôle de défaillance](/fr/start/first-audit). Utilisez un objectif concret comme « trouver les sessions où l'agent a réessayé un outil défaillant sans changer d'approche ». + Suivez [Effectuer votre premier contrôle de défaillance](/fr/start/first-audit). Utilisez un objectif concret, par exemple « trouver les sessions où l'agent a réessayé un outil défaillant sans modifier son approche ». Suivez [Prévenir votre première défaillance avec une politique](/fr/start/first-policy). Commencez en mode observation, inspectez les correspondances, puis appliquez la version révisée. @@ -73,7 +78,7 @@ export FAILPROOFAI_KEY="" - Exécutez `failproofai config --status`. Une configuration saine indique la connexion au cloud, l'état du daemon et si l'application des politiques est mise en pause. + Exécutez `failproofai config --status`. Une configuration saine rapporte la connexion au cloud, l'état du daemon et indique si l'application des politiques est en pause. \ No newline at end of file diff --git a/docs/he/index.mdx b/docs/he/index.mdx index 51b2682bc..f7d886268 100644 --- a/docs/he/index.mdx +++ b/docs/he/index.mdx @@ -1,39 +1,42 @@ --- -title: "הפוך את הסוכן שלך לכושל-בטוח" -description: "Failproof AI עוקב אחר התנהגות הסוכן, בודק את ההפעלות לכישלונות, וממפתח מדיניויות שעוצרות בעיות חוזרות." +--- +title: "הפוך את הסוכן שלך לחסין כשלים" +description: "צפייה ואכיפה לכל סביבה בה הסוכנים שלך רצים — CLIs קוד, שערי צ'ט, עוזרים בתדירות עצמית, וסוכנים מעוצבים שלך." icon: "shield-check" --- -Failproof AI עוזר לצוותים להבין מה עשו הסוכנים, למצוא היכן הם נכשלו, וליישם הגנות לפני שאותה התנהגות תחזור על עצמה. +Failproof AI עוזר לצוותים להבין מה עשו הסוכנים, למצוא היכן הם נכשלו, והקימו הגנות לפני שאותה התנהגות תחזור לחזור. + +**סביבה** היא כל מה שהסוכן שלך בעצם רץ בתוכה. Failproof AI מתחבר ל-12 מהן — CLIs קוד כמו Claude Code ו-Codex, שערי צ'ט כמו Hermes, עוזרים בתדירות עצמית כמו OpenClaw — ואותם אירועים, אותן מדיניויות, ואותו היסטוריון של סשן חלים על כל אחד מהם. סוכנים ללא סביבה מדווחים דרך ה-[Python SDK](/he/reference/python-sdk), שעוקב אחריהם ובוחן אותם; אכיפת מדיניות שם דורשת hook בזמן ההוראה שלך. - השתמש בכלי לצורך הכלתן של הפרויקט שלך, חבר אותו, וודא שיומני הסוכן מגיעים. + השתמש בכישור כדי לעצב את הפרויקט שלך, להתחבר, וכדי לאמת שרישומי סוכן מגיעים. - - נתח, עדוד שאילתות, בנה לוחות קשים, והפעל בדיקות בשפה טבעית על יומני הסוכן שלך. + + נתח, שאל שאלות, בנה לוחות מחוונים, והפעל ביקורות בשפה טבעית על רישומי הסוכן שלך. - - עקוב אחר קריאות מודל, כלים, שגיאות, קלט אנושי, זמן השהיה, והחלטות מדיניות בהפעלה אחת. + + עקוב אחרי קריאות מודל, כלים, שגיאות, קלט אנושי, זמן תגובה, והחלטות מדיניות בסשן אחד. - - בדוק קבוצה מוגדרת של הפעלות, סקור ממצאים מבוססי-ראיות, וטרוק תיקוני כבעיות. + + בדוק קבוצה מוגדרת של סשנים, בדוק ממצאים מתומכים בראיות, וועד את הסידור כבעיות. - - הפוך מצב כישלון ידוע למדיניות, שים לב להשפעתו, וממפה אותו על פני הצי שלך. + + הפוך מצב כשל ידוע לנתינה, צפה בהשפעתו, והגדר אותו על פני הצי שלך. -> **הפעלה → בדיקה → ממצא → בעיה → מדיניות**
-> עקוב אחר מה קרה, מצא את הכישלון, נהל את התגובה, ואז מנע אותה התנהגות בהפעלות עתידיות. +> **Session → Audit → Finding → Issue → Policy**
+> עקוב מה קרה, מצא את הכשל, נהל את התגובה, ואז מנע את אותה התנהגות בהפעלות עתידיות. ## התחל כאן -אם אתה פורס את הסוכן המחוקלל הראשון שלך, התחל ב-[quickstart](/he/start/quickstart). אם נתונים כבר מגיעים, פתח את [Sessions](/he/sessions/overview) וביקור בהפעלה אמיתית לפני הגדרת בדיקות או מדיניויות. +אם אתה משדר את הסוכן המעוצב הראשון שלך, התחל עם ה-[quickstart](/he/start/quickstart). אם נתונים כבר מגיעים, פתח את [Sessions](/he/sessions/overview) וחקור הפעלה אמיתית לפני הגדרת ביקורות או מדיניויות. - - השלם את הזרימה של קצה לקצה מלכידה למדיניות משוקללת בטוחה. + + השלם את זרימת העבודה מקצה לקצה מ-capture למדיניות שיש בה בטיחות משודרת. \ No newline at end of file diff --git a/docs/he/reference/harnesses.mdx b/docs/he/reference/harnesses.mdx index 4e808f3e4..8b51d8aae 100644 --- a/docs/he/reference/harnesses.mdx +++ b/docs/he/reference/harnesses.mdx @@ -1,64 +1,72 @@ --- -title: "חיבורי Agent" -description: "תקוף הפעלות והחל מדיניות בממשקי CLI של Agent נתמכים." +--- +title: "הנתונים של סוכנים" +description: "תפוס הפעלות והטל מדיניות על כל 12 נתונים נתמך." icon: "plug-zap" --- -Failproof AI תומך ב-Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI, ו-Goose. +נתון הוא כל מה שהסוכן שלך בעצם פועל בתוכו. Failproof AI תומך בשנים עשר מהם, בשתי קטגוריות: + +- **CLI-ים לקידוד** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **שערים לצ'אט ועוזרים** (2) — Hermes (Slack, Telegram, cron), OpenClaw (עוזר מאורח עצמי) + +אותה מדיניות וגם אותו היסטוריית הפעלה זהים באיזה נתון שהסוכן פועל בתוכו. שכבת מתאם אחת ממפה את שמות האירועים המקוריים של כל נתון, שמות הכלים וממצעי הקלט של כלים למעל 29 אירועים קנוניים לפני שמדיניות כלשהי פועלת. -| חיבור | scope של hook נתמך | +סוכן שפועל ב**אף אחד** מהשנים עשר מותקן ישירות עם [Python SDK](/he/reference/python-sdk). זו חוזה אחרת, וראוי לציין זאת בבהירות: ה-SDK מספק עקיבה, הפעלות, הערכות וביקורות — **הוא אינו אוכף מדיניות בעצמו.** חסימת פעולה לא בטוחה לפני שהיא מתבצעת דורשת hook אכיפה בגבול הכלים של הזמן ריצה שלך; [צור איתנו קשר](mailto:support@befailproof.ai) ואנו נממפה אותו. + +| נתון | ההיקף של hook שנתמך | | --- | --- | -| Claude Code | User, project, local | -| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | -| Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | -| Hermes, OpenClaw | User | +| Claude Code | משתמש, פרויקט, מקומי | +| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | משתמש, פרויקט | +| Factory Droid, Devin CLI, Antigravity CLI, Goose | משתמש, פרויקט | +| Hermes, OpenClaw | משתמש | -כל אינטגרציה מנרמלת את שמות אירועי ה-hook המקוריים שלה, שמות הכלים, ושדות ה-tool-input לפני הפעלת מדיניות. מדיניות יכולה לפעול רק על אירועים שה-harness חושף; בדוק התנהגות end-of-turn והוראה בדיוק על ה-harness והגרסה שאתה פורס. +כל אינטגרציה מנרמלת את שמות אירועי ה-hook המקוריים שלה, שמות כלים וממצעי קלט של כלים לפני שמדיניות פועלת. מדיניות יכולה להשפיע רק על אירועים שהנתון חשוף; בדוק התנהגות סוף-תור והוראה בנתון וגרסה המדויקים שאתה משתמש בהם. -## יכולת הטלת חוק +## יכולת אכיפה -"Block" פירושו שהוועדה שהוחזרה מהמתאם הנוכחי נצרכת על ידי ה-harness המסוים. חסימה לאחר כלי עשויה להחליף את התוצאה המוצגת למודל אך לא יכולה לשנות השפעה צדדית של כלי שכבר התרחשה. +"חסום" פירושו שהגזר של המתאם הנוכחי נצרך על ידי הנתון המנוקד. חסימה לאחר כלי עשויה להחליף את התוצאה המוצגת למודל אך לא יכולה לבטל תופעת צד של כלי שכבר התרחשה. -| חיבור | אירועי חסימה מאומתים | זהירויות שנצפות בלבד או לא בעלות חסימה | +| נתון | אירועי חסימה מאומתים | קביעות של תצפית בלבד או ללא חסימה | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, וכמה אירועים של משימה/תצורה | `PostToolUse`, מחזור חיים של הפעלה, הודעות, ואירועים לאחר כשל הם תצפיתיים. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | חסימה לאחר כלי מחליפה את התוצאה לאחר הביצוע; אירועי התחלת הפעלה וקיבוץ הם תצפיתיים במתאם הנוכחי. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | חסימה לאחר כלי מחליפה את התוצאה לאחר הביצוע; אירועי הפעלה והודעה הם תצפיתיים. | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` ואירועי הפעלה הם תצפיתיים. | -| OpenCode | `PreToolUse` | אירועים לאחר כלי ומחזור חיים הם תצפיתיים; טיפול Stop נוכחי הוא הדרכה לתור מאוחר יותר ולא שער מאומת. | -| Pi | `PreToolUse`, `UserPromptSubmit` | אירועים לאחר כלי ומחזור חיים הם תצפיתיים; הדרכת stop חלה על תור מאוחר יותר. | -| Hermes | `PreToolUse` | וועדות לאחר כלי, הפעלה, וחסימת subagent אינן שערים. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | אירועים לאחר כלי, הפעלה, subagent-stop, וקיבוץ הם תצפיתיים. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | וועדות לאחר כלי וחסימת subagent הן תצפיתיות. | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, מותנה `PermissionRequest` | hook של הרשאה אינם פועלים בכל מצב הרשאה; אירועים לאחר כלי והפעלה הם תצפיתיים. | -| Antigravity CLI | `PreToolUse`, `Stop` | וועדות של user-prompt ולאחר כלי הן תצפיתיות; הוראות prompt עדיין ניתן להזריק. | -| Goose | `PreToolUse` | אירועים של user-prompt, לאחר כלי, והפעלה הם תצפיתיים. hook stop בעל חסימה מקוריות קיימת בעל זרם אך לא מותקנת על ידי המתאם הנוכחי. | - -יכולות רגישות לגרסה. בדוק מחדש לאחר שדרוג ממשק CLI של agent, במיוחד כאשר מדיניות מסתמכת על התנהגות prompt, stop, permission, או post-tool במקום השער pre-tool הנפוץ. - -## התקן capture וhooks של מדיניות +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` ואירועי משימה/תצורה רבים | `PostToolUse`, מחזור חיים של הפעלה, הודעות ואירועי לאחר כישלון הן תצפייתיות. | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | חסימה לאחר כלי מחליפה את התוצאה אחרי ביצוע; אירועי התחלת הפעלה וקומפקטיות הם תצפייתיות במתאם הנוכחי. | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | חסימה לאחר כלי מחליפה את התוצאה אחרי ביצוע; אירועי הפעלה והודעה הם תצפייתיות. | +| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` ואירועי הפעלה הם תצפייתיות. | +| OpenCode | `PreToolUse` | אירועי לאחר כלי ומחזור חיים הם תצפייתיות; טיפול עצירה נוכחי הוא הדרכה לתור מאוחר יותר ולא שער מאומת. | +| Pi | `PreToolUse`, `UserPromptSubmit` | אירועי לאחר כלי ומחזור חיים הם תצפייתיות; הדרכת עצירה חלה על תור מאוחר יותר. | +| Hermes | `PreToolUse` | אחרי כלי, הפעלה וגזרי עצירה תת-סוכן אינם שערים. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | אחרי כלי, הפעלה, עצירה תת-סוכן ואירועי דחיסה הם תצפייתיים. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | גזרי לאחר כלי ועצירה תת-סוכן הם תצפייתיים. | +| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` מותנה | hook הרשאה אינו פועל בכל מצב הרשאה; אירועי לאחר כלי והפעלה הם תצפייתיים. | +| Antigravity CLI | `PreToolUse`, `Stop` | גזרי הנחת משתמש ולאחר כלי הם תצפייתיים; הוראות הנחה עדיין יכולות להיות מוזרקות. | +| Goose | `PreToolUse` | אירועי הנחת משתמש, לאחר כלי והפעלה הם תצפייתיים. hook עצירה חסימה מקומי קיים במעלה הזרם אך לא מותקן על ידי המתאם הנוכחי. | + +יכולות תלויות בגרסה. בדוק מחדש אחרי שדרוג סוכן CLI, במיוחד כשמדיניות מסתמכת על התנהגות של הנחה, עצירה, הרשאה או לאחר כלי ולא על שער לפני כלי נפוץ. + +## התקן capture ו-policy hooks - - 1. פתח **Administration → Keys** וצור מפתח עם `events:add` ו-`policies:pull`, ששמו מיועד למכונה או סביבה. - 2. במכונת היעד, חבר את ממשק ה-CLI המקומי עם המפתח המוצג והתקן את ה-harness hooks. - 3. התחל הפעלת agent חדשה, ואז אשר את האירועים של hook והפעלה שלה תחת **Observe → Events**. - 4. פתח **Observe → policy** לאותו חלון זמן ואשר שהחלטת מדיניות מיוחסת למכונה. + + 1. פתח **Administration → Keys** וצור מפתח עם `events:add` ו-`policies:pull`, נקרא למכונה או לסביבה. + 2. במכונת היעד, חבר את ה-CLI המקומי עם המפתח המוצג והתקן את hook-ים של הנתון. + 3. התחל הפעלה חדשה של סוכן, ואז אשר את hook שלה ואירועי הפעלה תחת **Observe → Events**. + 4. פתח **Observe → policy** עבור אותה חלון זמן ואשר שהחלטת מדיניות מיוחסת למכונה. - החיבור מתחיל עם מפתח של מכונה. אשר שהוא כולל הן הרשאות הספיגה והן הרשאות מסירת מדיניות לפני העתקת ההסוד שלו. + החיבור מתחיל עם מפתח של מכונה. אשר שהוא כולל הן הרשאות הזנה והן הרשאות הספקת מדיניות לפני שתעתיק את הסוד שלו. - ![מגירת מפתח API חדשה המשמשת להעניית הרשאות ספיגה ומסירת מדיניות.](/images/dashboard/key-create.png) + ![מגירת המפתח החדשה של API המשמשת להעניית הרשאות הזנה ואספקת מדיניות.](/images/dashboard/key-create.png) - לאחר התקנת ה-hooks, זרם ה-Events צריך להציג אירועים חדשים מהמכונה והסביבה שהתחברת אליה. + לאחר התקנת hook-ים, זרם Events צריך להציג אירועים חדשים מהמכונה והסביבה שחיברת. - ![זרם ה-Events החי המשמש לאישור ש-harness שהותקן זה עתה מדווח.](/images/dashboard/events-stream.png) + ![זרם Events חי המשמש לאישור שנתון שהתקנת זה מדווח.](/images/dashboard/events-stream.png) - לבסוף, אשר שהחלטות מדיניות מיוחסות לאותה מכונה. זה מאשר שה-harness מדווח על פעילות מדיניות וכן על אירועי עקיבה. + לבסוף, אמת שהחלטות מדיניות מיוחסות לאותה מכונה. זה מאשר שהנתון מדווח פעילות מדיניות כמו גם אירועי עקיבה. - ![עמוד המדיניות המשמש לאימות החלטות מדיניות מ-harness שחובר זה עתה.](/images/dashboard/policy-observe.png) + ![דף Policy המשמש לאימות החלטות מדיניות מנתון שחובר לאחרונה.](/images/dashboard/policy-observe.png) - התקן hooks לכל harness שנגלה: + התקן hook-ים עבור כל נתון שגילה: ```bash failproofai config \ @@ -67,7 +75,7 @@ Failproof AI תומך ב-Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCod failproofai policies --install ``` - או היעד לשם harnesses ול-scope של תצורה: + או היעד נתוני בשם וההיקף של תצורה: ```bash failproofai policies --install \ @@ -75,9 +83,9 @@ Failproof AI תומך ב-Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCod --scope user ``` - Project scope שמור hook תצורה עם מאגר. User scope מכסה עבודה על פני מאגרים. Claude Code תומך גם ב-local scope; התמיכה משתנה לפי harness וה-CLI דוחה שילובים שלא נתמכו. + היקף פרויקט שומר על תצורת hook עם מחסן. היקף משתמש מכסה עבודה על פני מחסנים. Claude Code גם תומך בהיקף מקומי; התמיכה משתנה לפי נתון וה-CLI דוחה שילובים לא נתמכים. - אשר את המכונה והאירועים שלה: + אמת את המכונה ואירועיה: ```bash failproofai config --status @@ -91,9 +99,9 @@ Failproof AI תומך ב-Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCod - נתיבים נוספים רשומים על המכונה, לא בענן. לאחר הוספת אחד, פתח **Observe → Sessions**, סנן לסביבה של המכונה, ואשר שהפעלות מהנתיב החדש מופיעות. פתח הפעלה ובדוק את ה-agent, harness, וחותמות זמן של אירוע לפני שתעשה בהן שימוש בביקורת. + נתיבים נוספים רשומים על המכונה, לא בענן. לאחר הוספת אחד, פתח **Observe → Sessions**, סנן לסביבת המכונה ואשר שהפעלות מהנתיב החדש מופיעות. פתח הפעלה ובדוק את הסוכן, הנתון וחותמות הזמן של אירועים לפני שתסתמך על כך בביקורת. - ![רשימת ה-Sessions המסוננת לסביבה המקבלת נתונים מנתיב ה-capture הנוסף.](/images/dashboard/sessions-list.png) + ![רשימת Sessions מסוננת לסביבה המקבלת נתונים מנתיב הלכידה הנוסף.](/images/dashboard/sessions-list.png) הוסף נתיב עם תווית אופציונלית, ואז בדוק את הנתיבים המוגדרים: @@ -110,5 +118,5 @@ Failproof AI תומך ב-Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCod - הפעל הפעלה חדשה אחת לאחר ההתקנה. אשר גם את זרם האירועים החי וגם החלטת מדיניות בפועל לפני הרחבת ה-rollout. + הרץ הפעלה חדשה אחת לאחר ההתקנה. אמת גם את זרם האירוע החי וגם החלטת מדיניות בפועל לפני הרחבת ההצגה. \ No newline at end of file diff --git a/docs/he/sessions/live-events.mdx b/docs/he/sessions/live-events.mdx index 05f71b30b..265fd44c8 100644 --- a/docs/he/sessions/live-events.mdx +++ b/docs/he/sessions/live-events.mdx @@ -1,21 +1,21 @@ --- title: "אירועים בזמן אמת" -description: "צפו בפעילות הסוכן כשהיא מתרחשת במהלך הפעילות." +description: "צפו בפעילות הסוכן תוך כדי ריצה של התא." icon: "radio" --- -אירועים בזמן אמת עוזרים לכם לאשר את האינסטרומנטציה ולעקוב אחרי הפעלה מסוכנת ללא צורך להמתין לסיום ההפעילות. +אירועים בזמן אמת עוזרים לכם לאשר את הקביעה וללמוד על ריצה בסיכון ללא צפייה להסתיום של התא. ## צפייה בפעילות - 1. עברו אל **Observe → Events**. - 2. התחילו עם חלון הזמן הנוכחי ללא סינונים כדי לאשר שהנתונים מגיעים. - 3. סננו לפי סביבה, סוג אירוע, סוכן או הפעילות. השתמשו בחיפוש לחיפוש בטקסט של payload. - 4. בחרו אירוע כדי לבדוק את הסיכום והפרטים שלו. עקבו אחרי קישור ההפעילות שלו כדי לראות את העקבה המלאה. + 1. עברו ל-**Observe → Events**. + 2. התחילו עם חלון הזמן הנוכחי ללא סינונים כדי לאשר שנתונים הגיעים. + 3. סננו לפי סביבה, סוג אירוע, סוכן או תא. השתמשו בחיפוש לטקסט של payload. + 4. בחרו באירוע כדי לבדוק את סיכומו ופרטיו. עקבו אחרי קישור התא שלו כדי לראות את העקבות המלאים. - ![זרם האירועים החי עם סינוני זמן, סביבה, סוג אירוע, סוכן, מודל, הקשר, הפעילות וטקסט.](/images/dashboard/events-stream-current.png) + ![זרם Events בזמן אמת המציג תעבורה מ-Hermes chat gateway ותוך כדי ריצות coding-CLI, מסוננת לפי זמן, סביבה, סוג אירוע, סוכן, מודל, קונטקסט ותא.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ icon: "radio" fp --json events --full --session-id --all ``` - הזרם ברירת המחדל משמיט payload גולמיים. השתמשו ב-`--full` רק לחקירת הפעילות מוגבלת בזמן. + הזרם ברירת המחדל משמיט payloads גולמיים. השתמשו ב-`--full` רק לחקירה של תא מוגבל. השתמשו בזרם האירועים כדי לענות על שלוש שאלות מיידיות: - האם הסוכן הצפוי מדווח לסביבה הנכונה? -- האם קריאות דגם, קריאות כלים וההחלטות של מדיניות מגיעות בסדר? -- האם ההפעילות הפסיקה להתקדם או החלה לחזור על פעולה? +- האם קריאות מודל, קריאות כלים והחלטות מדיניות הגיעו בסדר? +- האם התא הפסיק להתקדם או התחיל לחזור על פעולה? -סוגי אירועים כוללים אירועי מחזור חיים של סוכן, בקשות ותגובות דגם, שימוש בכלים ותוצאות, ביצוע hook, המתנות וקטיעות אנוש, והודעות שגיאה מפורשות. מזהי קורלציה מחברים אירועים זוגיים כמו קריאת כלי והתוצאה שלה. +סוגי אירועים כוללים אירועי מחזור חיים של סוכן, בקשות ותגובות מודל, שימוש בכלים ותוצאות, ביצוע hook, המתנות והפרעות אנושיות, וטעויות מפורשות. מזהי מתאם חיברו אירועים זוגיים כמו קריאת כלי והתוצאה שלה. - שמרו את התצוגה החיה רחבה בעת אימות שילוב חדש. הוסיפו סינונים רק לאחר שתראו את האירוע הראשון; סינון שגוי יכול להראות כמו ingestion שנכשל. + שמרו על התצוגה החי רחבה בעת אימות אינטגרציה חדשה. הוסיפו סינונים רק אחרי שתראו את האירוע הראשון; סינון לא נכון יכול להיראות כמו קליטה שהנכשלה. -אם לא מופיעים אירועים, הריצו `failproofai config --status`, ואז [פתרו בעיות ingestion](/he/reference/troubleshooting). \ No newline at end of file +אם לא מופיעים אירועים, הריצו `failproofai config --status`, ואז [פתרו בעיות בקליטה](/he/reference/troubleshooting). + +סוכנים שלא פועלים באחד ממ-12 ה-[harnesses](/he/reference/harnesses) הנתמכים מדווחים על אותם סוגי אירועים דרך ה-[Python SDK](/he/reference/python-sdk), כולל אירועי האנוש-בתוך-התא (`human_wait`, `human_input`, `human_interrupt`) שגטוויי וסוכנים בייצור מסתמכים עליהם. \ No newline at end of file diff --git a/docs/he/sessions/overview.mdx b/docs/he/sessions/overview.mdx index f44871a92..ff76158c6 100644 --- a/docs/he/sessions/overview.mdx +++ b/docs/he/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "סשנים" -description: "התחל עם הרשומה המלאה של הרצה אחת של סוכן." +description: "התחל עם רשומה מלאה של הרצה אחת של Agent." icon: "workflow" --- -סשן הוא נקודת התחלה מעולה כאשר סוכן מתנהג בצורה בלתי צפויה. הוא משלב את בקשות המודל, התגובות, קריאות הכלים, האינטראקציות האנושיות, השגיאות, ההערכות והחלטות המדיניות השייכות להרצה אחת. +סשן הוא נקודת ההתחלה הטובה ביותר כאשר agent מתנהג בצורה בלתי צפויה. הוא מחבר את בקשות המודל, התגובות, קריאות הכלים, האינטראקציות האנושיות, השגיאות, ההערכות וההחלטות המדיניות השייכות להרצה אחת. + +סשנים נראים זהים ללא קשר לאיזה harness ייצר אותם. הרצת Claude Code שכותבת מחדש ריפוזיטוריום, agent Hermes שעונה ללקוח ב-Slack, ושירות Python שמצויד ב-SDK - כולם מגיעים לאותה תבנית trace, כך שתצפית אחת מכסה את כל הFleet.
-עקוב אחר הרצה אחת של סוכן מהמטרה שלו דרך קריאות מודל, כלים, והתגובה הסופית. +עקוב אחר הרצה אחת של agent מהמטרה שלו דרך קריאות המודל, הכלים והתגובה הסופית. ## מצא סשן - 1. בסרגל הצד של Cloud, עבור אל **Observe → Sessions**. - 2. הגדר את חלון הזמן, ואז סנן לפי סביבה, סטטוס, סוכן, או מזהה סשן. - 3. הוסף טווחי ניקוד או מטריקה כאשר אתה זקוק לפרוסה של איכות, עלות, אסימון או זמן השהייה. - 4. בחר שורה כדי לפתוח את ה־trace שלה. השתמש בפקד ההעתקה ליד מזהה הסשן כאשר אתה משתף אותו. + 1. בסרגל הצד של Cloud, עבור ל-**Observe → Sessions**. + 2. קבע את חלון הזמן, ואז סנן לפי environment, status, agent, או session ID. + 3. הוסף score או metric ranges כאשר אתה זקוק לפרוסת quality, cost, token, או latency. + 4. בחר בשורה לפתיחת ה-trace שלה. השתמש בפקד ההעתקה ליד session ID בעת שיתוף. - ![רשימת הסשנים המציגה שורה אחת לכל הרצה עם סינוני סביבה, סוכן, סטטוס וניקוד הערכה.](/images/dashboard/sessions-list.png) + ![רשימת Sessions המציגה שורה אחת לכל הרצה עם מסננים של environment, agent, status, ו-evaluation score.](/images/dashboard/sessions-list.png) ```bash @@ -30,25 +32,25 @@ icon: "workflow" fp --json sessions --session-id ``` - הוסף `--agents` להרחיב הרצות של מספר סוכנים, `--all` לעימוד, או `--fields` לבחירת עמודות פלט. + הוסף `--agents` להרחבת הרצות multi-agent, `--all` לעימוד, או `--fields` לבחירת עמודות output. ## מה אתה יכול לעשות -- מצא הרצה לפי סוכן, סביבה, זמן, מודל, סוג אירוע, או מצב שגיאה. -- עקוב אחר הרצף המדויק שייצר תוצאה. -- השווה הרצות שהצליחו והחזיקו בכישלון. -- פתח את הראיות המשמשות במציאת ביקורת או אירוע התראה. -- ייצא סשן כאשר אתה זקוק לרשומה לא מקוונת. +- מצא הרצה לפי agent, environment, זמן, model, event type, או error state. +- עקוב אחר הרצף המדויק שהוביל לתוצאה. +- השווה הרצות מוצלחות ושנכשלו. +- פתח את הראיות המשמשות ממצא ביקורת או incident של alert. +- ייצא סשן כאשר אתה זקוק לרשומה offline. ## סדר חקירה אמין -1. אשר את המטרה של הסשן וההסביבה. -2. מצא את השגיאה או ההחלטה הלא צפויה הראשונה—לא רק הכישלון הסופי. -3. בדוק את הקשר של המודל וקלט הכלי מיד לפניו. -4. בדוק ניסיונות חוזרים, זמן השהייה והפסקות אנושיות. -5. בחן ניקודי הערכה והחלטות מדיניות. +1. אשר את goal ו-environment של הסשן. +2. מצא את השגיאה הראשונה או ההחלטה בלתי צפויה - לא רק את הכישלון הסופי. +3. בדוק את context המודל ו-tool input מיד לפניו. +4. בדוק retries, latency, ו-human interruptions. +5. סקור את evaluation scores וההחלטות המדיניות. למד כיצד לעבור מסיכום הסשן לאירוע שגרם לתוצאה. diff --git a/docs/he/start/quickstart.mdx b/docs/he/start/quickstart.mdx index ffc11a1f7..632798f60 100644 --- a/docs/he/start/quickstart.mdx +++ b/docs/he/start/quickstart.mdx @@ -1,51 +1,53 @@ --- title: "התחלה מהירה" -description: "תפוס הפעלת agent, מצא כשל והתחל להימנע ממנו." +description: "תפסו הפעלת סוכן, מצאו כשל וקחו צעדים למנוע אותו." icon: "zap" --- -ההתחלה המהירה הזו תקבל מכונה אחת המדווחת על הפעלות, תריץ ביקורת, ותפרוס מדיניות. השתמש בכישור כדי להגדיר את Failproof AI, או בצע את השלבים ידנית. אתה זקוק ל-Node.js 20.9 או גרסה מעדכנת יותר. +התחלה מהירה זו מגדירה מכונה אחת לדיווח הפעלות, מריצה ביקורת ויוצרת פריסה של מדיניות. השתמשו בכישוריות כדי להגדיר את Failproof AI, או עקבו אחר השלבים הידניים. + +**איזה מסלול שלך?** אם הסוכן שלך פועל באחד מ-12 [harnesses](/he/reference/harnesses) הנתמכים — CLI קידוד, או gateway כמו Hermes או OpenClaw — עקבו אחר השלבים להלן; אתם זקוקים ל-Node.js 20.9 או חדש יותר. אם לסוכן שלך אין harness, אנו מציעים לכם להשתמש ב-[Python SDK](/he/reference/python-sdk) לכדי מעקב וביקורות, ואז חזרו אל [הריצה של בדיקת הכשל הראשונה שלכם](/he/start/first-audit); אכיפה בנתיב זה דורשת hook בזמן הריצה שלכם. - + - + ```bash npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - ה-agent שלך בוחן את הפרויקט, בוחר את האינטגרציה הרלוונטית, מבצע את ההגדרה ומאמת אותה. ראה את [מאגר כישורי FailproofAI](https://github.com/FailproofAI/skills) כדי לקבל כישורים בודדים ואפשרויות התקנה מתקדמות. + הסוכן שלכם בוחן את הפרויקט, בוחר את האינטגרציה הרלוונטית, מבצע את ההגדרה ומאמת אותה. ראו את [מאגר הכישורים של FailproofAI](https://github.com/FailproofAI/skills) לקבלת כישורים בודדים וגם אפשרויות התקנה מתקדמות. - ## לפני שתתחיל + ## לפני שאתם מתחילים -1. פתח את [לוח בקרת Failproof AI](https://app.befailproof.ai) וצור חשבון או התחבר עם דוא״ל עבודה. -2. עבור אל **Administration → Keys** וצור מפתח עם `events:add` ו-`policies:pull`. -3. העתק את הסוד החד-פעמי ושמור אותו במכונת היעד: +1. פתחו את [לוח הבקרה של Failproof AI](https://app.befailproof.ai) וצרו חשבון או התחברו עם דוא"ל שלך לעבודה. +2. עברו אל **Administration → Keys** וצרו מפתח עם `events:add` ו-`policies:pull`. +3. העתיקו את הסוד החד-פעמי ואחסנו בו על המכונה היעד: ```bash export FAILPROOFAI_KEY="" ``` - ## התקן + ## התקנה - + ```bash npm install -g failproofai failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - תמלילי הפעלות נשלחים כברירת מחדל. הוסף `--no-transcripts` כדי לדווח על פעילות hook והחלטות מדיניות ללא תוכן תמלילים. + תמלילי הפעלות נשלחים כברירת מחדל. הוסיפו `--no-transcripts` כדי לדווח על פעילות hook והחלטות מדיניות ללא תוכן תמלילים. - אם למכונה זו יש כבר היסטוריית agent, סקור וייבא את שבעת הימים האחרונים, ואז חכה עד שהמסירה תסתיים. דלג על שלב זה במכונה חדשה. + אם למכונה זו כבר יש היסטוריה של סוכן, הצג בחזקה ויבוא את שבעת הימים האחרונים, ואז חכו להשלמת המסירה. דלגו על שלב זה במכונה חדשה. ```bash failproofai backfill --since 7d --dry-run @@ -53,27 +55,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - פתח את **Sessions** ב-Failproof AI בחר הפעלה שייובאה. + פתחו את **Sessions** ב-Failproof AI ובחרו בהפעלה מיובאת. - - זה מצמיד את Failproof AI ל-CLI של ה-agent שלך ומתקין את המדיניויות המובנות. השתמש בהן כדי לראות החלטות מדיניות מקומיות וננסה אכיפה לפני שFailuproof AI מבצע ביקורת בהפעלות שלך וכותב מדיניויות עבור ה-agents שלך. + + זה מחבר את Failproof AI ל-harness שלכם ומתקין את 40 המדיניות המובנות. השתמשו בהן כדי לראות החלטות מדיניות מקומיות ולנסות אכיפה לפני שFailproof AI מבקרת בהפעלות שלכם ורושמת מדיניות לסוכנים שלכם. - תן להתקן לזהות את CLI של ה-agent שלך, או שם אחד במפורש. + תנו להתקנה לזהות את ה-harness שלכם, או שמו אחד בבירור. כל אחד מ-12 הוא ערך חוקי של `--cli` — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # a coding CLI + failproofai policies --install --cli hermes --scope user # a Slack/Telegram gateway ``` + + חסימת קריאת כלי לפני שהוא פועל מאומתת על כל 12. שערי סוף פנייה מאומתים ב-8 — ראו [יכולת אכיפה](/he/reference/harnesses#enforcement-capability) למטריקס לפי harness. - - עקוב אחר [הריצה של בדיקת הכשל הראשונה שלך](/he/start/first-audit). השתמש במטרה קונקרטית כגון "מצא הפעלות שבהן ה-agent ניסה שוב כלי כושל ללא שינוי בגישה שלו." + + עקבו אחר [הריצה של בדיקת הכשל הראשונה שלכם](/he/start/first-audit). השתמשו במטרה קונקרטית כמו "מצאו הפעלות שבהן הסוכן ניסה מחדש כלי שנכשל ללא שינוי בגישתו." - - עקוב אחר [מנע את הכשל הראשון שלך עם מדיניות](/he/start/first-policy). התחל במצב התבונה, בדוק התאמות, ואז אכוף את הגרסה שנבדקה. + + עקבו אחר [מנעו את הכשל הראשון שלכם עם מדיניות](/he/start/first-policy). התחילו במצב צפייה, בדקו התאמות, ואז אכוף את הגרסה שבדקתם. - הריצ `failproofai config --status`. הגדרה תקינה מדווחת על חיבור הענן, מצב ה-daemon, והאם האכיפה מושהית. + הריצו `failproofai config --status`. הגדרה בריאה מדווחת על חיבור הענן, מצב הדימון ואם אכיפה מושהית. \ No newline at end of file diff --git a/docs/hi/index.mdx b/docs/hi/index.mdx index a2837a97c..b16ad9e9b 100644 --- a/docs/hi/index.mdx +++ b/docs/hi/index.mdx @@ -1,39 +1,42 @@ --- -title: "अपने एजेंट को failproof बनाएं" -description: "Failproof AI एजेंट के व्यवहार को ट्रेस करता है, विफलताओं के लिए सेशन को ऑडिट करता है, और ऐसी नीतियां तैनात करता है जो दोहराए जाने वाले घटनाओं को रोकती हैं।" +--- +title: "अपने एजेंट को विफलता-प्रतिरोधी बनाएं" +description: "प्रत्येक हार्नेस के लिए अवलोकनशीलता और प्रवर्तन जिसमें आपके एजेंट चलते हैं — कोडिंग CLIs, चैट गेटवे, स्वयं-होस्ट किए गए सहायक, और आपके स्वयं के साधन एजेंट।" icon: "shield-check" --- -Failproof AI टीमों को यह समझने में मदद करता है कि एजेंट्स ने क्या किया, वह कहां विफल हुए, और समान व्यवहार दोबारा होने से पहले सुरक्षा उपाय तैनात करते हैं। +Failproof AI टीमों को यह समझने में मदद करता है कि एजेंट ने क्या किया, वह कहां विफल हुआ, और समान व्यवहार होने से पहले सुरक्षा उपाय तैनात करें। + +एक **हार्नेस** वह है जिसके अंदर आपका एजेंट वास्तव में चलता है। Failproof AI 12 में हुक करता है — कोडिंग CLIs जैसे Claude Code और Codex, चैट गेटवे जैसे Hermes, स्वयं-होस्ट किए गए सहायक जैसे OpenClaw — और समान इवेंट, समान नीतियां, और समान सेशन इतिहास सभी पर लागू होते हैं। कोई हार्नेस न होने वाले एजेंट [Python SDK](/hi/reference/python-sdk) के माध्यम से रिपोर्ट करते हैं, जो उन्हें ट्रेस और ऑडिट करता है; वहां एक नीति को लागू करने के लिए आपके स्वयं के रनटाइम में एक हुक की आवश्यकता है। - - अपने प्रोजेक्ट को इंस्ट्रूमेंट करने, इसे कनेक्ट करने और एजेंट लॉग आने की पुष्टि करने के लिए स्किल का उपयोग करें। + + अपनी परियोजना को साधन करने, इसे कनेक्ट करने, और यह सत्यापित करने के लिए कौशल का उपयोग करें कि एजेंट लॉग आते हैं। - - अपने एजेंट लॉग पर प्राकृतिक भाषा में विश्लेषण, क्वेरी, डैशबोर्ड बनाएं और ऑडिट चलाएं। + + अपने एजेंट लॉग पर प्राकृतिक भाषा में विश्लेषण करें, क्वेरी करें, डैशबोर्ड बनाएं, और ऑडिट चलाएं। - एक सेशन में मॉडल कॉल, टूल्स, त्रुटियां, मानवीय इनपुट, लेटेंसी और नीति निर्णयों का अनुसरण करें। + एक सेशन में मॉडल कॉल, टूल, त्रुटियां, मानव इनपुट, लेटेंसी, और नीति निर्णयों का अनुसरण करें। - - सेशन के एक निर्धारित सेट को ऑडिट करें, साक्ष्य-समर्थित निष्कर्षों की समीक्षा करें और उपचार को मुद्दों के रूप में ट्रैक करें। + + सेशन के एक परिभाषित समूह को ऑडिट करें, साक्ष्य-समर्थित निष्कर्षों की समीक्षा करें, और उपचार को समस्याओं के रूप में ट्रैक करें। - एक ज्ञात विफलता मोड को नीति में बदलें, इसके प्रभाव को देखें और इसे अपने पूरे फ्लीट में तैनात करें। + एक ज्ञात विफलता मोड को नीति में बदलें, इसके प्रभाव को देखें, और इसे अपने पूरे बेड़े में तैनात करें। -> **सेशन → ऑडिट → निष्कर्ष → मुद्दा → नीति**
-> ट्रेस करें कि क्या हुआ, विफलता खोजें, प्रतिक्रिया का प्रबंधन करें, फिर भविष्य के रन में समान व्यवहार को रोकें। +> **सेशन → ऑडिट → खोज → समस्या → नीति**
+> ट्रेस करें कि क्या हुआ, विफलता खोजें, प्रतिक्रिया प्रबंधित करें, फिर भविष्य के रन में समान व्यवहार को रोकें। ## यहां से शुरू करें -यदि आप अपना पहला इंस्ट्रूमेंटेड एजेंट तैनात कर रहे हैं, तो [quickstart](/hi/start/quickstart) से शुरू करें। यदि डेटा पहले से आ रहा है, तो [Sessions](/hi/sessions/overview) खोलें और ऑडिट या नीतियों को कॉन्फ़िगर करने से पहले एक वास्तविक रन का निरीक्षण करें। +यदि आप अपने पहले साधन एजेंट को तैनात कर रहे हैं, तो [quickstart](/hi/start/quickstart) के साथ शुरू करें। यदि डेटा पहले से आ रहा है, तो [सेशन](/hi/sessions/overview) खोलें और ऑडिट या नीतियों को कॉन्फ़िगर करने से पहले एक वास्तविक रन का निरीक्षण करें। - कैप्चर से लेकर सुरक्षित रूप से तैनात नीति तक अंत-से-अंत वर्कफ़्लो पूरा करें। + कैप्चर से सुरक्षित रूप से तैनात नीति तक अंत-से-अंत वर्कफ़्लो पूरा करें। \ No newline at end of file diff --git a/docs/hi/reference/harnesses.mdx b/docs/hi/reference/harnesses.mdx index c4e22628f..fcb22faa2 100644 --- a/docs/hi/reference/harnesses.mdx +++ b/docs/hi/reference/harnesses.mdx @@ -1,64 +1,71 @@ --- -title: "Agent harnesses" -description: "समर्थित agent CLIs में सेशन कैप्चर करें और नीतियों को लागू करें।" +title: "एजेंट हार्नेसेस" +description: "सभी 12 समर्थित एजेंट हार्नेसेस में सत्र कैप्चर करें और नीतियों को लागू करें।" icon: "plug-zap" --- -Failproof AI Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI, और Goose को सपोर्ट करता है। +एक हार्नेस वह है जिसके अंदर आपका एजेंट वास्तव में चलता है। Failproof AI इनमें से बारह का समर्थन करता है, दो श्रेणियों में: -| Harness | समर्थित hook scopes | +- **कोडिंग CLIs** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **चैट और असिस्टेंट गेटवे** (2) — Hermes (Slack, Telegram, cron), OpenClaw (स्व-होस्टेड असिस्टेंट) + +एक ही नीतियाँ और एक ही सत्र इतिहास वही लागू होता है चाहे कोई एजेंट किसी में भी चले। एक एडेप्टर लेयर प्रत्येक हार्नेस की मूल घटना नामों, उपकरण नामों, और उपकरण-इनपुट फ़ील्ड को 29 विहित घटनाओं में मैप करती है, इससे पहले कि कोई नीति चले। + +एक एजेंट जो बारह में से **किसी में** नहीं चलता है, उसे [Python SDK](/hi/reference/python-sdk) के साथ सीधे संचालित किया जाता है। यह एक अलग अनुबंध है, और स्पष्ट रूप से कहना योग्य है: SDK ट्रेसिंग, सत्र, मूल्यांकन और ऑडिट प्रदान करता है — **यह अपने आप पर नीतियों को लागू नहीं करता है।** किसी असुरक्षित कार्यवाही को निष्पादित करने से पहले ब्लॉक करने के लिए आपके रनटाइम के टूल सीमा पर एक प्रवर्तन हुक की आवश्यकता होती है; [हमसे संपर्क करें](mailto:support@befailproof.ai) और हम इसे मैप करेंगे। + +| हार्नेस | समर्थित हुक स्कोप | | --- | --- | -| Claude Code | User, project, local | -| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | -| Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | -| Hermes, OpenClaw | User | +| Claude Code | उपयोगकर्ता, प्रोजेक्ट, स्थानीय | +| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | उपयोगकर्ता, प्रोजेक्ट | +| Factory Droid, Devin CLI, Antigravity CLI, Goose | उपयोगकर्ता, प्रोजेक्ट | +| Hermes, OpenClaw | उपयोगकर्ता | -प्रत्येक एकीकरण अपनी native hook event names, tool names, और tool-input fields को सामान्य बनाता है इससे पहले कि नीतियां चलें। एक नीति केवल उन्हीं events पर कार्य कर सकती है जिन्हें harness expose करता है; अपने द्वारा तैनात किए जाने वाले सटीक harness और संस्करण पर end-of-turn और instruction behavior का परीक्षण करें। +प्रत्येक एकीकरण नीतियों के चलने से पहले अपनी मूल हुक घटना नामों, उपकरण नामों, और उपकरण-इनपुट फ़ील्ड को सामान्य करता है। एक नीति केवल वही घटनाओं पर कार्य कर सकती है जो हार्नेस प्रदर्शित करता है; जिस सटीक हार्नेस और संस्करण को आप तैनात करते हैं, उस पर अंत-में-बदल और निर्देश व्यवहार का परीक्षण करें। -## Enforcement क्षमता +## प्रवर्तन क्षमता -"Block" का अर्थ है कि वर्तमान adapter का रिटर्न किया गया verdict नामित harness द्वारा consume किया जाता है। Post-tool blocking से परिणाम को मॉडल को दिखाया जाने वाला परिणाम बदला जा सकता है लेकिन एक tool side effect को पूर्ववत नहीं किया जा सकता जो पहले से ही हुआ है। +"ब्लॉक" का मतलब है कि वर्तमान एडेप्टर का रिटर्न किया गया निर्णय नामित हार्नेस द्वारा खपत किया जाता है। पोस्ट-टूल ब्लॉकिंग मॉडल को दिखाया गया परिणाम बदल सकता है लेकिन एक टूल साइड इफेक्ट को पूर्ववत नहीं कर सकता जो पहले से ही घटित हुई हो। -| Harness | सत्यापित blocking events | Observe-only या non-blocking caveats | +| हार्नेस | सत्यापित ब्लॉकिंग घटनाएँ | केवल अवलोकन या गैर-ब्लॉकिंग चेतावनियाँ | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, और कई task/config events | `PostToolUse`, session lifecycle, notifications, और post-failure events observational हैं। | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Post-tool blocking execution के बाद परिणाम को बदलता है; session-start और compact events वर्तमान adapter में observational हैं। | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Post-tool blocking execution के बाद परिणाम को बदलता है; session और notification events observational हैं। | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` और session events observational हैं। | -| OpenCode | `PreToolUse` | Post-tool और lifecycle events observational हैं; वर्तमान stop handling एक सत्यापित gate के बजाय बाद की turn के लिए guidance है। | -| Pi | `PreToolUse`, `UserPromptSubmit` | Post-tool और lifecycle events observational हैं; stop guidance बाद की turn पर लागू होती है। | -| Hermes | `PreToolUse` | Post-tool, session, और subagent-stop verdicts gates नहीं हैं। | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Post-tool, session, subagent-stop, और compaction events observational हैं। | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Post-tool और subagent-stop verdicts observational हैं। | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, conditional `PermissionRequest` | Permission hooks हर permission mode में नहीं चलते; post-tool और session events observational हैं। | -| Antigravity CLI | `PreToolUse`, `Stop` | User-prompt और post-tool verdicts observational हैं; prompt instructions अभी भी inject किए जा सकते हैं। | -| Goose | `PreToolUse` | User-prompt, post-tool, और session events observational हैं। एक native blocking stop hook upstream में मौजूद है लेकिन वर्तमान adapter द्वारा इंस्टॉल नहीं किया गया है। | - -क्षमताएं version-sensitive हैं। Agent CLI को upgrade करने के बाद फिर से परीक्षण करें, विशेष रूप से जब कोई नीति prompt, stop, permission, या post-tool behavior के बजाय common pre-tool gate पर निर्भर हो। - -## कैप्चर और policy hooks इंस्टॉल करें +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, और कई कार्य/कॉन्फ़िग घटनाएँ | `PostToolUse`, सत्र जीवनचक्र, सूचनाएँ, और पोस्ट-विफलता घटनाएँ अवलोकनात्मक हैं। | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | पोस्ट-टूल ब्लॉकिंग निष्पादन के बाद परिणाम को प्रतिस्थापित करता है; सत्र-प्रारंभ और कॉम्पैक्ट घटनाएँ वर्तमान एडेप्टर में अवलोकनात्मक हैं। | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | पोस्ट-टूल ब्लॉकिंग निष्पादन के बाद परिणाम को प्रतिस्थापित करता है; सत्र और सूचना घटनाएँ अवलोकनात्मक हैं। | +| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` और सत्र घटनाएँ अवलोकनात्मक हैं। | +| OpenCode | `PreToolUse` | पोस्ट-टूल और जीवनचक्र घटनाएँ अवलोकनात्मक हैं; वर्तमान स्टॉप हैंडलिंग एक सत्यापित गेट के बजाय बाद के मोड़ के लिए मार्गदर्शन है। | +| Pi | `PreToolUse`, `UserPromptSubmit` | पोस्ट-टूल और जीवनचक्र घटनाएँ अवलोकनात्मक हैं; स्टॉप मार्गदर्शन बाद के मोड़ पर लागू होता है। | +| Hermes | `PreToolUse` | पोस्ट-टूल, सत्र, और सबएजेंट-स्टॉप निर्णय गेट नहीं हैं। | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | पोस्ट-टूल, सत्र, सबएजेंट-स्टॉप, और कॉम्पैक्शन घटनाएँ अवलोकनात्मक हैं। | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | पोस्ट-टूल और सबएजेंट-स्टॉप निर्णय अवलोकनात्मक हैं। | +| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, सशर्त `PermissionRequest` | अनुमति हुक हर अनुमति मोड में नहीं चलते; पोस्ट-टूल और सत्र घटनाएँ अवलोकनात्मक हैं। | +| Antigravity CLI | `PreToolUse`, `Stop` | उपयोगकर्ता-प्रॉम्प्ट और पोस्ट-टूल निर्णय अवलोकनात्मक हैं; प्रॉम्प्ट निर्देश अभी भी इंजेक्ट किए जा सकते हैं। | +| Goose | `PreToolUse` | उपयोगकर्ता-प्रॉम्प्ट, पोस्ट-टूल, और सत्र घटनाएँ अवलोकनात्मक हैं। एक मूल ब्लॉकिंग स्टॉप हुक अपस्ट्रीम में मौजूद है लेकिन वर्तमान एडेप्टर द्वारा स्थापित नहीं है। | + +क्षमताएँ संस्करण-संवेदनशील हैं। एजेंट CLI को अपग्रेड करने के बाद पुनः परीक्षण करें, विशेषकर जब एक नीति प्रॉम्प्ट, स्टॉप, अनुमति, या पोस्ट-टूल व्यवहार पर निर्भर करती है, न कि सामान्य प्री-टूल गेट पर। + +## कैप्चर और नीति हुक स्थापित करें - - 1. **Administration → Keys** खोलें और `events:add` और `policies:pull` के साथ एक key बनाएं, machine या environment के नाम पर। - 2. लक्ष्य machine पर, प्रदर्शित key के साथ स्थानीय CLI को कनेक्ट करें और harness hooks को इंस्टॉल करें। - 3. एक नया agent सेशन शुरू करें, फिर **Observe → Events** के तहत इसके hook और session events की पुष्टि करें। - 4. समान समय window के लिए **Observe → policy** खोलें और पुष्टि करें कि एक policy decision machine को जिम्मेदार ठहराया गया है। + + 1. **प्रशासन → कुंजियाँ** खोलें और `events:add` और `policies:pull` के साथ एक कुंजी बनाएँ, मशीन या वातावरण के लिए नामित। + 2. लक्ष्य मशीन पर, प्रदर्शित कुंजी के साथ स्थानीय CLI को कनेक्ट करें और हार्नेस हुक स्थापित करें। + 3. एक नया एजेंट सत्र शुरू करें, फिर **अवलोकन → घटनाएँ** के तहत इसकी हुक और सत्र घटनाओं की पुष्टि करें। + 4. **अवलोकन → नीति** खोलें एक ही समय विंडो के लिए और पुष्टि करें कि एक नीति निर्णय मशीन को जिम्मेदार है। - कनेक्शन एक machine key के साथ शुरू होता है। इसके secret की प्रतिलिपि बनाने से पहले पुष्टि करें कि इसमें ingestion और policy-delivery दोनों अनुमतियां हैं। + कनेक्शन एक मशीन कुंजी के साथ शुरू होता है। पुष्टि करें कि इसमें अपनी गुप्त को कॉपी करने से पहले इनजेस्ट और नीति-वितरण दोनों अनुमतियाँ शामिल हैं। - ![नई API key drawer जिसका उपयोग event ingestion और policy delivery अनुमतियां प्रदान करने के लिए किया जाता है।](/images/dashboard/key-create.png) + ![नई API कुंजी ड्रॉअर घटना इनजेस्ट और नीति वितरण अनुमतियाँ देने के लिए।](/images/dashboard/key-create.png) - Hooks को इंस्टॉल करने के बाद, Events stream को machine और environment से नई events दिखानी चाहिए जिसे आपने कनेक्ट किया है। + हुक स्थापित करने के बाद, घटनाएँ स्ट्रीम आपके द्वारा कनेक्ट की गई मशीन और वातावरण से नई घटनाएँ दिखाना चाहिए। - ![Live Events stream जिसका उपयोग नई तरह से इंस्टॉल किए गए harness की रिपोर्टिंग की पुष्टि करने के लिए किया जाता है।](/images/dashboard/events-stream.png) + ![लाइव घटनाएँ स्ट्रीम एक नए स्थापित हार्नेस की रिपोर्टिंग की पुष्टि करने के लिए।](/images/dashboard/events-stream.png) - अंत में, सत्यापित करें कि policy decisions उसी machine को जिम्मेदार ठहराए गए हैं। यह पुष्टि करता है कि harness trace events के साथ-साथ policy activity की रिपोर्ट कर रहा है। + अंत में, सत्यापित करें कि नीति निर्णय एक ही मशीन को जिम्मेदार हैं। यह पुष्टि करता है कि हार्नेस ट्रेस घटनाओं के साथ-साथ नीति गतिविधि की रिपोर्ट कर रहा है। - ![Policy page जिसका उपयोग नई तरह से कनेक्ट किए गए harness से policy decisions को सत्यापित करने के लिए किया जाता है।](/images/dashboard/policy-observe.png) + ![नीति पृष्ठ नए कनेक्ट किए गए हार्नेस से नीति निर्णय सत्यापित करने के लिए।](/images/dashboard/policy-observe.png) - हर detect किए गए harness के लिए hooks को इंस्टॉल करें: + प्रत्येक पता लगाए गए हार्नेस के लिए हुक स्थापित करें: ```bash failproofai config \ @@ -67,7 +74,7 @@ Failproof AI Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Herme failproofai policies --install ``` - या नामित harnesses और configuration scope को लक्षित करें: + या नामित हार्नेसेस और कॉन्फ़िगरेशन स्कोप को लक्ष्य करें: ```bash failproofai policies --install \ @@ -75,9 +82,9 @@ Failproof AI Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Herme --scope user ``` - Project scope hook configuration को repository के साथ रखता है। User scope repositories के पार काम को कवर करता है। Claude Code local scope को भी सपोर्ट करता है; support harness के आधार पर भिन्न होता है और CLI unsupported combinations को अस्वीकार करता है। + प्रोजेक्ट स्कोप हुक कॉन्फ़िगरेशन को एक रिपॉजिटरी के साथ रखता है। उपयोगकर्ता स्कोप रिपॉजिटरीज में काम को कवर करता है। Claude Code स्थानीय स्कोप को भी समर्थन करता है; समर्थन हार्नेस द्वारा भिन्न होता है और CLI असमर्थित संयोजनों को अस्वीकार करता है। - Machine और इसके events को verify करें: + मशीन और इसकी घटनाओं को सत्यापित करें: ```bash failproofai config --status @@ -87,16 +94,16 @@ Failproof AI Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Herme -## एक गैर-default सेशन path जोड़ें +## एक गैर-डिफ़ॉल्ट सत्र पथ जोड़ें - - अतिरिक्त paths machine पर register हैं, Cloud में नहीं। एक को add करने के बाद, **Observe → Sessions** खोलें, machine के environment के लिए फ़िल्टर करें, और पुष्टि करें कि नई path से sessions दिखाई देते हैं। एक session खोलें और इसे audit में उपयोग करने पर निर्भर करने से पहले agent, harness, और event timestamps की जांच करें। + + अतिरिक्त पथ मशीन पर पंजीकृत होते हैं, क्लाउड में नहीं। एक जोड़ने के बाद, **अवलोकन → सत्र** खोलें, मशीन के वातावरण के लिए फ़िल्टर करें, और पुष्टि करें कि नए पथ से सत्र प्रदर्शित होते हैं। एक सत्र खोलें और ऑडिट में इस पर भरोसा करने से पहले एजेंट, हार्नेस, और घटना टाइमस्टैम्प की जांच करें। - ![Sessions list जो environment के लिए फ़िल्टर किया गया है जो additional capture path से डेटा प्राप्त कर रहा है।](/images/dashboard/sessions-list.png) + ![सत्र सूची अतिरिक्त कैप्चर पथ से डेटा प्राप्त करने वाले वातावरण के लिए फ़िल्टर की गई।](/images/dashboard/sessions-list.png) - एक optional label के साथ एक path जोड़ें, फिर configured paths को inspect करें: + एक वैकल्पिक लेबल के साथ एक पथ जोड़ें, फिर कॉन्फ़िगर किए गए पथों का निरीक्षण करें: ```bash failproofai harness add-path claude checkout=/srv/checkout/.claude @@ -105,10 +112,10 @@ Failproof AI Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Herme failproofai backfill --since 7d ``` - `failproofai harness remove-path claude checkout` के साथ एक path को हटाएं। + `failproofai harness remove-path claude checkout` के साथ एक पथ हटाएँ। - इंस्टॉलेशन के बाद एक नया सेशन चलाएं। Rollout को expand करने से पहले live event stream और एक actual policy decision दोनों को verify करें। + स्थापना के बाद एक नया सत्र चलाएँ। रोलआउट को विस्तारित करने से पहले लाइव घटना स्ट्रीम और एक वास्तविक नीति निर्णय दोनों को सत्यापित करें। \ No newline at end of file diff --git a/docs/hi/sessions/live-events.mdx b/docs/hi/sessions/live-events.mdx index 5c7fc45e0..2a4e08c0a 100644 --- a/docs/hi/sessions/live-events.mdx +++ b/docs/hi/sessions/live-events.mdx @@ -1,22 +1,21 @@ --- ---- -title: "लाइव इवेंट्स" -description: "सेशन चलते समय एजेंट की गतिविधि को देखें।" +title: "लाइव events" +description: "किसी सत्र के चलते हुए agent activity को देखें।" icon: "radio" --- -लाइव इवेंट्स आपको इंस्ट्रूमेंटेशन की पुष्टि करने और सेशन समाप्त होने का इंतज़ार किए बिना जोखिम भरे रन को देखने में मदद करते हैं। +लाइव events आपको instrumentation की पुष्टि करने और जोखिम भरे run को देखने में मदद करते हैं, बिना सत्र के समाप्त होने का इंतजार किए। -## गतिविधि देखें +## Activity देखें - 1. **Observe → Events** पर जाएँ। - 2. वर्तमान समय विंडो के साथ शुरू करें और पुष्टि करने के लिए कोई फ़िल्टर न लगाएँ कि डेटा आ रहा है। - 3. पर्यावरण, इवेंट प्रकार, एजेंट, या सेशन के आधार पर फ़िल्टर करें। पेलोड टेक्स्ट के लिए सर्च का उपयोग करें। - 4. किसी इवेंट को चुनें और इसके सारांश और विवरण को देखें। पूर्ण ट्रेस के लिए इसके सेशन लिंक का अनुसरण करें। + 1. **Observe → Events** पर जाएं। + 2. वर्तमान समय विंडो के साथ शुरू करें और डेटा आने की पुष्टि करने के लिए कोई फ़िल्टर न रखें। + 3. Environment, event type, agent, या session के आधार पर फ़िल्टर करें। Payload text के लिए search का उपयोग करें। + 4. एक event चुनें इसके सारांश और विवरण को देखने के लिए। पूरी trace के लिए इसके session link को फॉलो करें। - ![समय, पर्यावरण, इवेंट प्रकार, एजेंट, मॉडल, कॉन्टेक्स्ट, सेशन और टेक्स्ट फ़िल्टर के साथ लाइव इवेंट्स स्ट्रीम।](/images/dashboard/events-stream-current.png) + ![लाइव Events stream जो Hermes chat gateway से traffic दिखा रहा है साथ ही coding-CLI runs, समय, environment, event type, agent, model, context, और session के आधार पर फ़िल्टर किए गए।](/images/dashboard/events-stream-current.png) ```bash @@ -25,20 +24,22 @@ icon: "radio" fp --json events --full --session-id --all ``` - डिफ़ॉल्ट फीड कच्चे पेलोड को छोड़ देता है। `--full` का उपयोग केवल सीमित सेशन जाँच के लिए करें। + डिफ़ॉल्ट feed raw payloads को छोड़ देता है। `--full` का उपयोग केवल bounded session investigation के लिए करें। -तीन तत्काल प्रश्नों का उत्तर देने के लिए इवेंट स्ट्रीम का उपयोग करें: +तीन तुरंत सवालों के जवाब देने के लिए event stream का उपयोग करें: -- क्या अपेक्षित एजेंट सही पर्यावरण को रिपोर्ट कर रहा है? -- क्या मॉडल कॉल, टूल कॉल और नीति निर्णय क्रम में आ रहे हैं? -- क्या सेशन ने प्रगति करना बंद कर दिया है या किसी कार्रवाई को दोहराना शुरू कर दिया है? +- क्या अपेक्षित agent सही environment को रिपोर्ट कर रहा है? +- क्या model calls, tool calls, और policy decisions क्रम में आ रहे हैं? +- क्या सत्र प्रगति करना बंद कर गया है या किसी action को दोहराना शुरू कर दिया है? -इवेंट प्रकारों में एजेंट लाइफसाइकिल इवेंट्स, मॉडल अनुरोध और प्रतिक्रियाएँ, टूल उपयोग और परिणाम, हुक निष्पादन, मानव प्रतीक्षा और रुकावटें, और स्पष्ट त्रुटियाँ शामिल हैं। सहसंबंध IDs जोड़ी गई इवेंट्स को जोड़ते हैं जैसे टूल कॉल और इसका परिणाम। +Event types में agent lifecycle events, model requests और responses, tool use और results, hook execution, human waits और interrupts, और explicit errors शामिल हैं। Correlation IDs जोड़ी गई events को जोड़ते हैं जैसे कि एक tool call और इसका result। - किसी नए इंटीग्रेशन को सत्यापित करते समय लाइव दृश्य को व्यापक रखें। पहली इवेंट देखने के बाद ही फ़िल्टर जोड़ें; एक गलत फ़िल्टर विफल इनजेशन जैसा दिख सकता है। + किसी नए integration को सत्यापित करते समय लाइव view को व्यापक रखें। पहले event को देखने के बाद ही फ़िल्टर जोड़ें; एक गलत फ़िल्टर विफल ingestion जैसा दिख सकता है। -यदि कोई इवेंट्स दिखाई न दें, तो `failproofai config --status` चलाएँ, फिर [इनजेशन समस्याओं को समाधान करें](/hi/reference/troubleshooting)। \ No newline at end of file +यदि कोई events दिखाई न दें, तो `failproofai config --status` चलाएं, फिर [troubleshoot ingestion](/hi/reference/troubleshooting)। + +Agents जो 12 समर्थित [harnesses](/hi/reference/harnesses) में से किसी एक में नहीं चलते हैं, [Python SDK](/hi/reference/python-sdk) के माध्यम से एक ही event types रिपोर्ट करते हैं, जिनमें human-in-the-loop events (`human_wait`, `human_input`, `human_interrupt`) शामिल हैं जो gateway और production agents पर निर्भर हैं। \ No newline at end of file diff --git a/docs/hi/sessions/overview.mdx b/docs/hi/sessions/overview.mdx index a05c19a20..013856487 100644 --- a/docs/hi/sessions/overview.mdx +++ b/docs/hi/sessions/overview.mdx @@ -1,27 +1,29 @@ --- -title: "Sessions" -description: "एक agent run का संपूर्ण रिकॉर्ड देखें।" +title: "सेशन" +description: "एक एजेंट रन के संपूर्ण रिकॉर्ड के साथ शुरुआत करें।" icon: "workflow" --- -एक session सबसे अच्छा शुरुआती बिंदु है जब कोई agent अप्रत्याशित रूप से व्यवहार करे। यह मॉडल requests, responses, tool calls, human interactions, errors, evaluations, और policy decisions को जोड़ता है जो एक run से संबंधित हों। +सेशन सबसे अच्छा शुरुआती बिंदु है जब कोई एजेंट अप्रत्याशित रूप से व्यवहार करता है। यह मॉडल अनुरोधों, प्रतिक्रियाओं, टूल कॉल, मानव इंटरैक्शन, त्रुटियों, मूल्यांकन और नीति निर्णयों को जोड़ता है जो एक रन से संबंधित हैं। + +सेशन उसी तरह दिखते हैं भले ही कौन सा हार्नेस उन्हें बनाता है। Claude Code एक रिपॉजिटरी को फिर से लिखता है, Hermes एजेंट Slack में किसी ग्राहक को उत्तर देता है, और SDK के साथ उपकरणीकृत Python सेवा सभी एक ही ट्रेस प्रारूप में आते हैं, इसलिए एक दृश्य पूरे फ्लीट को कवर करता है।
-एक agent run को इसके लक्ष्य से model calls, tools, और अंतिम response के माध्यम से फॉलो करें। +एक एजेंट रन को इसके लक्ष्य से मॉडल कॉल, टूल और अंतिम प्रतिक्रिया तक फॉलो करें। -## एक session खोजें +## सेशन खोजें - - 1. Cloud sidebar में, **Observe → Sessions** पर जाएं। - 2. समय विंडो सेट करें, फिर environment, status, agent, या session ID के आधार पर फ़िल्टर करें। - 3. जब आपको quality, cost, token, या latency slice की आवश्यकता हो तो score या metric ranges जोड़ें। - 4. trace खोलने के लिए एक row चुनें। इसे share करते समय session ID के बगल में copy control का उपयोग करें। + + 1. क्लाउड साइडबार में, **Observe → Sessions** पर जाएं। + 2. समय विंडो सेट करें, फिर पर्यावरण, स्थिति, एजेंट या सेशन ID द्वारा फ़िल्टर करें। + 3. जब आपको गुणवत्ता, लागत, टोकन या विलंबता स्लाइस की आवश्यकता हो तो स्कोर या मेट्रिक रेंज जोड़ें। + 4. इसके ट्रेस को खोलने के लिए एक पंक्ति चुनें। इसे साझा करते समय सेशन ID के बगल में कॉपी नियंत्रण का उपयोग करें। - ![Sessions list जो प्रत्येक run के लिए एक row दिखाता है जिसमें environment, agent, status, और evaluation score filters हैं।](/images/dashboard/sessions-list.png) + ![सेशन सूची जो पर्यावरण, एजेंट, स्थिति और मूल्यांकन स्कोर फ़िल्टर के साथ प्रति रन एक पंक्ति दिखाती है।](/images/dashboard/sessions-list.png) ```bash @@ -30,26 +32,26 @@ icon: "workflow" fp --json sessions --session-id ``` - Multi-agent runs को expand करने के लिए `--agents` जोड़ें, paginate करने के लिए `--all`, या output columns चुनने के लिए `--fields`। + मल्टी-एजेंट रन का विस्तार करने के लिए `--agents` जोड़ें, पेजिनेट करने के लिए `--all` जोड़ें, या आउटपुट कॉलम चुनने के लिए `--fields` जोड़ें। ## आप क्या कर सकते हैं -- एक run को agent, environment, समय, मॉडल, event type, या error state के आधार पर खोजें। -- सटीक sequence को फॉलो करें जिसने एक outcome तैयार किया। -- सफल और असफल runs की तुलना करें। -- Audit finding या alert incident द्वारा उपयोग किए गए evidence को खोलें। -- जब आपको offline record की आवश्यकता हो तो एक session export करें। +- एजेंट, पर्यावरण, समय, मॉडल, इवेंट प्रकार या त्रुटि स्थिति द्वारा एक रन खोजें। +- उस सटीक क्रम का पालन करें जिसने एक परिणाम दिया। +- सफल और विफल रन की तुलना करें। +- ऑडिट खोज या सतर्कता घटना द्वारा उपयोग किए गए साक्ष्य खोलें। +- जब आपको ऑफलाइन रिकॉर्ड की आवश्यकता हो तो एक सेशन निर्यात करें। -## एक विश्वसनीय investigation order +## एक विश्वसनीय जांच क्रम -1. Session goal और environment की पुष्टि करें। -2. पहली error या unexpected decision खोजें—केवल अंतिम विफलता नहीं। -3. मॉडल context और tool input को तुरंत इसके पहले inspect करें। -4. Retries, latency, और human interruptions को check करें। -5. Evaluation scores और policy decisions की समीक्षा करें। +1. सेशन लक्ष्य और पर्यावरण की पुष्टि करें। +2. पहली त्रुटि या अप्रत्याशित निर्णय खोजें—केवल अंतिम विफलता नहीं। +3. इसके तुरंत पहले मॉडल संदर्भ और टूल इनपुट की जांच करें। +4. पुनः प्रयास, विलंबता और मानव हस्तक्षेप की जांच करें। +5. मूल्यांकन स्कोर और नीति निर्णयों की समीक्षा करें। - - Session summary से लेकर उस event तक जाना सीखें जिसने outcome का कारण बना। + + सेशन सारांश से उस इवेंट तक जाने का तरीका जानें जिसके कारण परिणाम हुआ। \ No newline at end of file diff --git a/docs/hi/start/quickstart.mdx b/docs/hi/start/quickstart.mdx index af4bf587b..63dbf210a 100644 --- a/docs/hi/start/quickstart.mdx +++ b/docs/hi/start/quickstart.mdx @@ -1,51 +1,54 @@ --- -title: "Quickstart" -description: "किसी एजेंट सेशन को कैप्चर करें, विफलता खोजें, और इसे रोकना शुरू करें।" +--- +title: "त्वरित शुरुआत" +description: "एक एजेंट सेशन कैप्चर करें, एक विफलता खोजें, और इसे रोकना शुरू करें।" icon: "zap" --- -यह quickstart एक मशीन को सेशन रिपोर्ट करने, ऑडिट चलाने और नीति तैनात करने के लिए सेट अप करता है। Failproof को सेट करने के लिए स्किल का उपयोग करें, या मैनुअल स्टेप्स का पालन करें। आपको Node.js 20.9 या बाद का संस्करण चाहिए। +यह त्वरित शुरुआत एक मशीन को सेशन रिपोर्ट करने, एक ऑडिट चलाने और एक नीति तैनात करने के लिए प्राप्त करती है। Failproof को सेट अप करने के लिए कौशल का उपयोग करें, या मैनुअल चरणों का पालन करें। + +**आपका पथ कौन सा है?** यदि आपका एजेंट 12 समर्थित [harnesses](/hi/reference/harnesses) में से एक में चलता है — एक कोडिंग CLI, या Hermes या OpenClaw जैसा गेटवे — नीचे दिए गए चरणों का पालन करें; आपको Node.js 20.9 या बाद का संस्करण चाहिए। यदि आपके एजेंट के पास कोई harness नहीं है, तो इसे ट्रेसिंग और ऑडिट के लिए [Python SDK](/hi/reference/python-sdk) के साथ instrument करें, फिर [अपनी पहली विफलता जांच चलाएं](/hi/start/first-audit) पर फिर से जुड़ें; उस पथ पर प्रवर्तन के लिए आपके रनटाइम में एक हुक की आवश्यकता है। - + - + ```bash npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - आपका एजेंट प्रोजेक्ट का निरीक्षण करता है, प्रासंगिक इंटीग्रेशन चुनता है, सेटअप करता है, और इसे सत्यापित करता है। व्यक्तिगत स्किल्स और उन्नत इंस्टॉलेशन विकल्पों के लिए [FailproofAI स्किल्स रिपॉजिटरी](https://github.com/FailproofAI/skills) देखें। + आपका एजेंट प्रोजेक्ट का निरीक्षण करता है, प्रासंगिक integration चुनता है, सेटअप निष्पादित करता है और इसे सत्यापित करता है। व्यक्तिगत कौशल और उन्नत स्थापना विकल्पों के लिए [FailproofAI कौशल रिपॉजिटरी](https://github.com/FailproofAI/skills) देखें। ## शुरू करने से पहले -1. [Failproof AI डैशबोर्ड](https://app.befailproof.ai) खोलें और अपने वर्क ईमेल के साथ खाता बनाएं या साइन इन करें। +1. [Failproof AI डैशबोर्ड](https://app.befailproof.ai) खोलें और एक खाता बनाएं या अपने काम के ईमेल से साइन इन करें। 2. **Administration → Keys** पर जाएं और `events:add` और `policies:pull` के साथ एक कुंजी बनाएं। -3. एकबारी सीक्रेट कॉपी करें और इसे टार्गेट मशीन पर स्टोर करें: +3. एकबारी secret की प्रतिलिपि बनाएं और इसे लक्ष्य मशीन पर संग्रहीत करें: ```bash export FAILPROOFAI_KEY="" ``` - ## इंस्टॉल करें + ## स्थापित करें - + ```bash npm install -g failproofai failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - सेशन ट्रांसक्रिप्ट्स डिफॉल्ट रूप से भेजे जाते हैं। ट्रांसक्रिप्ट कंटेंट के बिना हुक एक्टिविटी और नीति निर्णय रिपोर्ट करने के लिए `--no-transcripts` जोड़ें। + सेशन transcripts डिफ़ॉल्ट रूप से भेजे जाते हैं। transcript सामग्री के बिना हुक गतिविधि और नीति निर्णयों की रिपोर्ट करने के लिए `--no-transcripts` जोड़ें। - अगर इस मशीन पर पहले से एजेंट हिस्ट्री है, तो पिछले सात दिनों का प्रीव्यू देखें और इंपोर्ट करें, फिर डिलीवरी समाप्त होने का इंतजार करें। नई मशीन पर इस स्टेप को छोड़ें। + यदि इस मशीन के पास पहले से एजेंट history है, तो पिछले सात दिनों का पूर्वावलोकन और आयात करें, फिर डिलीवरी समाप्त होने का प्रतीक्षा करें। एक नई मशीन पर इस चरण को छोड़ें। ```bash failproofai backfill --since 7d --dry-run @@ -53,27 +56,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - Failproof AI में **Sessions** खोलें और एक इंपोर्ट किए गए सेशन को चुनें। + Failproof AI में **Sessions** खोलें और एक आयातित सेशन चुनें। - - यह Failproof AI को आपके एजेंट CLI से जोड़ता है और बिल्ट-इन नीतियां इंस्टॉल करता है। Failproof AI आपके सेशन्स को ऑडिट करने और आपके एजेंट्स के लिए नीतियां लिखने से पहले उन्हें स्थानीय नीति निर्णय देखने और लागू करने का प्रयास करने के लिए उपयोग करें। + + यह Failproof AI को आपके harness से जोड़ता है और 40 built-in नीतियां स्थापित करता है। उन्हें स्थानीय नीति निर्णय देखने और Failproof AI आपके सेशन का ऑडिट करने और आपके एजेंट के लिए नीतियां लिखने से पहले प्रवर्तन आजमाने के लिए उपयोग करें। - इंस्टॉलर को अपने एजेंट CLI को स्वचालित रूप से डिटेक्ट करने दें, या एक को स्पष्ट रूप से नाम दें। + installer को अपने harness का पता लगाने दें, या एक को स्पष्ट रूप से नाम दें। 12 में से प्रत्येक एक वैध `--cli` मान है — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`। ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # a coding CLI + failproofai policies --install --cli hermes --scope user # a Slack/Telegram gateway ``` + + यह चलाने से पहले एक tool call को ब्लॉक करना सभी 12 पर सत्यापित किया जाता है। Turn-end gates 8 पर सत्यापित हैं — प्रति-harness मैट्रिक्स के लिए [प्रवर्तन क्षमता](/hi/reference/harnesses#enforcement-capability) देखें। - [अपनी पहली विफलता जांच चलाएं](/hi/start/first-audit) का पालन करें। एक ठोस लक्ष्य का उपयोग करें जैसे "सेशन खोजें जहां एजेंट ने अपने दृष्टिकोण को बदले बिना विफल उपकरण को फिर से प्रयास किया।" + [अपनी पहली विफलता जांच चलाएं](/hi/start/first-audit) का पालन करें। एक ठोस लक्ष्य का उपयोग करें जैसे यह खोजना कि सेशन कहां एजेंट ने अपने दृष्टिकोण को बदले बिना एक विफल tool को पुन: प्रयास किया। - [नीति के साथ अपनी पहली विफलता को रोकें](/hi/start/first-policy) का पालन करें। observe मोड में शुरू करें, मिलानों का निरीक्षण करें, फिर समीक्षित संस्करण को लागू करें। + [एक नीति के साथ अपनी पहली विफलता को रोकें](/hi/start/first-policy) का पालन करें। observe मोड में शुरू करें, मिलान का निरीक्षण करें, फिर समीक्षा किए गए संस्करण को लागू करें। - `failproofai config --status` चलाएं। एक स्वस्थ सेटअप क्लाउड कनेक्शन, daemon स्थिति, और क्या लागू करना रोक दिया गया है, यह रिपोर्ट करता है। + `failproofai config --status` चलाएं। एक स्वस्थ सेटअप क्लाउड कनेक्शन, daemon स्थिति और प्रवर्तन रोका गया है या नहीं यह रिपोर्ट करता है। \ No newline at end of file diff --git a/docs/i18n/README.ar.md b/docs/i18n/README.ar.md index 6ed313fc5..cc4e496e6 100644 --- a/docs/i18n/README.ar.md +++ b/docs/i18n/README.ar.md @@ -20,11 +20,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**الترجمات:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**الترجمات:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**حل فشل التشغيل للعملاء الذين يكتبون الأكواد.** -يتصل بـ Claude Code وـ Codex. يقبض على الحلقات والإجراءات الخطرة وتسريب الأسرار -قبل أن تصبح حوادث. بدون تأخير. يعمل محليًا. +**المراقبة والفرض لكل محاولة يشغلها وكلاؤك.** +أينما يعمل وكلاؤك، نحن نراهم — ويمكننا أن نرفضهم. يتصل failproofai بـ 12 محاولة وكيل — واجهات برمجة الترميز مثل Claude Code و Codex، بوابات الدردشة مثل Hermes، المساعدين المستضافين ذاتيًا مثل OpenClaw — ويلتقط كل عملية ويحجب استدعاءات الأدوات الخطرة قبل تنفيذها. 40 سياسة مدمجة. بدون كمون. يعمل محليًا. @@ -34,7 +33,11 @@ --- -## واجهات سطر أوامر الوكيل المدعومة +## المحاولات المدعومة + +اثنا عشر محاولة في فئتين — عشرة واجهات برمجة ترميز، وبوابتين للدردشة والمساعدين (Hermes و OpenClaw). نفس الأحداث، نفس السياسات، نفس سجل الجلسة، أيًا كانت المحاولة التي يعمل فيها وكيلك. + +الوكلاء الذين لا يعملون في أي منها يبلغون من خلال [Python SDK](https://docs.befailproof.ai/reference/python-sdk)، والذي يوفر لك التتبع والجلسات والتدقيق. يتطلب الفرض هناك دخل في وقتك — [تحدث إلينا](mailto:support@befailproof.ai) وسنقوم بتعيينه. {/* 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 @@ -134,32 +137,37 @@ ```sh npm install -g failproofai -failproofai policies --install # أو ما عليك سوى تشغيل `failproofai` وقبول موجه المرة الأولى +failproofai policies --install # أو ما عليك سوى تشغيل `failproofai` وقبول موجه التشغيل الأول failproofai ``` -30 سياسة مدمجة تفعل فوراً. لوحة التحكم على `localhost:8020`. عطّل موجه المرة الأولى باستخدام `FAILPROOFAI_NO_FIRST_RUN=1`. +تنشط 40 سياسة مدمجة فورًا. لوحة معلومات في `localhost:8020`. عطّل موجه التشغيل الأول باستخدام `FAILPROOFAI_NO_FIRST_RUN=1`. --- -## ما الذي يوقفه +## ما يوقفه -| السياسة | ما الذي تمنعه | +| السياسة | ما يحجبه | |---|---| -| `block-push-master` | الدفع المباشر إلى `main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | الالتزامات والدمج والإعادة على `main` / `master` | -| `block-rm-rf` | حذف الملفات بشكل متكرر | -| `sanitize-api-keys` | تسريب مفاتيح API إلى سياق الوكيل | +| `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` | -→ [جميع 30 السياسات المدمجة](https://docs.befailproof.ai/policies/builtin) +ينطبق الخمسة الأولى على أي وكيل يمكنه استدعاء أداة. الثلاثة الأخيرة هي المفضلة لدى المطورين — واجهات برمجة الترميز هي فئة المحاولة التي نغطيها بعمق. + +→ [جميع السياسات المدمجة 40](https://docs.befailproof.ai/policies/builtin) --- -## السياسات الخاصة بك +## سياساتك الخاصة -اسقط ملفًا في `.failproofai/policies/` — يتم تحميله تلقائيًا، لا توجد علامات مطلوبة. -التزم به وستحصل المجموعة بأكملها عليه في الجلب التالي. +أفلت ملف إلى `.failproofai/policies/` — يتم تحميله تلقائيًا، بدون حاجة لأعلام. +تأكد منه والفريق بأكمله يحصل عليه في السحب التالي. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -180,53 +188,75 @@ customPolicies.add({ | القرار | التأثير | |---|---| | `allow()` | السماح بالعملية | -| `deny(message)` | حظرها — تعود الرسالة إلى الوكيل | +| `deny(message)` | حجبها — تعود الرسالة إلى الوكيل | | `instruct(message)` | دعها تمر، لكن أضف سياقًا إلى موجه الوكيل التالي | → [دليل السياسات المخصصة](https://docs.befailproof.ai/policies/custom) --- -## رؤية الجلسة +## المراقبة + +الفرض نصف واحد. النصف الآخر هو رؤية ما فعله الوكيل بالفعل. + +قم بتشغيل `failproofai` بدون حجج وسيعمل لوحة معلومات على `localhost:8020` قراءة سجل التشغيل الموجود بالفعل على جهازك — بدون حساب، بدون تسجيل، لا شيء يغادر الصندوق. تحصل على قائمة الجلسة، والتسلسل من استدعاءات النموذج، واستدعاءات الأدوات وقرارات الخطاف داخل كل عملية، ما تم حجبه وما قالته السياسة للوكيل، وتدقيق غير متصل (`failproofai audit`) الذي يفحص سجلك عن الأنماط الخطرة ويقترح السياسات لإيقافها. + +→ [لوحة المعلومات المحلية](https://docs.befailproof.ai/reference/local-dashboard) · +[قراءة تتبع](https://docs.befailproof.ai/sessions/read-a-trace) · +[التدقيق المحلي](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Observability** هي الجانب المستضاف لنفس نموذج البيانات، للفرق التي تدير الوكلاء عبر أسطول: كل عملية من كل محاولة في مكان واحد، رسم بياني للتنفيذ مع وكلاء فرعيين متوازيين على مساراتهم الخاصة، مدة الكمون p50/p95/p99 للنماذج والأدوات والخطافات، التكلفة لكل نموذج وتتبع نافذة السياق، تتبع الأخطاء، SQL على تتبعاتك الخاصة مع لوحات معلومات قابلة للمشاركة، التقييمات المسجلة بواسطة خدمتك الخاصة، التدقيقات المجدولة التي تحول الفشل المتكرر إلى نتائج مدعومة بالأدلة، والتنبيهات الموجهة إلى Slack أو البريد الإلكتروني أو webhook موقع. يتوفر الاستضافة الذاتية في مجموعتك الخاصة في خطة Enterprise. -يتم تسجيل كل استدعاء أداة يقوم به وكيلك محليًا. تعرض لوحة التحكم ما تم تشغيله، -ما تم حظره، وما أخبرت السياسة الوكيل — لذلك أنت لا تخمن -عندما تسير الأمور بشكل خاطئ. → [دليل لوحة التحكم](https://docs.befailproof.ai/sessions/overview) +→ [الجلسات](https://docs.befailproof.ai/sessions/overview) · +[التدقيقات](https://docs.befailproof.ai/audits/overview) · +[احجز عرضًا توضيحيًا](https://befailproof.ai/get-a-demo) --- ## التوثيق -| | | +| ابدأ | | |---|---| -| [البدء السريع](https://docs.befailproof.ai/start/quickstart) | التثبيت والخطوات الأولى | -| [السياسات المدمجة](https://docs.befailproof.ai/policies/builtin) | جميع 30 السياسات مع المعاملات | +| [البدء السريع](https://docs.befailproof.ai/start/quickstart) | التثبيت، واتصل بمحاولة، واعرض التشغيل الأول | +| [المفاهيم](https://docs.befailproof.ai/start/concepts) | كيف يعمل نظام الخطاف | +| [المحاولات المدعومة](https://docs.befailproof.ai/reference/harnesses) | جميع الـ 12، وما يمكن لكل منها فرضه | + +| لاحظ | | +|---|---| +| [الجلسات](https://docs.befailproof.ai/sessions/overview) | اتبع التشغيل: النماذج، الأدوات، الأخطاء، الكمون | +| [قراءة تتبع](https://docs.befailproof.ai/sessions/read-a-trace) | ما يخبرك به الرسم البياني للتنفيذ | +| [التدقيقات](https://docs.befailproof.ai/audits/overview) | ابحث عن أنماط الفشل عبر العديد من الجلسات | +| [لوحة المعلومات المحلية](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`، بدون حاجة لحساب | + +| فرض | | +|---|---| +| [السياسات المدمجة](https://docs.befailproof.ai/policies/builtin) | جميع السياسات 40 مع المعاملات | | [السياسات المخصصة](https://docs.befailproof.ai/policies/custom) | اكتب الخاصة بك | | [التكوين](https://docs.befailproof.ai/policies/local-configuration) | نطاقات التكوين وقواعد الدمج | -| [لوحة التحكم](https://docs.befailproof.ai/sessions/overview) | مراقب الجلسة ونشاط السياسة | -| [الهندسة المعمارية](https://docs.befailproof.ai/start/concepts) | كيفية عمل نظام الخطافات | + +| أداتك الخاصة بوكيل | | +|---|---| +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | التقرير يعمل من وكيل بدون محاولة | +| [سياسة SDK](https://docs.befailproof.ai/reference/policy-sdk) | `allow` / `deny` / `instruct` مرجع | --- ## الترخيص -MIT مع [Commons Clause](https://commonsclause.com/) — مجاني للاستخدام الداخلي والشخصي؛ لا يجوز إعادة بيع failproofai نفسه بشكل تجاري إلا بموجب اتفاقية منفصلة. انظر [LICENSE](../../LICENSE) للنص الكامل. +MIT مع [Commons Clause](https://commonsclause.com/) — مجاني للاستخدام الداخلي والشخصي؛ يتطلب إعادة البيع التجاري لـ failproofai نفسه اتفاقية منفصلة. انظر [LICENSE](../../LICENSE) للنص الكامل. --- ## المساهمة -انظر [CONTRIBUTING.md](../../CONTRIBUTING.md). نرحب بالسياسات الجديدة وحالات الحدود والترجمات. +انظر [CONTRIBUTING.md](../../CONTRIBUTING.md). السياسات الجديدة والحالات الحدية والترجمات موضع الترحيب. -> **بناء قبل أن تبدأ.** قم بتشغيل `bun install && bun run build` أولاً. يعمل هذا المستودع -> خطافات failproofai الخاصة به على نفسه، وهي تحل استيراد `failproofai` مقابل -> حزمة `dist/` المترجمة — بدون بناء ستواجه خطأ -> `Cannot find package 'failproofai'` خطأ في الخطافات. أعد البناء بعد تغيير `src/`. انظر -> [بناء قبل أن تعمل خطافات التطوير داخل المستودع](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> **ابن قبل أن تبدأ.** قم بتشغيل `bun install && bun run build` أولاً. يشغل هذا المستودع خطافات failproofai الخاصة به على نفسه، وهم يحلون استيراد `failproofai` مقابل حزمة `dist/` المترجمة — بدون بناء ستضرب `Cannot find package 'failproofai'` أخطاء الخطاف. أعد البناء بعد تغيير `src/`. انظر +> [البناء قبل أن تعمل خطافات المطورين داخل المستودع](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- -بُني بـ ❤️ بواسطة [befailproof.ai](https://befailproof.ai) في SF وبنغالور. +مبني بـ ❤️ بواسطة [befailproof.ai](https://befailproof.ai) في SF و Bengaluru. \ No newline at end of file diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md index 05f4d47a5..355183698 100644 --- a/docs/i18n/README.de.md +++ b/docs/i18n/README.de.md @@ -18,11 +18,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**Übersetzungen:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**Übersetzungen:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**Laufzeit-Fehlerauflösung für Coding-Agenten.** -Klinkt sich in Claude Code und Codex ein. Erkennt Endlosschleifen, gefährliche Aktionen und geheime Datenlecks, -bevor sie zu Vorfällen werden. Keine Latenz. Läuft lokal. +**Observability und Durchsetzung für jede Umgebung, in der deine Agents laufen.** +Egal wo deine Agents ausgeführt werden – wir sehen es, und wir können eingreifen. Failproof hooks 12 Agent-Harnesses – Coding-CLIs wie Claude Code und Codex, Chat-Gateways wie Hermes, selbstgehostete Assistenten wie OpenClaw – erfasst jeden Lauf und blockiert gefährliche Tool-Aufrufe, bevor sie ausgeführt werden. 40 eingebaute Policies. Null Latenz. Läuft lokal. @@ -32,7 +31,11 @@ bevor sie zu Vorfällen werden. Keine Latenz. Läuft lokal. --- -## Unterstützte Agenten-CLIs +## Unterstützte Harnesses + +Zwölf Harnesses in zwei Klassen – zehn Coding-CLIs und zwei Chat- und Assistenten-Gateways (Hermes, OpenClaw). Dieselben Events, dieselben Policies, dieselbe Session-Historie – egal in welchem Harness dein Agent läuft. + +Agents, die in keinem davon laufen, berichten über das [Python SDK](https://docs.befailproof.ai/reference/python-sdk), das Tracing, Sessions und Audits bereitstellt. Für die Durchsetzung ist dort ein Hook in deiner eigenen Runtime erforderlich – [sprich uns an](mailto:support@befailproof.ai) und wir finden gemeinsam eine Lösung. {/* 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 @@ -132,32 +135,36 @@ bevor sie zu Vorfällen werden. Keine Latenz. Läuft lokal. ```sh npm install -g failproofai -failproofai policies --install # oder einfach `failproofai` ausführen und den Erststart-Dialog bestätigen +failproofai policies --install # oder einfach `failproofai` ausführen und die Erststart-Aufforderung bestätigen failproofai ``` -30 integrierte Richtlinien werden sofort aktiv. Dashboard unter `localhost:8020`. Den Erststart-Dialog mit `FAILPROOFAI_NO_FIRST_RUN=1` deaktivieren. +40 eingebaute Policies werden sofort aktiviert. Dashboard unter `localhost:8020`. Die Erststart-Aufforderung lässt sich mit `FAILPROOFAI_NO_FIRST_RUN=1` deaktivieren. --- -## Was es verhindert +## Was blockiert wird -| Richtlinie | Was blockiert wird | +| Policy | Was sie blockiert | |---|---| -| `block-push-master` | Direkte Pushes auf `main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | Commits, Merges, Rebases auf `main` / `master` | +| `sanitize-api-keys` | API-Keys, die in den Kontext des Agents gelangen | +| `block-env-files` | Lesezugriffe auf `.env`- und andere Secret-Dateien | +| `warn-repeated-tool-calls` | Endlosschleifen des Agents beim selben Aufruf | +| `block-sudo` | Privilege Escalation | +| `warn-destructive-sql` | `DROP`, `TRUNCATE`, unbegrenzte `DELETE`-Operationen | +| `block-terraform` / `block-kubectl` | Nicht überprüfte Änderungen an Live-Infrastruktur | | `block-rm-rf` | Rekursives Löschen von Dateien | -| `sanitize-api-keys` | API-Schlüssel, die in den Agenten-Kontext gelangen | +| `block-force-push` / `block-push-master` | `git push --force`, direkte Pushes auf `main` | -→ [Alle 30 integrierten Richtlinien](https://docs.befailproof.ai/policies/builtin) +Die ersten fünf gelten für jeden Agent, der Tools aufrufen kann. Die letzten drei sind die Favoriten der Entwickler – Coding-CLIs sind die Harness-Klasse, die wir am tiefsten abdecken. + +→ [Alle 40 eingebauten Policies](https://docs.befailproof.ai/policies/builtin) --- -## Eigene Richtlinien +## Eigene Policies -Eine Datei in `.failproofai/policies/` ablegen — sie wird automatisch geladen, ohne zusätzliche Flags. -Ins Repository einchecken und das gesamte Team erhält sie beim nächsten Pull. +Lege eine Datei in `.failproofai/policies/` ab – sie wird automatisch geladen, ohne Flags. Commit sie ins Repository und das gesamte Team erhält sie beim nächsten Pull. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -173,55 +180,77 @@ customPolicies.add({ }); ``` -Drei Entscheidungen stehen jeder Richtlinie zur Verfügung: +Drei Entscheidungen stehen jeder Policy zur Verfügung: -| Entscheidung | Auswirkung | +| Entscheidung | Wirkung | |---|---| | `allow()` | Operation erlauben | -| `deny(message)` | Blockieren — Nachricht wird an den Agenten zurückgegeben | -| `instruct(message)` | Durchlassen, aber Kontext zum nächsten Prompt des Agenten hinzufügen | +| `deny(message)` | Blockieren – die Nachricht wird an den Agent zurückgegeben | +| `instruct(message)` | Durchlassen, aber Kontext zum nächsten Prompt des Agents hinzufügen | -→ [Anleitung für eigene Richtlinien](https://docs.befailproof.ai/policies/custom) +→ [Leitfaden für eigene Policies](https://docs.befailproof.ai/policies/custom) --- -## Sitzungstransparenz +## Observability + +Durchsetzung ist nur die eine Hälfte. Die andere Hälfte ist zu sehen, was der Agent tatsächlich getan hat. + +Führe `failproofai` ohne Argumente aus und es startet ein Dashboard auf `localhost:8020`, das die bereits auf deinem Rechner gespeicherte Ausführungshistorie auswertet – kein Account, keine Registrierung, nichts verlässt den Rechner. Du siehst die Session-Liste, die Abfolge von Modell-Aufrufen, Tool-Aufrufen und Hook-Entscheidungen innerhalb jedes Laufs, was blockiert wurde und was die Policy dem Agent mitgeteilt hat, sowie ein Offline-Audit (`failproofai audit`), das deine Historie auf riskante Muster scannt und Policies vorschlägt, um diese zu unterbinden. + +→ [Lokales Dashboard](https://docs.befailproof.ai/reference/local-dashboard) · +[Einen Trace lesen](https://docs.befailproof.ai/sessions/read-a-trace) · +[Lokales Audit](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Observability** ist die gehostete Seite desselben Datenmodells, für Teams, die Agents auf einer ganzen Flotte betreiben: jeder Lauf aus jedem Harness an einem Ort, ein Ausführungsgraph mit parallelen Sub-Agents auf eigenen Spuren, p50/p95/p99-Latenz für Modelle, Tools und Hooks, kosten- und Kontextfenster-Tracking pro Modell, Fehler-Tracking, SQL über deine eigenen Traces mit teilbaren Dashboards, Evaluierungen bewertet durch deinen eigenen Dienst, geplante Audits, die wiederkehrende Fehler in belegbare Erkenntnisse umwandeln, sowie Benachrichtigungen über Slack, E-Mail oder einen signierten Webhook. Self-Hosting im eigenen Cluster ist im Enterprise-Plan verfügbar. -Jeder Tool-Aufruf des Agenten wird lokal protokolliert. Das Dashboard zeigt, was ausgeführt wurde, -was blockiert wurde und was die Richtlinie dem Agenten mitgeteilt hat — damit man nicht im Dunkeln tappt, -wenn etwas schiefläuft. → [Dashboard-Anleitung](https://docs.befailproof.ai/sessions/overview) +→ [Sessions](https://docs.befailproof.ai/sessions/overview) · +[Audits](https://docs.befailproof.ai/audits/overview) · +[Demo buchen](https://befailproof.ai/get-a-demo) --- ## Dokumentation -| | | +| Einstieg | | +|---|---| +| [Quickstart](https://docs.befailproof.ai/start/quickstart) | Installieren, Harness verbinden, ersten Lauf sehen | +| [Konzepte](https://docs.befailproof.ai/start/concepts) | Wie das Hook-System funktioniert | +| [Unterstützte Harnesses](https://docs.befailproof.ai/reference/harnesses) | Alle 12, und was jeder einzelne durchsetzen kann | + +| Beobachten | | +|---|---| +| [Sessions](https://docs.befailproof.ai/sessions/overview) | Einen Lauf verfolgen: Modelle, Tools, Fehler, Latenz | +| [Einen Trace lesen](https://docs.befailproof.ai/sessions/read-a-trace) | Was der Ausführungsgraph aussagt | +| [Audits](https://docs.befailproof.ai/audits/overview) | Fehlermuster über viele Sessions hinweg finden | +| [Lokales Dashboard](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, kein Account erforderlich | + +| Durchsetzen | | +|---|---| +| [Eingebaute Policies](https://docs.befailproof.ai/policies/builtin) | Alle 40 Policies mit Parametern | +| [Eigene Policies](https://docs.befailproof.ai/policies/custom) | Eigene schreiben | +| [Konfiguration](https://docs.befailproof.ai/policies/local-configuration) | Konfig-Scopes und Merge-Regeln | + +| Eigenen Agent instrumentieren | | |---|---| -| [Erste Schritte](https://docs.befailproof.ai/start/quickstart) | Installation und erster Einstieg | -| [Integrierte Richtlinien](https://docs.befailproof.ai/policies/builtin) | Alle 30 Richtlinien mit Parametern | -| [Eigene Richtlinien](https://docs.befailproof.ai/policies/custom) | Eigene schreiben | -| [Konfiguration](https://docs.befailproof.ai/policies/local-configuration) | Konfigurationsbereiche und Zusammenführungsregeln | -| [Dashboard](https://docs.befailproof.ai/sessions/overview) | Sitzungsmonitor und Richtlinienaktivität | -| [Architektur](https://docs.befailproof.ai/start/concepts) | Funktionsweise des Hook-Systems | +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | Läufe eines Agents ohne Harness melden | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | Referenz für `allow` / `deny` / `instruct` | --- ## Lizenz -MIT mit [Commons Clause](https://commonsclause.com/) — kostenlos für den internen und privaten Gebrauch; der kommerzielle Weiterverkauf von failproofai selbst erfordert eine separate Vereinbarung. Den vollständigen Text unter [LICENSE](../../LICENSE) nachlesen. +MIT mit [Commons Clause](https://commonsclause.com/) – kostenlos für den internen und privaten Einsatz; der kommerzielle Weiterverkauf von failproofai selbst erfordert eine gesonderte Vereinbarung. Den vollständigen Text findest du in [LICENSE](../../LICENSE). --- ## Mitwirken -Siehe [CONTRIBUTING.md](../../CONTRIBUTING.md). Neue Richtlinien, Randfälle und Übersetzungen sind jederzeit willkommen. +Siehe [CONTRIBUTING.md](../../CONTRIBUTING.md). Neue Policies, Edge Cases und Übersetzungen sind herzlich willkommen. -> **Vor dem Start bauen.** Zuerst `bun install && bun run build` ausführen. Dieses Repository verwendet -> failproofais eigene Hooks auf sich selbst, und diese lösen den `failproofai`-Import gegen das -> kompilierte `dist/`-Bundle auf — ohne einen Build tritt der Hook-Fehler `Cannot find package 'failproofai'` -> auf. Nach Änderungen in `src/` neu bauen. Siehe +> **Vor dem Start bauen.** Führe zuerst `bun install && bun run build` aus. Dieses Repository verwendet failproofais eigene Hooks auf sich selbst, und diese lösen den `failproofai`-Import gegen das kompilierte `dist/`-Bundle auf – ohne einen Build erhältst du `Cannot find package 'failproofai'`-Hook-Fehler. Nach Änderungen an `src/` neu bauen. Siehe > [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- -Mit ❤️ gebaut von [befailproof.ai](https://befailproof.ai) in SF und Bengaluru. +Gebaut mit ❤️ von [befailproof.ai](https://befailproof.ai) in SF und Bengaluru. diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md index 535ee16ac..d22f9edca 100644 --- a/docs/i18n/README.es.md +++ b/docs/i18n/README.es.md @@ -18,11 +18,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**Traducciones:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**Traducciones:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**Resolución de fallos en tiempo de ejecución para agentes de codificación.** -Se integra con Claude Code y Codex. Detecta bucles, acciones peligrosas y filtraciones de secretos -antes de que se conviertan en incidentes. Cero latencia. Se ejecuta localmente. +**Observabilidad y control para cada entorno en el que corren tus agentes.** +Dondequiera que ejecutes tus agentes, nosotros lo vemos — y podemos decir que no. Failproof engancha 12 entornos de agentes — CLIs de codificación como Claude Code y Codex, pasarelas de chat como Hermes, asistentes autoalojados como OpenClaw — capturando cada ejecución y bloqueando llamadas a herramientas peligrosas antes de que se ejecuten. 40 políticas integradas. Cero latencia. Funciona localmente. @@ -32,7 +31,11 @@ antes de que se conviertan en incidentes. Cero latencia. Se ejecuta localmente. --- -## CLIs de agentes compatibles +## Entornos compatibles + +Doce entornos en dos clases — diez CLIs de codificación y dos pasarelas de chat y asistentes (Hermes, OpenClaw). Los mismos eventos, las mismas políticas, el mismo historial de sesiones, sin importar en cuál ejecutes tu agente. + +Los agentes que no corren en ninguno de ellos reportan a través del [SDK de Python](https://docs.befailproof.ai/reference/python-sdk), que ofrece trazas, sesiones y auditorías. Para aplicar controles en esos casos se necesita un hook en tu propio runtime — [contáctanos](mailto:support@befailproof.ai) y lo mapeamos juntos. {/* 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 @@ -136,28 +139,33 @@ failproofai policies --install # o simplemente ejecuta `failproofai` y acepta failproofai ``` -30 políticas integradas se activan de inmediato. Panel de control en `localhost:8020`. Desactiva el aviso de primera ejecución con `FAILPROOFAI_NO_FIRST_RUN=1`. +40 políticas integradas se activan de inmediato. Panel de control en `localhost:8020`. Desactiva el aviso de primera ejecución con `FAILPROOFAI_NO_FIRST_RUN=1`. --- -## Qué detiene +## Qué bloquea | Política | Qué bloquea | |---|---| -| `block-push-master` | Envíos directos a `main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | Commits, merges y rebases en `main` / `master` | -| `block-rm-rf` | Eliminación recursiva de archivos | | `sanitize-api-keys` | Claves de API que se filtran al contexto del agente | +| `block-env-files` | Lecturas de `.env` y otros archivos con secretos | +| `warn-repeated-tool-calls` | El agente en bucle sobre la misma llamada | +| `block-sudo` | Escalada de privilegios | +| `warn-destructive-sql` | `DROP`, `TRUNCATE`, `DELETE` sin condiciones | +| `block-terraform` / `block-kubectl` | Cambios no revisados en infraestructura en producción | +| `block-rm-rf` | Eliminación recursiva de archivos | +| `block-force-push` / `block-push-master` | `git push --force`, pushes directos a `main` | -→ [Las 30 políticas integradas](https://docs.befailproof.ai/policies/builtin) +Las primeras cinco aplican a cualquier agente que pueda invocar una herramienta. Las tres últimas son las favoritas de los desarrolladores — las CLIs de codificación son la clase de entorno que cubrimos con mayor profundidad. + +→ [Las 40 políticas integradas](https://docs.befailproof.ai/policies/builtin) --- ## Tus propias políticas -Coloca un archivo en `.failproofai/policies/` — se carga automáticamente, sin flags necesarios. -Confírmalo y todo el equipo lo obtendrá en el próximo pull. +Coloca un archivo en `.failproofai/policies/` — se carga automáticamente, sin necesidad de flags. +Haz commit y todo el equipo lo recibirá en el próximo pull. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -185,30 +193,55 @@ Tres decisiones disponibles para cada política: --- -## Visibilidad de la sesión +## Observabilidad + +El control es una mitad. La otra mitad es ver qué hizo realmente el agente. + +Ejecuta `failproofai` sin argumentos y levanta un panel de control en `localhost:8020` que lee el historial de ejecuciones ya almacenado en tu máquina — sin cuenta, sin registro, sin que nada salga del equipo. Obtienes la lista de sesiones, la secuencia de llamadas al modelo, las llamadas a herramientas y las decisiones de los hooks dentro de cada ejecución, qué fue bloqueado y qué le dijo la política al agente, además de una auditoría offline (`failproofai audit`) que analiza tu historial en busca de patrones de riesgo y sugiere políticas para detenerlos. + +→ [Panel local](https://docs.befailproof.ai/reference/local-dashboard) · +[Leer una traza](https://docs.befailproof.ai/sessions/read-a-trace) · +[Auditoría local](https://docs.befailproof.ai/audits/local-audit) -Cada llamada a herramienta que realiza tu agente se registra localmente. El panel de control muestra qué se ejecutó, -qué fue bloqueado y qué le indicó la política al agente — para que no tengas que adivinar -cuando algo sale mal. → [Guía del panel de control](https://docs.befailproof.ai/sessions/overview) +**Failproof AI Observability** es la parte alojada del mismo modelo de datos, para equipos que ejecutan agentes en una flota: todas las ejecuciones de todos los entornos en un único lugar, un grafo de ejecución con subagentes paralelos en sus propios carriles, latencia p50/p95/p99 para modelos, herramientas y hooks, seguimiento de costes y ventana de contexto por modelo, seguimiento de errores, SQL sobre tus propias trazas con paneles compartibles, evaluaciones puntuadas por tu propio servicio, auditorías programadas que convierten fallos recurrentes en hallazgos respaldados por evidencia, y alertas enrutadas a Slack, correo electrónico o un webhook firmado. El autoalojamiento en tu propio clúster está disponible en el plan Enterprise. + +→ [Sesiones](https://docs.befailproof.ai/sessions/overview) · +[Auditorías](https://docs.befailproof.ai/audits/overview) · +[Solicitar una demo](https://befailproof.ai/get-a-demo) --- ## Documentación -| | | +| Comenzar | | +|---|---| +| [Inicio rápido](https://docs.befailproof.ai/start/quickstart) | Instala, conecta un entorno y observa la primera ejecución | +| [Conceptos](https://docs.befailproof.ai/start/concepts) | Cómo funciona el sistema de hooks | +| [Entornos compatibles](https://docs.befailproof.ai/reference/harnesses) | Los 12 entornos y qué puede aplicar cada uno | + +| Observar | | |---|---| -| [Primeros pasos](https://docs.befailproof.ai/start/quickstart) | Instalación y primeros pasos | -| [Políticas integradas](https://docs.befailproof.ai/policies/builtin) | Las 30 políticas con sus parámetros | +| [Sesiones](https://docs.befailproof.ai/sessions/overview) | Sigue una ejecución: modelos, herramientas, errores, latencia | +| [Leer una traza](https://docs.befailproof.ai/sessions/read-a-trace) | Qué te dice el grafo de ejecución | +| [Auditorías](https://docs.befailproof.ai/audits/overview) | Encuentra patrones de fallo en múltiples sesiones | +| [Panel local](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, sin necesidad de cuenta | + +| Aplicar controles | | +|---|---| +| [Políticas integradas](https://docs.befailproof.ai/policies/builtin) | Las 40 políticas con sus parámetros | | [Políticas personalizadas](https://docs.befailproof.ai/policies/custom) | Escribe las tuyas propias | | [Configuración](https://docs.befailproof.ai/policies/local-configuration) | Ámbitos de configuración y reglas de fusión | -| [Panel de control](https://docs.befailproof.ai/sessions/overview) | Monitor de sesión y actividad de políticas | -| [Arquitectura](https://docs.befailproof.ai/start/concepts) | Cómo funciona el sistema de hooks | + +| Instrumenta tu propio agente | | +|---|---| +| [SDK de Python](https://docs.befailproof.ai/reference/python-sdk) | Reporta ejecuciones desde un agente sin entorno | +| [SDK de políticas](https://docs.befailproof.ai/reference/policy-sdk) | Referencia de `allow` / `deny` / `instruct` | --- ## Licencia -MIT con [Commons Clause](https://commonsclause.com/) — gratuito para uso interno y personal; la reventa comercial de failproofai en sí requiere un acuerdo por separado. Consulta [LICENSE](../../LICENSE) para el texto completo. +MIT con [Commons Clause](https://commonsclause.com/) — libre para uso interno y personal; la reventa comercial de failproofai en sí requiere un acuerdo aparte. Consulta [LICENSE](../../LICENSE) para el texto completo. --- @@ -216,12 +249,8 @@ MIT con [Commons Clause](https://commonsclause.com/) — gratuito para uso inter Consulta [CONTRIBUTING.md](../../CONTRIBUTING.md). Se aceptan nuevas políticas, casos límite y traducciones. -> **Compila antes de empezar.** Ejecuta `bun install && bun run build` primero. Este repositorio ejecuta -> los propios hooks de failproofai sobre sí mismo, y estos resuelven la importación de `failproofai` contra el -> bundle compilado en `dist/` — sin una compilación obtendrás errores de hook `Cannot find package 'failproofai'`. -> Vuelve a compilar tras modificar `src/`. Consulta -> [Compilar antes de que funcionen los hooks de desarrollo en el repositorio](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> **Compila antes de empezar.** Ejecuta primero `bun install && bun run build`. Este repositorio ejecuta los propios hooks de failproofai sobre sí mismo, y estos resuelven la importación de `failproofai` contra el bundle compilado en `dist/` — sin una compilación previa obtendrás errores de hook `Cannot find package 'failproofai'`. Vuelve a compilar tras modificar `src/`. Consulta [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- -Construido con ❤️ por [befailproof.ai](https://befailproof.ai) en SF y Bengaluru. +Creado con ❤️ por [befailproof.ai](https://befailproof.ai) en SF y Bengaluru. diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md index 8d4a54c04..309ea5575 100644 --- a/docs/i18n/README.fr.md +++ b/docs/i18n/README.fr.md @@ -18,11 +18,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**Traductions :** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**Traductions :** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**Résolution des erreurs d'exécution pour les agents de code.** -S'intègre à Claude Code et Codex. Détecte les boucles, les actions dangereuses et les fuites de secrets -avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local. +**Observabilité et contrôle pour chaque environnement d'exécution de vos agents.** +Où que vos agents s'exécutent, nous le voyons — et nous pouvons dire non. Failproof s'intègre à 12 environnements d'exécution d'agents — des CLI de développement comme Claude Code et Codex, des passerelles de chat comme Hermes, des assistants auto-hébergés comme OpenClaw — en capturant chaque exécution et en bloquant les appels d'outils dangereux avant qu'ils ne s'effectuent. 40 politiques intégrées. Aucune latence. Fonctionne en local. @@ -32,7 +31,11 @@ avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local. --- -## CLI d'agents pris en charge +## Environnements d'exécution pris en charge + +Douze environnements répartis en deux catégories — dix CLI de développement, et deux passerelles de chat et d'assistant (Hermes, OpenClaw). Mêmes événements, mêmes politiques, même historique de session, quel que soit l'environnement dans lequel votre agent s'exécute. + +Les agents qui n'utilisent aucun d'entre eux peuvent remonter leurs données via le [SDK Python](https://docs.befailproof.ai/reference/python-sdk), qui vous offre le traçage, la gestion des sessions et les audits. L'application des politiques dans ce cas nécessite un hook dans votre propre environnement d'exécution — [contactez-nous](mailto:support@befailproof.ai) et nous l'adapterons ensemble. {/* 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 @@ -132,31 +135,36 @@ avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local. ```sh npm install -g failproofai -failproofai policies --install # or just run `failproofai` and accept the first-run prompt +failproofai policies --install # ou lancez simplement `failproofai` et acceptez l'invite au premier démarrage failproofai ``` -30 politiques intégrées s'activent immédiatement. Tableau de bord disponible sur `localhost:8020`. Désactivez l'invite de premier démarrage avec `FAILPROOFAI_NO_FIRST_RUN=1`. +40 politiques intégrées s'activent immédiatement. Tableau de bord disponible sur `localhost:8020`. Désactivez l'invite au premier démarrage avec `FAILPROOFAI_NO_FIRST_RUN=1`. --- -## Ce qu'il bloque +## Ce que ça bloque | Politique | Ce qui est bloqué | |---|---| -| `block-push-master` | Les pushs directs vers `main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | Les commits, merges et rebases sur `main` / `master` | -| `block-rm-rf` | La suppression récursive de fichiers | | `sanitize-api-keys` | Les clés API qui fuient dans le contexte de l'agent | +| `block-env-files` | La lecture des fichiers `.env` et autres fichiers secrets | +| `warn-repeated-tool-calls` | L'agent qui boucle sur le même appel | +| `block-sudo` | L'élévation de privilèges | +| `warn-destructive-sql` | `DROP`, `TRUNCATE`, `DELETE` sans condition | +| `block-terraform` / `block-kubectl` | Les modifications non vérifiées d'une infrastructure en production | +| `block-rm-rf` | La suppression récursive de fichiers | +| `block-force-push` / `block-push-master` | `git push --force`, les push directs vers `main` | -→ [Les 30 politiques intégrées](https://docs.befailproof.ai/policies/builtin) +Les cinq premières s'appliquent à tout agent capable d'appeler un outil. Les trois dernières sont les préférées des développeurs — les CLI de développement sont la catégorie d'environnement que nous couvrons le plus en profondeur. + +→ [Les 40 politiques intégrées](https://docs.befailproof.ai/policies/builtin) --- ## Vos propres politiques -Déposez un fichier dans `.failproofai/policies/` — il est chargé automatiquement, aucun paramètre requis. +Déposez un fichier dans `.failproofai/policies/` — il se charge automatiquement, sans aucun paramètre. Commitez-le et toute l'équipe en bénéficie au prochain pull. ```js @@ -179,49 +187,71 @@ Trois décisions disponibles pour chaque politique : |---|---| | `allow()` | Autoriser l'opération | | `deny(message)` | La bloquer — le message est renvoyé à l'agent | -| `instruct(message)` | La laisser passer, mais ajouter du contexte à la prochaine invite de l'agent | +| `instruct(message)` | La laisser passer, mais ajouter du contexte au prochain prompt de l'agent | → [Guide des politiques personnalisées](https://docs.befailproof.ai/policies/custom) --- -## Visibilité de session +## Observabilité + +L'application des politiques n'est qu'une moitié du tableau. L'autre moitié, c'est de voir ce que l'agent a réellement fait. + +Lancez `failproofai` sans arguments et il sert un tableau de bord sur `localhost:8020` qui lit l'historique des exécutions déjà présent sur votre machine — sans compte, sans inscription, sans rien quitter votre poste. Vous obtenez la liste des sessions, la séquence des appels au modèle, les appels d'outils et les décisions des hooks dans chaque exécution, ce qui a été bloqué et ce que la politique a communiqué à l'agent, ainsi qu'un audit hors ligne (`failproofai audit`) qui analyse votre historique à la recherche de schémas risqués et suggère des politiques pour y remédier. + +→ [Tableau de bord local](https://docs.befailproof.ai/reference/local-dashboard) · +[Lire une trace](https://docs.befailproof.ai/sessions/read-a-trace) · +[Audit local](https://docs.befailproof.ai/audits/local-audit) -Chaque appel d'outil effectué par votre agent est enregistré localement. Le tableau de bord affiche ce qui a été exécuté, -ce qui a été bloqué et ce que la politique a indiqué à l'agent — vous n'avez donc plus à deviner -lorsque quelque chose se passe mal. → [Guide du tableau de bord](https://docs.befailproof.ai/sessions/overview) +**Failproof AI Observability** est la version hébergée du même modèle de données, destinée aux équipes qui exécutent des agents sur une flotte de machines : toutes les exécutions de tous les environnements au même endroit, un graphe d'exécution avec des sous-agents parallèles sur leurs propres voies, la latence p50/p95/p99 pour les modèles, les outils et les hooks, le suivi des coûts et de la fenêtre de contexte par modèle, le suivi des erreurs, des requêtes SQL sur vos propres traces avec des tableaux de bord partageables, des évaluations scorées par votre propre service, des audits planifiés qui transforment les échecs récurrents en constats étayés par des preuves, et des alertes acheminées vers Slack, par e-mail ou via un webhook signé. L'auto-hébergement dans votre propre cluster est disponible dans le plan Enterprise. + +→ [Sessions](https://docs.befailproof.ai/sessions/overview) · +[Audits](https://docs.befailproof.ai/audits/overview) · +[Réserver une démo](https://befailproof.ai/get-a-demo) --- ## Documentation -| | | +| Démarrer | | +|---|---| +| [Démarrage rapide](https://docs.befailproof.ai/start/quickstart) | Installer, connecter un environnement d'exécution, voir la première exécution | +| [Concepts](https://docs.befailproof.ai/start/concepts) | Comment fonctionne le système de hooks | +| [Environnements pris en charge](https://docs.befailproof.ai/reference/harnesses) | Les 12 environnements et ce que chacun peut appliquer | + +| Observer | | |---|---| -| [Démarrage rapide](https://docs.befailproof.ai/start/quickstart) | Installation et premiers pas | -| [Politiques intégrées](https://docs.befailproof.ai/policies/builtin) | Les 30 politiques avec leurs paramètres | +| [Sessions](https://docs.befailproof.ai/sessions/overview) | Suivre une exécution : modèles, outils, erreurs, latence | +| [Lire une trace](https://docs.befailproof.ai/sessions/read-a-trace) | Ce que le graphe d'exécution vous indique | +| [Audits](https://docs.befailproof.ai/audits/overview) | Identifier des schémas d'échec sur de nombreuses sessions | +| [Tableau de bord local](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, sans compte requis | + +| Appliquer des politiques | | +|---|---| +| [Politiques intégrées](https://docs.befailproof.ai/policies/builtin) | Les 40 politiques avec leurs paramètres | | [Politiques personnalisées](https://docs.befailproof.ai/policies/custom) | Écrivez les vôtres | | [Configuration](https://docs.befailproof.ai/policies/local-configuration) | Portées de configuration et règles de fusion | -| [Tableau de bord](https://docs.befailproof.ai/sessions/overview) | Moniteur de session et activité des politiques | -| [Architecture](https://docs.befailproof.ai/start/concepts) | Fonctionnement du système de hooks | + +| Instrumenter votre propre agent | | +|---|---| +| [SDK Python](https://docs.befailproof.ai/reference/python-sdk) | Remonter les exécutions d'un agent sans environnement dédié | +| [SDK de politique](https://docs.befailproof.ai/reference/policy-sdk) | Référence `allow` / `deny` / `instruct` | --- ## Licence -MIT avec [Commons Clause](https://commonsclause.com/) — gratuit pour usage interne et personnel ; la revente commerciale de failproofai lui-même nécessite un accord séparé. Voir [LICENSE](../../LICENSE) pour le texte complet. +MIT avec [Commons Clause](https://commonsclause.com/) — gratuit pour un usage interne et personnel ; la revente commerciale de failproofai lui-même nécessite un accord séparé. Voir [LICENSE](../../LICENSE) pour le texte complet. --- -## Contribution +## Contribuer -Voir [CONTRIBUTING.md](../../CONTRIBUTING.md). Nouvelles politiques, cas limites et traductions sont les bienvenus. +Consultez [CONTRIBUTING.md](../../CONTRIBUTING.md). Les nouvelles politiques, les cas limites et les traductions sont les bienvenus. -> **Compilez avant de commencer.** Exécutez d'abord `bun install && bun run build`. Ce dépôt fait tourner -> ses propres hooks failproofai sur lui-même, et ceux-ci résolvent l'import `failproofai` depuis le -> bundle compilé `dist/` — sans compilation vous obtiendrez l'erreur de hook `Cannot find package 'failproofai'`. -> Recompilez après avoir modifié `src/`. Voir +> **Compilez avant de commencer.** Exécutez d'abord `bun install && bun run build`. Ce dépôt fait tourner ses propres hooks failproofai sur lui-même, et ils résolvent l'import `failproofai` par rapport au bundle compilé `dist/` — sans compilation, vous obtiendrez des erreurs de hook `Cannot find package 'failproofai'`. Recompilez après avoir modifié `src/`. Voir > [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- -Créé avec ❤️ par [befailproof.ai](https://befailproof.ai) à SF et Bengaluru. +Fait avec ❤️ par [befailproof.ai](https://befailproof.ai) à SF et Bengaluru. diff --git a/docs/i18n/README.he.md b/docs/i18n/README.he.md index 25407020d..6c8f9aef7 100644 --- a/docs/i18n/README.he.md +++ b/docs/i18n/README.he.md @@ -20,11 +20,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**תרגומים:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**תרגומים:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**פתרון כשלים בזמן ריצה עבור סוכני קוד.** -מתקשרת ל-Claude Code וקודקס. תופסת לולאות, פעולות מסוכנות, וזליגת סודות -לפני שהם הופכים לתקריות. אפס עיכוב. רץ ברמה המקומית. +**ניהול ותגבור לכל הכלים שהסוכנים שלך פועלים בהם.** +בכל מקום שהסוכנים שלך פועלים, אנחנו רואים זאת — וביכולתנו להגיד לא. Failproof מתחבר ל־12 כלים לסוכנים — ממשקי שורת פקודה לקידוד כמו Claude Code ו־Codex, שערי צ'אט כמו Hermes, עוזרים בעצמם מתארחים כמו OpenClaw — לוכדים כל הרצה וחוסמים קריאות כלים מסוכנות לפני שהן מתבצעות. 40 מדיניויות מובנות. אפס עיכוב. פועל ברמה מקומית. @@ -34,7 +33,11 @@ --- -## CLIs של סוכנים נתמכים +## כלים נתמכים + +שנים עשר כלים בשתי מחלקות — עשרה ממשקי שורת פקודה לקידוד, ושתי שערי צ'אט ועוזרים (Hermes, OpenClaw). אותם אירועים, אותן מדיניויות, אותו היסטוריון הפעלה, בכל אחד מהם שהסוכן פועל בו. + +סוכנים שפועלים ללא קשר לאחד מהם מדווחים דרך ה־[Python SDK](https://docs.befailproof.ai/reference/python-sdk), המספק לך עקיבה, הפעלות וביקורות. הגבור שם דורש וו בסביבת הריצה שלך — [דברו אתנו](mailto:support@befailproof.ai) והנו נמפה זאת. {/* 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 @@ -134,11 +137,11 @@ ```sh npm install -g failproofai -failproofai policies --install # או פשוט הרץ `failproofai` וקבל את ההנחיה בהרצה הראשונה +failproofai policies --install # או פשוט הריצו `failproofai` וקבלו את ההנחיה בהתחלה הראשונה failproofai ``` -30 מדיניויות מובנות מופעלות מיד. לוח בקרה ב-`localhost:8020`. השבת את הנחיית ההרצה הראשונה עם `FAILPROOFAI_NO_FIRST_RUN=1`. +40 מדיניויות מובנות פעילות מיד. לוח תצוגה ב־`localhost:8020`. השבית את הנחיית ההתחלה הראשונה עם `FAILPROOFAI_NO_FIRST_RUN=1`. --- @@ -146,20 +149,25 @@ failproofai | מדיניות | מה היא חוסמת | |---|---| -| `block-push-master` | דחיפות ישירות ל-`main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | התחייבויות, מיזוגים, ריבסים על `main` / `master` | +| `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` | מחיקת קבצים רקורסיבית | -| `sanitize-api-keys` | מפתחות API דוליפים להקשר של סוכן | +| `block-force-push` / `block-push-master` | `git push --force`, דחפות ישירות ל־`main` | -→ [כל 30 המדיניויות המובנות](https://docs.befailproof.ai/policies/builtin) +חמשת הראשונות חלות על כל סוכן שיכול לקרוא כלי. שלוש האחרונות הן המועדפות של המפתחים — ממשקי שורת פקודה לקידוד הם מחלקת הכלים שאנחנו מכסים הכי עמוק. + +→ [כל 40 המדיניויות המובנות](https://docs.befailproof.ai/policies/builtin) --- ## המדיניויות שלך -שים קובץ ב-`.failproofai/policies/` — הוא נטען באופן אוטומטי, לא צריך דגלים. -הקדש אותו וכל הצוות שלך יקבל אותו בבקשת ההמשך הבאה. +זרוק קובץ ל־`.failproofai/policies/` — הוא נטען באופן אוטומטי, ללא צורך בדגלים. +בצע commit וכל הצוות שלך מקבל זאת בעדכון הבא. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -177,56 +185,78 @@ customPolicies.add({ שלוש החלטות זמינות לכל מדיניות: -| החלטה | אפקט | +| החלטה | השפעה | |---|---| -| `allow()` | אישור התהליך | -| `deny(message)` | חסום אותו — ההודעה חוזרת לסוכן | -| `instruct(message)` | תן לו לעבור, אבל הוסף הקשר להנחיה הבאה של הסוכן | +| `allow()` | אפשר את הפעולה | +| `deny(message)` | חסום אותה — ההודעה חוזרת לסוכן | +| `instruct(message)` | תן לזה להעבור, אבל הוסף הקשר להנחיה הבאה של הסוכן | -→ [מדריך מדיניויות מותאמות אישית](https://docs.befailproof.ai/policies/custom) +→ [מדריך מדיניויות מותאם אישית](https://docs.befailproof.ai/policies/custom) --- -## נראות הסשן +## ניהול + +הגבור הוא חצי אחד. החצי השני הוא לראות מה הסוכן בעצם עשה. + +הריצו `failproofai` ללא ארגומנטים והוא משרת לוח תצוגה ב־`localhost:8020` קורא את היסטוריית ההרצה שכבר על המכונה שלך — ללא חשבון, ללא הרשמה, שום דבר לא עוזב את התיבה. אתה מקבל את רשימת ההפעלות, את רצף קריאות המודל, קריאות כלים והחלטות וו בתוך כל הרצה, מה היה חסום ומה אמרה המדיניות לסוכן, וביקורת offline (`failproofai audit`) שסורקת את ההיסטוריה שלך לתבניות מסוכנות ומציעה מדיניויות להפסיק אותן. + +→ [לוח תצוגה מקומי](https://docs.befailproof.ai/reference/local-dashboard) · +[קרא עקיבה](https://docs.befailproof.ai/sessions/read-a-trace) · +[ביקורת מקומית](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Observability** היא הצד המתארח של אותו דגם נתונים, לצוותים המריצים סוכנים על פני צי: כל הרצה מכל כלי במקום אחד, גרף ביצוע עם תת־סוכנים מקבילים בנתיביהם שלהם, עיכוב p50/p95/p99 לדגמים, כלים ווים, עלות לכל דגם ועקיבה של חלון הקשר, עקיבת שגיאות, SQL על העקיבות שלך עם לוחות תצוגה שניתן לשתף, הערכות שנותרו על ידי השירות שלך, ביקורות מתוזמנות שהופכות כשלים חוזרים להוכחות, והתראות המוטות ל־Slack, דוא״ל או webhook חתום. Self-hosting בקלסטר שלך זמין בתוכנית Enterprise. -כל קריאת כלי שהסוכן שלך עושה מתועדת ברמה המקומית. לוח הבקרה מציג מה רץ, -מה חוסם, ומה המדיניות אמרה לסוכן — כך שאתה לא מנחש -כאשר משהו הולך לא בסדר. → [מדריך לוח בקרה](https://docs.befailproof.ai/sessions/overview) +→ [הפעלות](https://docs.befailproof.ai/sessions/overview) · +[ביקורות](https://docs.befailproof.ai/audits/overview) · +[הזמן הדגמה](https://befailproof.ai/get-a-demo) --- ## תיעוד -| | | +| התחלה | | +|---|---| +| [התחלה מהירה](https://docs.befailproof.ai/start/quickstart) | התקנה, חיבור כלי, ראה את ההרצה הראשונה | +| [קונספטים](https://docs.befailproof.ai/start/concepts) | איך מערכת הווים פועלת | +| [כלים נתמכים](https://docs.befailproof.ai/reference/harnesses) | כל 12, ומה כל אחד יכול להטיל | + +| ניהול | | +|---|---| +| [הפעלות](https://docs.befailproof.ai/sessions/overview) | עקוב הרצה: דגמים, כלים, שגיאות, עיכוב | +| [קרא עקיבה](https://docs.befailproof.ai/sessions/read-a-trace) | מה גרף ההביצוע אומר לך | +| [ביקורות](https://docs.befailproof.ai/audits/overview) | חפש תבניות כשל על פני הרבה הפעלות | +| [לוח תצוגה מקומי](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, ללא צורך בחשבון | + +| הטיל | | +|---|---| +| [מדיניויות מובנות](https://docs.befailproof.ai/policies/builtin) | כל 40 המדיניויות עם פרמטרים | +| [מדיניויות מותאם אישית](https://docs.befailproof.ai/policies/custom) | כתוב שלך | +| [קביעת תצורה](https://docs.befailproof.ai/policies/local-configuration) | ההיקפים ותכניות ההתמזגות | + +| תאם את הסוכן שלך | | |---|---| -| [תחילת העבודה](https://docs.befailproof.ai/start/quickstart) | התקנה וצעדים ראשונים | -| [מדיניויות מובנות](https://docs.befailproof.ai/policies/builtin) | כל 30 המדיניויות עם פרמטרים | -| [מדיניויות מותאמות אישית](https://docs.befailproof.ai/policies/custom) | כתוב שלך | -| [תצורה](https://docs.befailproof.ai/policies/local-configuration) | היקפי תצורה וכללי מיזוג | -| [לוח בקרה](https://docs.befailproof.ai/sessions/overview) | מונה סשן ופעילות מדיניות | -| [ארכיטקטורה](https://docs.befailproof.ai/start/concepts) | איך מערכת ההוקים עובדת | +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | דוח הרצות מסוכן ללא כלי | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | `allow` / `deny` / `instruct` התייחסות | --- ## רישיון -MIT עם [Commons Clause](https://commonsclause.com/) — חינם לשימוש פנימי ואישי; מכירה מחדש מסחרית של failproofai עצמו דורשת הסכם נפרד. ראה [LICENSE](../../LICENSE) לטקסט המלא. +MIT עם [Commons Clause](https://commonsclause.com/) — חינם לשימוש פנימי והשכלתי; מכירה מסחרית של failproofai עצמו דורשת הסכם נפרד. ראה [LICENSE](../../LICENSE) לטקסט המלא. --- ## תרומה -ראה [CONTRIBUTING.md](../../CONTRIBUTING.md). מדיניויות חדשות, מקרי קצה, ותרגומים כולם מוזמנים. +ראה [CONTRIBUTING.md](../../CONTRIBUTING.md). מדיניויות חדשות, מקרי קצה, ותרגומים כולם מדורגים. -> **בנה לפני שתתחיל.** הרץ `bun install && bun run build` קודם. מאגר זה מריץ -> את ההוקים של failproofai על עצמו, והם מעבדים את ייבוא `failproofai` כנגד -> חבילת `dist/` המהודרת — ללא בנייה תקבל שגיאות hoock `Cannot find package 'failproofai'`. -> בנה מחדש אחרי שינוי `src/`. ראה -> [בנה לפני שההוקים בין-ריפו יעבדו](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> **בנה לפני שתתחיל.** הרץ `bun install && bun run build` ראשית. מאגר זה מריץ את הווים שלו בעצמו עליו, והם פותרים את ה־import של failproofai כנגד ה־bundle של `dist/` המורכב — ללא בנייה תפגע ב־`Cannot find package 'failproofai'` שגיאות וו. בנה מחדש לאחר שינוי `src/`. ראה +> [בנה לפני שהווים הפיתוח בתוך-מאגר יעבדו](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- -בנוי עם ❤️ על ידי [befailproof.ai](https://befailproof.ai) בסן פרנסיסקו ובנגלור. +בנוי עם ❤️ על ידי [befailproof.ai](https://befailproof.ai) ב־SF וBengaluru. \ No newline at end of file diff --git a/docs/i18n/README.hi.md b/docs/i18n/README.hi.md index ce018fedd..ac0d45c19 100644 --- a/docs/i18n/README.hi.md +++ b/docs/i18n/README.hi.md @@ -18,11 +18,13 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**अनुवाद:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**अनुवाद:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**कोडिंग एजेंट्स के लिए रनटाइम विफलता समाधान।** -Claude Code और Codex में हुक करता है। लूप्स, खतरनाक कार्यों, और सीक्रेट लीक्स को पकड़ता है -इससे पहले कि वे घटनाएं बन जाएं। शून्य विलंबता। स्थानीय रूप से चलता है। +**आपके एजेंट्स द्वारा चलाए जाने वाले हर हार्नेस के लिए दृश्यमानता और प्रवर्तन।** +आपके एजेंट्स जहां भी चलते हैं, हम उन्हें देखते हैं — और हम मना कर सकते हैं। failproofai 12 एजेंट +हार्नेस को हुक करता है — Claude Code और Codex जैसे कोडिंग CLIs, Hermes जैसे चैट गेटवे, +OpenClaw जैसे self-hosted असिस्टेंट — हर रन को कैप्चर करता है और खतरनाक +टूल कॉल्स को निष्पादन से पहले ब्लॉक करता है। 40 बिल्ट-इन नीतियां। शून्य लेटेंसी। स्थानीय रूप से चलता है। @@ -32,7 +34,15 @@ Claude Code और Codex में हुक करता है। लूप् --- -## समर्थित एजेंट CLIs +## समर्थित हार्नेस + +दो वर्गों में बारह हार्नेस — दस कोडिंग CLIs, और दो चैट और असिस्टेंट +गेटवे (Hermes, OpenClaw)। एक ही ईवेंट्स, एक ही नीतियां, एक ही सेशन हिस्ट्री, +चाहे आपका एजेंट किसी में भी चले। + +जो एजेंट्स इनमें से किसी में भी नहीं चलते हैं, वे [Python SDK](https://docs.befailproof.ai/reference/python-sdk) के माध्यम से रिपोर्ट करते हैं, +जो आपको ट्रेसिंग, सेशन और ऑडिट देता है। वहां प्रवर्तन के लिए +आपके अपने रनटाइम में एक हुक की आवश्यकता है — [हमसे संपर्क करें](mailto:support@befailproof.ai) और हम इसे मैप कर देंगे। {/* 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 @@ -132,11 +142,11 @@ Claude Code और Codex में हुक करता है। लूप् ```sh npm install -g failproofai -failproofai policies --install # या सिर्फ `failproofai` चलाएं और पहले-चलाने के प्रॉम्प्ट को स्वीकार करें +failproofai policies --install # या सिर्फ `failproofai` चलाएं और पहली बार के प्रॉम्प्ट को स्वीकार करें failproofai ``` -30 बिल्ट-इन पॉलिसीज तुरंत सक्रिय हो जाती हैं। डैशबोर्ड `localhost:8020` पर है। पहले-चलाने के प्रॉम्प्ट को `FAILPROOFAI_NO_FIRST_RUN=1` के साथ अक्षम करें। +40 बिल्ट-इन नीतियां तुरंत सक्रिय हो जाती हैं। डैशबोर्ड `localhost:8020` पर। `FAILPROOFAI_NO_FIRST_RUN=1` के साथ पहली बार के प्रॉम्प्ट को अक्षम करें। --- @@ -144,20 +154,26 @@ failproofai | नीति | यह क्या ब्लॉक करता है | |---|---| -| `block-push-master` | `main` / `master` पर सीधे पुश करता है | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | `main` / `master` पर कमिट, मर्ज, रीबेस करता है | -| `block-rm-rf` | रिकर्सिव फाइल डिलीशन | -| `sanitize-api-keys` | एजेंट कॉन्टेक्स्ट में API कुंजियां लीक होना | +| `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` में पुश | -→ [सभी 30 बिल्ट-इन पॉलिसीज](https://docs.befailproof.ai/policies/builtin) +पहले पाँच किसी भी एजेंट पर लागू होते हैं जो एक टूल कॉल कर सकता है। अंतिम तीन +डेवलपर के पसंदीदा हैं — कोडिंग CLIs हार्नेस क्लास है जिसे हम सबसे गहराई से कवर करते हैं। + +→ [सभी 40 बिल्ट-इन नीतियां](https://docs.befailproof.ai/policies/builtin) --- -## आपकी अपनी पॉलिसीज +## आपकी अपनी नीतियां -`.failproofai/policies/` में एक फाइल ड्रॉप करें — यह स्वचालित रूप से लोड हो जाती है, कोई फ्लैग की जरूरत नहीं। -इसे कमिट करें और पूरी टीम को अगले पुल पर मिल जाता है। +`.failproofai/policies/` में एक फ़ाइल रखें — यह स्वचालित रूप से लोड हो जाती है, कोई फ्लैग की आवश्यकता नहीं। +इसे कमिट करें और पूरी टीम को अगले पुल में मिल जाएगी। ```js import { customPolicies, deny, allow } from "failproofai"; @@ -173,50 +189,76 @@ customPolicies.add({ }); ``` -हर नीति के लिए तीन निर्णय उपलब्ध हैं: +तीन निर्णय हर नीति के लिए उपलब्ध हैं: | निर्णय | प्रभाव | |---|---| -| `allow()` | ऑपरेशन की अनुमति दें | +| `allow()` | ऑपरेशन को अनुमति दें | | `deny(message)` | इसे ब्लॉक करें — संदेश एजेंट को वापस जाता है | -| `instruct(message)` | इसे के माध्यम से जाने दें, लेकिन एजेंट के अगले प्रॉम्प्ट में कॉन्टेक्स्ट जोड़ें | +| `instruct(message)` | इसे आगे बढ़ने दें, लेकिन एजेंट के अगले प्रॉम्प्ट में संदर्भ जोड़ें | -→ [कस्टम पॉलिसीज गाइड](https://docs.befailproof.ai/policies/custom) +→ [कस्टम नीतियां गाइड](https://docs.befailproof.ai/policies/custom) --- -## सत्र दृश्यमानता +## दृश्यमानता + +प्रवर्तन एक आधा है। दूसरा आधा यह देखना है कि एजेंट ने वास्तव में क्या किया। + +`failproofai` को बिना किसी आर्गुमेंट के चलाएं और यह आपकी मशीन पर पहले से मौजूद रन हिस्ट्री को पढ़ते हुए `localhost:8020` पर एक डैशबोर्ड सर्व करता है — कोई खाता नहीं, कोई साइन अप नहीं, कुछ भी बॉक्स से बाहर नहीं जाता। आपको सेशन सूची, प्रत्येक रन के अंदर मॉडल कॉल्स, टूल कॉल्स और हुक निर्णयों का क्रम, क्या ब्लॉक किया गया और नीति ने एजेंट को क्या बताया, और एक ऑफलाइन ऑडिट (`failproofai audit`) मिलता है जो आपकी हिस्ट्री को जोखिमपूर्ण पैटर्न के लिए स्कैन करता है और उन्हें रोकने के लिए नीतियों का सुझाव देता है। + +→ [स्थानीय डैशबोर्ड](https://docs.befailproof.ai/reference/local-dashboard) · +[एक ट्रेस पढ़ें](https://docs.befailproof.ai/sessions/read-a-trace) · +[स्थानीय ऑडिट](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Observability** एक पूरे फ्लीट में एजेंट्स चलाने वाली टीमों के लिए एक ही डेटा मॉडल का होस्टेड पक्ष है: हर हार्नेस से हर रन एक ही स्थान पर, समानांतर sub-agents अपनी अपनी लेन पर एक एक्सीक्यूशन ग्राफ, मॉडल्स, टूल्स और हुक्स के लिए p50/p95/p99 लेटेंसी, प्रति-मॉडल कॉस्ट और कॉन्टेक्स्ट-विंडो ट्रैकिंग, एरर ट्रैकिंग, आपके अपने ट्रेस पर SQL साझा योग्य डैशबोर्ड के साथ, आपकी अपनी सेवा द्वारा स्कोर किए गए मूल्यांकन, शेड्यूल किए गए ऑडिट जो आवर्ती विफलताओं को साक्ष्य-समर्थित निष्कर्षों में बदलते हैं, और Slack, ईमेल या एक हस्ताक्षरित वेबहुक पर रूट किए गए अलर्ट। Enterprise प्लान पर आपके अपने क्लस्टर में self-hosting उपलब्ध है। -आपका एजेंट जो हर टूल कॉल करता है वह स्थानीय रूप से लॉग किया जाता है। डैशबोर्ड दिखाता है कि क्या चला, -क्या ब्लॉक किया गया, और नीति ने एजेंट को क्या बताया — इसलिए जब कुछ गलत हो जाता है तो आप अनुमान नहीं लगा रहे। -→ [डैशबोर्ड गाइड](https://docs.befailproof.ai/sessions/overview) +→ [सेशन](https://docs.befailproof.ai/sessions/overview) · +[ऑडिट](https://docs.befailproof.ai/audits/overview) · +[डेमो बुक करें](https://befailproof.ai/get-a-demo) --- ## दस्तावेज़ -| | | +| शुरुआत | | |---|---| -| [शुरुआत करना](https://docs.befailproof.ai/start/quickstart) | इंस्टॉलेशन और पहले कदम | -| [बिल्ट-इन पॉलिसीज](https://docs.befailproof.ai/policies/builtin) | सभी 30 पॉलिसीज पैरामीटर के साथ | -| [कस्टम पॉलिसीज](https://docs.befailproof.ai/policies/custom) | अपनी खुद की लिखें | +| [त्वरित प्रारंभ](https://docs.befailproof.ai/start/quickstart) | इंस्टॉल करें, एक हार्नेस कनेक्ट करें, पहला रन देखें | +| [अवधारणाएं](https://docs.befailproof.ai/start/concepts) | हुक सिस्टम कैसे काम करता है | +| [समर्थित हार्नेस](https://docs.befailproof.ai/reference/harnesses) | सभी 12, और प्रत्येक क्या प्रवर्तित कर सकता है | + +| अवलोकन | | +|---|---| +| [सेशन](https://docs.befailproof.ai/sessions/overview) | एक रन का अनुसरण करें: मॉडल्स, टूल्स, एरर, लेटेंसी | +| [एक ट्रेस पढ़ें](https://docs.befailproof.ai/sessions/read-a-trace) | एक्सीक्यूशन ग्राफ आपको क्या बता रहा है | +| [ऑडिट](https://docs.befailproof.ai/audits/overview) | कई सेशन में विफलता पैटर्न खोजें | +| [स्थानीय डैशबोर्ड](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, कोई खाता आवश्यक नहीं | + +| प्रवर्तन | | +|---|---| +| [बिल्ट-इन नीतियां](https://docs.befailproof.ai/policies/builtin) | सभी 40 नीतियां पैरामीटर के साथ | +| [कस्टम नीतियां](https://docs.befailproof.ai/policies/custom) | अपनी खुद की लिखें | | [कॉन्फ़िगरेशन](https://docs.befailproof.ai/policies/local-configuration) | कॉन्फ़िग स्कोप और मर्ज नियम | -| [डैशबोर्ड](https://docs.befailproof.ai/sessions/overview) | सत्र मॉनिटर और नीति गतिविधि | -| [आर्किटेक्चर](https://docs.befailproof.ai/start/concepts) | हुक सिस्टम कैसे काम करता है | + +| अपने एजेंट को इंस्ट्रूमेंट करें | | +|---|---| +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | कोई हार्नेस नहीं वाले एजेंट से रन रिपोर्ट करें | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | `allow` / `deny` / `instruct` संदर्भ | --- ## लाइसेंस -MIT [Commons Clause](https://commonsclause.com/) के साथ — आंतरिक और व्यक्तिगत उपयोग के लिए निःशुल्क; failproofai ही का वाणिज्यिक पुनर्विक्रय एक अलग समझौते की आवश्यकता है। पूरे पाठ के लिए [LICENSE](../../LICENSE) देखें। +MIT with [Commons Clause](https://commonsclause.com/) — आंतरिक और व्यक्तिगत उपयोग के लिए मुक्त; failproofai के वाणिज्यिक पुनर्विक्रय के लिए एक अलग समझौते की आवश्यकता है। पूर्ण पाठ के लिए [LICENSE](../../LICENSE) देखें। --- ## योगदान -[CONTRIBUTING.md](../../CONTRIBUTING.md) देखें। नई पॉलिसीज, एज केसेस, और अनुवाद सभी स्वागत हैं। +[CONTRIBUTING.md](../../CONTRIBUTING.md) देखें। नई नीतियां, edge cases, और अनुवाद सभी स्वागत हैं। -> **शुरू करने से पहले बनाएं।** पहले `bun install && bun run build` चलाएं। यह रेपो failproofai की अपनी हुक्स को अपने पर चलाता है, और वे `failproofai` import को संकलित `dist/` बंडल के विरुद्ध हल करते हैं — बिल्ड के बिना आप `Cannot find package 'failproofai'` हुक त्रुटि से टकराएंगे। `src/` बदलने के बाद फिर से बनाएं। [बिल्ड करें इससे पहले कि रेपो में dev हुक्स काम करेंगे](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)। +> **शुरू करने से पहले बिल्ड करें।** पहले `bun install && bun run build` चलाएं। यह रिपो failproofai की अपनी नीतियों को अपने आप पर चलाता है, और वे `failproofai` आयात को संकलित `dist/` बंडल के विरुद्ध हल करते हैं — बिल्ड के बिना आपको `Cannot find package 'failproofai'` हुक एरर मिलेंगे। `src/` बदलने के बाद पुनः बिल्ड करें। देखें +> [रेपो में dev हुक काम करने से पहले बिल्ड करें](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)। --- diff --git a/docs/i18n/README.it.md b/docs/i18n/README.it.md index 7914b01e2..76e3ef06b 100644 --- a/docs/i18n/README.it.md +++ b/docs/i18n/README.it.md @@ -18,21 +18,28 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**Traduzioni:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**Traduzioni:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**Risoluzione dei guasti di runtime per agenti di codifica.** -Si integra con Claude Code e Codex. Rileva cicli infiniti, azioni pericolose e perdite di segreti -prima che diventino incidenti. Latenza zero. Esecuzione locale. +**Osservabilità e controllo per ogni harness su cui i tuoi agenti vengono eseguiti.** +Ovunque i tuoi agenti vengono eseguiti, noi lo vediamo — e possiamo dire di no. Failproof si aggancia a 12 harness per agenti — CLI di codifica come Claude Code e Codex, gateway di chat come Hermes, assistenti self-hosted come OpenClaw — acquisendo ogni esecuzione e bloccando le chiamate agli strumenti pericolose prima che vengano eseguite. 40 politiche integrate. Zero latenza. Eseguito localmente.

- Failproof AI in action + Failproof AI in azione

--- -## CLI agente supportate +## Harness supportati + +Dodici harness in due categorie — dieci CLI di codifica e due gateway di chat e assistenti +(Hermes, OpenClaw). Gli stessi eventi, le stesse politiche, la stessa cronologia delle sessioni, +indipendentemente da quale harness il tuo agente esegue. + +Gli agenti che non vengono eseguiti in nessuno di questi reportano tramite l'[SDK Python](https://docs.befailproof.ai/reference/python-sdk), +che ti offre tracciamento, sessioni e audit. L'applicazione dei criteri richiede un hook nel +tuo runtime — [contattaci](mailto:support@befailproof.ai) e lo mapperemo. {/* 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 @@ -136,7 +143,7 @@ failproofai policies --install # oppure esegui semplicemente `failproofai` e a failproofai ``` -30 politiche integrate si attivano immediatamente. Dashboard su `localhost:8020`. Disabilita il prompt al primo avvio con `FAILPROOFAI_NO_FIRST_RUN=1`. +40 politiche integrate si attivano immediatamente. Dashboard disponibile su `localhost:8020`. Disabilita il prompt al primo avvio con `FAILPROOFAI_NO_FIRST_RUN=1`. --- @@ -144,20 +151,26 @@ failproofai | Politica | Cosa blocca | |---|---| -| `block-push-master` | Push diretti a `main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | Commit, merge, rebase su `main` / `master` | +| `sanitize-api-keys` | Chiavi API che fuoriescono nel contesto dell'agente | +| `block-env-files` | Letture di `.env` e altri file segreti | +| `warn-repeated-tool-calls` | L'agente che si blocca sulla stessa chiamata | +| `block-sudo` | Escalation di privilegi | +| `warn-destructive-sql` | `DROP`, `TRUNCATE`, `DELETE` illimitati | +| `block-terraform` / `block-kubectl` | Modifiche non revisionate all'infrastruttura live | | `block-rm-rf` | Eliminazione ricorsiva di file | -| `sanitize-api-keys` | Perdita di chiavi API nel contesto dell'agente | +| `block-force-push` / `block-push-master` | `git push --force`, push diretti a `main` | -→ [Tutte le 30 politiche integrate](https://docs.befailproof.ai/policies/builtin) +I primi cinque si applicano a qualsiasi agente che può chiamare uno strumento. Gli ultimi tre sono i preferiti +degli sviluppatori — le CLI di codifica sono la classe di harness che copriamo più a fondo. + +→ [Tutte le 40 politiche integrate](https://docs.befailproof.ai/policies/builtin) --- -## Le tue politiche +## Le tue politiche personalizzate -Deposita un file in `.failproofai/policies/` — carica automaticamente, senza flag necessari. -Esegui il commit e il team intero lo riceve al prossimo pull. +Deposita un file in `.failproofai/policies/` — si carica automaticamente, nessun flag necessario. +Eseguine il commit e l'intero team lo riceverà al prossimo pull. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -167,7 +180,7 @@ customPolicies.add({ match: { events: ["PreToolUse"] }, fn: async (ctx) => { if (ctx.toolInput?.file_path?.includes("production")) - return deny("Writes to production paths are blocked."); + return deny("Le scritture su percorsi di produzione sono bloccate."); return allow(); }, }); @@ -179,48 +192,84 @@ Tre decisioni disponibili per ogni politica: |---|---| | `allow()` | Consenti l'operazione | | `deny(message)` | Bloccala — il messaggio torna all'agente | -| `instruct(message)` | Lasciarla passare, ma aggiungi contesto al prossimo prompt dell'agente | +| `instruct(message)` | Lasciarla passare, ma aggiungere contesto al prossimo prompt dell'agente | → [Guida alle politiche personalizzate](https://docs.befailproof.ai/policies/custom) --- -## Visibilità della sessione +## Osservabilità + +L'applicazione dei criteri è una parte. L'altra parte è vedere cosa ha effettivamente fatto l'agente. + +Esegui `failproofai` senza argomenti e servirà un dashboard su `localhost:8020` +leggendo la cronologia delle esecuzioni già presente sulla tua macchina — nessun account, nessuna iscrizione, nulla +che lascia il box. Ottieni l'elenco delle sessioni, la sequenza di chiamate ai modelli, chiamate agli strumenti +e decisioni degli hook all'interno di ogni esecuzione, cosa è stato bloccato e cosa la politica ha detto +all'agente, e un audit offline (`failproofai audit`) che scansiona la tua cronologia per +modelli rischiosi e suggerisce politiche per fermarli. + +→ [Dashboard locale](https://docs.befailproof.ai/reference/local-dashboard) · +[Leggi una traccia](https://docs.befailproof.ai/sessions/read-a-trace) · +[Audit locale](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Observability** è il lato ospitato dello stesso modello di dati, per i team +che eseguono agenti in un fleet: ogni esecuzione da ogni harness in un unico posto, un +grafico di esecuzione con sub-agenti paralleli su corsie proprie, latenza p50/p95/p99 +per modelli, strumenti e hook, costo per modello e tracciamento della finestra di contesto, tracciamento degli errori, SQL sulle tue tracce +con dashboard condivisibili, valutazioni valutate dal tuo servizio, audit programmati che trasformano i fallimenti +ricorrenti in risultati supportati da prove, e avvisi instradati a Slack, email o un webhook firmato. L'auto-hosting nel tuo +cluster è disponibile nel piano Enterprise. -Ogni chiamata di strumento che il tuo agente esegue viene registrata localmente. La dashboard mostra cosa è stato eseguito, -cosa è stato bloccato e cosa la politica ha detto all'agente — quindi non stai indovinando -quando qualcosa va storto. → [Guida alla dashboard](https://docs.befailproof.ai/sessions/overview) +→ [Sessioni](https://docs.befailproof.ai/sessions/overview) · +[Audit](https://docs.befailproof.ai/audits/overview) · +[Prenota una demo](https://befailproof.ai/get-a-demo) --- ## Documentazione -| | | +| Inizia | | |---|---| -| [Introduzione](https://docs.befailproof.ai/start/quickstart) | Installazione e primi passi | -| [Politiche integrate](https://docs.befailproof.ai/policies/builtin) | Tutte le 30 politiche con parametri | +| [Quickstart](https://docs.befailproof.ai/start/quickstart) | Installa, connetti un harness, vedi la prima esecuzione | +| [Concetti](https://docs.befailproof.ai/start/concepts) | Come funziona il sistema di hook | +| [Harness supportati](https://docs.befailproof.ai/reference/harnesses) | Tutti i 12 e cosa ciascuno può applicare | + +| Osserva | | +|---|---| +| [Sessioni](https://docs.befailproof.ai/sessions/overview) | Segui un'esecuzione: modelli, strumenti, errori, latenza | +| [Leggi una traccia](https://docs.befailproof.ai/sessions/read-a-trace) | Cosa ti sta dicendo il grafico di esecuzione | +| [Audit](https://docs.befailproof.ai/audits/overview) | Trova modelli di fallimento in molte sessioni | +| [Dashboard locale](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, nessun account necessario | + +| Applica | | +|---|---| +| [Politiche integrate](https://docs.befailproof.ai/policies/builtin) | Tutte le 40 politiche con parametri | | [Politiche personalizzate](https://docs.befailproof.ai/policies/custom) | Scrivi le tue | -| [Configurazione](https://docs.befailproof.ai/policies/local-configuration) | Ambiti di configurazione e regole di unione | -| [Dashboard](https://docs.befailproof.ai/sessions/overview) | Monitoraggio sessione e attività politica | -| [Architettura](https://docs.befailproof.ai/start/concepts) | Come funziona il sistema di hook | +| [Configurazione](https://docs.befailproof.ai/policies/local-configuration) | Ambiti di configurazione e regole di merge | + +| Strumenta il tuo agente | | +|---|---| +| [SDK Python](https://docs.befailproof.ai/reference/python-sdk) | Riporta esecuzioni da un agente senza harness | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | Riferimento `allow` / `deny` / `instruct` | --- ## Licenza -MIT con [Commons Clause](https://commonsclause.com/) — gratuito per uso interno e personale; la rivendita commerciale di failproofai stesso richiede un accordo separato. Vedi [LICENSE](../../LICENSE) per il testo completo. +MIT con [Commons Clause](https://commonsclause.com/) — gratuito per uso interno e personale; la rivendita commerciale di failproofai richiede un accordo separato. Vedi [LICENSE](../../LICENSE) per il testo completo. --- ## Contribuire -Vedi [CONTRIBUTING.md](../../CONTRIBUTING.md). Nuove politiche, casi limite e traduzioni sono tutti benvenuti. +Vedi [CONTRIBUTING.md](../../CONTRIBUTING.md). Nuove politiche, casi edge e traduzioni sono tutti benvenuti. -> **Compila prima di iniziare.** Esegui `bun install && bun run build` prima. Questo repository esegue +> **Compila prima di iniziare.** Esegui `bun install && bun run build` per primo. Questo repository esegue > i propri hook di failproofai su se stesso, e risolvono l'importazione di `failproofai` rispetto al -> bundle compilato in `dist/` — senza una compilazione otterrai errori di hook `Cannot find package 'failproofai'`. +> bundle compilato `dist/` — senza una build otterrai errori di hook `Cannot find package 'failproofai'`. > Ricompila dopo aver modificato `src/`. Vedi -> [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> [Compila prima che gli hook di sviluppo in-repo funzionino](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.ja.md b/docs/i18n/README.ja.md index 302b8eb13..748fc4d9e 100644 --- a/docs/i18n/README.ja.md +++ b/docs/i18n/README.ja.md @@ -18,11 +18,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**翻訳:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**翻訳:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**コーディングエージェントのランタイム障害を解決する。** -Claude Code や Codex にフックし、ループ・危険な操作・シークレット漏洩を -インシデントになる前に検知します。レイテンシーゼロ。ローカルで動作。 +**エージェントが動くあらゆるハーネスに対応した可観測性と制御。** +エージェントがどこで動いていても、Failproofはすべてを把握し、必要であれば止めます。12のエージェントハーネスにフックし、Claude Code や Codex などのコーディング CLI、Hermes などのチャットゲートウェイ、OpenClaw などのセルフホスト型アシスタントに対応。すべての実行を記録し、危険なツール呼び出しを実行前にブロックします。組み込みポリシー40件。レイテンシーゼロ。ローカルで動作。 @@ -32,7 +31,11 @@ Claude Code や Codex にフックし、ループ・危険な操作・シーク --- -## 対応エージェント CLI +## 対応ハーネス + +2カテゴリ12ハーネス — コーディング CLI が10種、チャット・アシスタントゲートウェイ（Hermes、OpenClaw）が2種。エージェントがどのハーネスで動いていても、同一のイベント・ポリシー・セッション履歴が使えます。 + +これらのハーネスをどれも使用しないエージェントは [Python SDK](https://docs.befailproof.ai/reference/python-sdk) 経由でレポートできます。トレーシング・セッション・監査機能を利用可能です。その環境でのエンフォースメントには独自ランタイムへのフック設置が必要です — [お問い合わせ](mailto:support@befailproof.ai)いただければ対応方法をご案内します。 {/* 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 @@ -132,32 +135,36 @@ Claude Code や Codex にフックし、ループ・危険な操作・シーク ```sh npm install -g failproofai -failproofai policies --install # または `failproofai` を実行して初回起動時のプロンプトに従う +failproofai policies --install # または `failproofai` を実行して初回プロンプトに承諾 failproofai ``` -30個の組み込みポリシーが即座に有効になります。ダッシュボードは `localhost:8020` で確認できます。`FAILPROOFAI_NO_FIRST_RUN=1` を設定すると初回起動プロンプトを無効化できます。 +40件の組み込みポリシーが即座に有効化されます。ダッシュボードは `localhost:8020` で確認できます。`FAILPROOFAI_NO_FIRST_RUN=1` を設定すると初回プロンプトを無効化できます。 --- -## 防止できること +## ブロックできるもの -| ポリシー | ブロックする操作 | +| ポリシー | ブロック内容 | |---|---| -| `block-push-master` | `main` / `master` への直接プッシュ | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | `main` / `master` へのコミット・マージ・リベース | +| `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` | 再帰的なファイル削除 | -| `sanitize-api-keys` | エージェントのコンテキストへの API キー漏洩 | +| `block-force-push` / `block-push-master` | `git push --force`、`main` への直接プッシュ | -→ [組み込みポリシー一覧（30件）](https://docs.befailproof.ai/policies/builtin) +最初の5件はツール呼び出し可能なすべてのエージェントに適用されます。残りの3件は開発者に特に人気があり、コーディング CLI はもっとも深くカバーしているハーネスクラスです。 + +→ [組み込みポリシー全40件](https://docs.befailproof.ai/policies/builtin) --- -## カスタムポリシー +## 独自ポリシー -`.failproofai/policies/` にファイルを置くだけで自動的に読み込まれます。フラグ不要です。 -コミットすれば、次回プル時にチーム全員に適用されます。 +`.failproofai/policies/` にファイルを置くだけで自動的に読み込まれます。フラグ不要。コミットすれば、次の pull でチーム全員に反映されます。 ```js import { customPolicies, deny, allow } from "failproofai"; @@ -173,9 +180,9 @@ customPolicies.add({ }); ``` -各ポリシーで使用できる判定は3種類です： +すべてのポリシーで使用できる3つの判定: -| 判定 | 動作 | +| 判定 | 効果 | |---|---| | `allow()` | 操作を許可する | | `deny(message)` | ブロックする — メッセージがエージェントに返される | @@ -185,37 +192,64 @@ customPolicies.add({ --- -## セッションの可視化 +## 可観測性 + +エンフォースメントは機能の半分です。もう半分は、エージェントが実際に何をしたかを把握することです。 + +`failproofai` を引数なしで実行すると、`localhost:8020` にダッシュボードが起動し、マシン上の実行履歴を読み込みます — アカウント不要、サインアップ不要、データは外部に送信されません。セッション一覧、モデル呼び出しのシーケンス、各実行内のツール呼び出しとフック判定、ブロックされた内容とポリシーがエージェントに伝えた内容、そしてオフライン監査（`failproofai audit`）で履歴をスキャンしてリスクのあるパターンを検出し、対策ポリシーを提案します。 + +→ [ローカルダッシュボード](https://docs.befailproof.ai/reference/local-dashboard) · +[トレースの読み方](https://docs.befailproof.ai/sessions/read-a-trace) · +[ローカル監査](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Observability** は同じデータモデルのホスト型サービスです。複数環境でエージェントを運用するチーム向けに、すべてのハーネスからのすべての実行を一元管理できます。並列サブエージェントを独立レーンで表示する実行グラフ、モデル・ツール・フックの p50/p95/p99 レイテンシー、モデルごとのコストとコンテキストウィンドウの追跡、エラートラッキング、共有可能なダッシュボード付きのトレース SQL クエリ、独自サービスによるスコアリング評価、繰り返し発生する失敗をエビデンスベースの知見に変えるスケジュール監査、Slack・メール・署名付き Webhook へのアラート通知。自社クラスターへのセルフホスティングはエンタープライズプランで利用可能です。 -エージェントが行ったすべてのツール呼び出しはローカルに記録されます。ダッシュボードでは実行内容・ブロックされた内容・ポリシーがエージェントに伝えた内容を確認できるため、問題が発生したときに推測で対処する必要がありません。→ [ダッシュボードガイド](https://docs.befailproof.ai/sessions/overview) +→ [セッション](https://docs.befailproof.ai/sessions/overview) · +[監査](https://docs.befailproof.ai/audits/overview) · +[デモを予約する](https://befailproof.ai/get-a-demo) --- ## ドキュメント -| | | +| 始め方 | | |---|---| -| [はじめに](https://docs.befailproof.ai/start/quickstart) | インストールと最初のステップ | -| [組み込みポリシー](https://docs.befailproof.ai/policies/builtin) | パラメーター付き全30ポリシー | -| [カスタムポリシー](https://docs.befailproof.ai/policies/custom) | 独自ポリシーの作成方法 | +| [クイックスタート](https://docs.befailproof.ai/start/quickstart) | インストール、ハーネスの接続、最初の実行を確認 | +| [コンセプト](https://docs.befailproof.ai/start/concepts) | フックシステムの仕組み | +| [対応ハーネス](https://docs.befailproof.ai/reference/harnesses) | 全12種とそれぞれのエンフォースメント内容 | + +| 可観測性 | | +|---|---| +| [セッション](https://docs.befailproof.ai/sessions/overview) | 実行を追う: モデル、ツール、エラー、レイテンシー | +| [トレースの読み方](https://docs.befailproof.ai/sessions/read-a-trace) | 実行グラフが示す情報 | +| [監査](https://docs.befailproof.ai/audits/overview) | 多数のセッションにわたる失敗パターンを発見 | +| [ローカルダッシュボード](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`、アカウント不要 | + +| エンフォースメント | | +|---|---| +| [組み込みポリシー](https://docs.befailproof.ai/policies/builtin) | パラメータ付き全40ポリシー | +| [カスタムポリシー](https://docs.befailproof.ai/policies/custom) | 独自ポリシーの作成 | | [設定](https://docs.befailproof.ai/policies/local-configuration) | 設定スコープとマージルール | -| [ダッシュボード](https://docs.befailproof.ai/sessions/overview) | セッションモニターとポリシーアクティビティ | -| [アーキテクチャ](https://docs.befailproof.ai/start/concepts) | フックシステムの仕組み | + +| 独自エージェントのインストルメント | | +|---|---| +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | ハーネスなしのエージェントから実行をレポート | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | `allow` / `deny` / `instruct` リファレンス | --- ## ライセンス -MIT に [Commons Clause](https://commonsclause.com/) を付加したライセンスです — 社内利用・個人利用は無償で可能ですが、failproofai 自体の商用再販には別途契約が必要です。全文は [LICENSE](../../LICENSE) をご覧ください。 +MIT に [Commons Clause](https://commonsclause.com/) を付加したライセンス — 社内利用・個人利用は無償。failproofai 自体の商業的な再販には別途契約が必要です。全文は [LICENSE](../../LICENSE) をご覧ください。 --- -## コントリビューション +## コントリビュート -[CONTRIBUTING.md](../../CONTRIBUTING.md) をご覧ください。新しいポリシー、エッジケースへの対応、翻訳はいずれも歓迎します。 +[CONTRIBUTING.md](../../CONTRIBUTING.md) をご参照ください。新しいポリシー、エッジケースへの対応、翻訳はいずれも歓迎します。 -> **作業前にビルドを実行してください。** まず `bun install && bun run build` を実行してください。このリポジトリは自身のフックを自分自身に適用しており、`failproofai` のインポートはコンパイル済みの `dist/` バンドルに対して解決されます。ビルドなしでは `Cannot find package 'failproofai'` というフックエラーが発生します。`src/` を変更した後は再ビルドしてください。詳細は [リポジトリ内の開発用フックを動作させるためのビルド手順](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work) を参照してください。 +> **作業を始める前にビルドしてください。** まず `bun install && bun run build` を実行してください。このリポジトリは failproofai 自身のフックを自分自身に対して適用しており、フックはコンパイル済みの `dist/` バンドルに対して `failproofai` インポートを解決します。ビルドなしで実行すると `Cannot find package 'failproofai'` というフックエラーが発生します。`src/` を変更した後は必ず再ビルドしてください。詳細は [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work) をご参照ください。 --- -❤️ を込めて、[befailproof.ai](https://befailproof.ai) がサンフランシスコとベンガルールで開発。 +[befailproof.ai](https://befailproof.ai) チームが SF とベンガルールから ❤️ を込めて開発。 diff --git a/docs/i18n/README.ko.md b/docs/i18n/README.ko.md index 44ebdcac5..7064258aa 100644 --- a/docs/i18n/README.ko.md +++ b/docs/i18n/README.ko.md @@ -8,7 +8,7 @@ failproof ai -FailproofAI%2Ffailproofai | Trendshift +FailproofAI%2Ffailproofai | Trendshift [![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai) [![CI](https://img.shields.io/github/actions/workflow/status/failproofai/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/failproofai/failproofai/actions) @@ -18,11 +18,13 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**번역:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**번역:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**코딩 에이전트를 위한 런타임 장애 해결.** -Claude Code 및 Codex에 연결됩니다. 루프, 위험한 작업, 시크릿 유출을 -인시던트가 되기 전에 차단합니다. 지연 없음. 로컬에서 실행. +**에이전트가 실행되는 모든 하네스에 대한 가시성 확보 및 정책 집행.** +에이전트가 어디서 실행되든 우리는 모든 것을 보고, 필요하면 차단합니다. Failproof는 12개의 에이전트 +하네스에 훅을 걸어 — Claude Code, Codex 같은 코딩 CLI, Hermes 같은 채팅 게이트웨이, +OpenClaw 같은 자체 호스팅 어시스턴트 — 모든 실행을 캡처하고 위험한 툴 호출이 +실행되기 전에 차단합니다. 내장 정책 40개. 레이턴시 제로. 로컬 실행. @@ -32,7 +34,11 @@ Claude Code 및 Codex에 연결됩니다. 루프, 위험한 작업, 시크릿 --- -## 지원하는 에이전트 CLI +## 지원 하네스 + +두 가지 분류의 12개 하네스 — 코딩 CLI 10개, 채팅·어시스턴트 게이트웨이 2개(Hermes, OpenClaw). 어떤 하네스에서 에이전트가 실행되든 동일한 이벤트, 동일한 정책, 동일한 세션 기록이 적용됩니다. + +이 중 어느 하네스도 사용하지 않는 에이전트는 [Python SDK](https://docs.befailproof.ai/reference/python-sdk)를 통해 보고할 수 있으며, 트레이싱·세션·감사 기능을 제공합니다. 해당 환경에서의 정책 집행은 런타임에 훅을 직접 추가해야 합니다 — [문의하시면](mailto:support@befailproof.ai) 함께 방법을 찾아드립니다. {/* 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 @@ -132,32 +138,38 @@ Claude Code 및 Codex에 연결됩니다. 루프, 위험한 작업, 시크릿 ```sh npm install -g failproofai -failproofai policies --install # 또는 `failproofai`를 실행하고 최초 실행 프롬프트에서 수락 +failproofai policies --install # 또는 `failproofai`를 실행하고 첫 실행 프롬프트에서 수락 failproofai ``` -30개의 기본 제공 정책이 즉시 활성화됩니다. 대시보드는 `localhost:8020`에서 확인할 수 있습니다. `FAILPROOFAI_NO_FIRST_RUN=1`로 최초 실행 프롬프트를 비활성화할 수 있습니다. +내장 정책 40개가 즉시 활성화됩니다. 대시보드는 `localhost:8020`에서 확인하세요. `FAILPROOFAI_NO_FIRST_RUN=1`로 첫 실행 프롬프트를 비활성화할 수 있습니다. --- -## 차단 항목 +## 차단 목록 | 정책 | 차단 대상 | |---|---| -| `block-push-master` | `main` / `master`에 직접 푸시 | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | `main` / `master`에 커밋, 머지, 리베이스 | -| `block-rm-rf` | 재귀적 파일 삭제 | | `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` 브랜치 직접 푸시 | -→ [30개 기본 제공 정책 전체 보기](https://docs.befailproof.ai/policies/builtin) +처음 다섯 가지는 툴을 호출할 수 있는 모든 에이전트에 적용됩니다. 나머지 세 가지는 +개발자들이 가장 선호하는 정책으로, 코딩 CLI는 우리가 가장 깊이 지원하는 하네스 분류입니다. + +→ [내장 정책 40개 전체 목록](https://docs.befailproof.ai/policies/builtin) --- ## 커스텀 정책 -`.failproofai/policies/` 폴더에 파일을 넣으면 자동으로 로드됩니다. 별도의 플래그가 필요 없습니다. -커밋하면 팀 전체가 다음 풀 시 적용됩니다. +`.failproofai/policies/` 디렉터리에 파일을 넣으면 별도 플래그 없이 자동으로 로드됩니다. +커밋하면 팀 전체가 다음 pull 시 적용받습니다. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -173,55 +185,83 @@ customPolicies.add({ }); ``` -모든 정책에서 사용 가능한 세 가지 결정: +모든 정책에서 사용할 수 있는 세 가지 결정: | 결정 | 효과 | |---|---| | `allow()` | 작업 허용 | | `deny(message)` | 차단 — 메시지가 에이전트에게 반환됨 | -| `instruct(message)` | 통과 허용, 단 에이전트의 다음 프롬프트에 컨텍스트 추가 | +| `instruct(message)` | 통과시키되, 에이전트의 다음 프롬프트에 컨텍스트 추가 | → [커스텀 정책 가이드](https://docs.befailproof.ai/policies/custom) --- -## 세션 가시성 +## 가시성 + +정책 집행은 절반입니다. 나머지 절반은 에이전트가 실제로 무엇을 했는지 확인하는 것입니다. + +인수 없이 `failproofai`를 실행하면 `localhost:8020`에 대시보드가 열리며, +이미 머신에 저장된 실행 기록을 불러옵니다 — 계정 불필요, 회원가입 불필요, 데이터가 외부로 나가지 않습니다. +세션 목록, 각 실행 내의 모델 호출·툴 호출·훅 결정 순서, 차단된 내용과 정책이 에이전트에 전달한 내용, +그리고 히스토리에서 위험 패턴을 스캔하고 해당 패턴을 막을 정책을 제안하는 오프라인 감사(`failproofai audit`)를 제공합니다. + +→ [로컬 대시보드](https://docs.befailproof.ai/reference/local-dashboard) · +[트레이스 읽기](https://docs.befailproof.ai/sessions/read-a-trace) · +[로컬 감사](https://docs.befailproof.ai/audits/local-audit) -에이전트가 수행하는 모든 도구 호출은 로컬에 기록됩니다. 대시보드에서는 실행된 항목, -차단된 항목, 정책이 에이전트에게 전달한 내용을 확인할 수 있어 — 문제가 발생했을 때 -추측할 필요가 없습니다. → [대시보드 가이드](https://docs.befailproof.ai/sessions/overview) +**Failproof AI Observability**는 동일한 데이터 모델의 호스팅 버전으로, 플릿 전체에서 에이전트를 운영하는 팀을 위한 서비스입니다: 모든 하네스의 모든 실행을 한 곳에서 확인, 독립 레인에서 병렬 서브에이전트를 보여주는 실행 그래프, 모델·툴·훅의 p50/p95/p99 레이턴시, 모델별 비용 및 컨텍스트 윈도우 트래킹, 에러 트래킹, 공유 가능한 대시보드와 함께 자체 트레이스에 대한 SQL 쿼리, 자체 서비스로 평가하는 이밸류에이션, 반복적인 실패를 근거 기반 발견으로 전환하는 정기 감사, Slack·이메일·서명된 웹훅으로 라우팅되는 알림. 자체 클러스터에서의 셀프호스팅은 Enterprise 플랜에서 이용 가능합니다. + +→ [세션](https://docs.befailproof.ai/sessions/overview) · +[감사](https://docs.befailproof.ai/audits/overview) · +[데모 예약](https://befailproof.ai/get-a-demo) --- ## 문서 -| | | +| 시작하기 | | +|---|---| +| [빠른 시작](https://docs.befailproof.ai/start/quickstart) | 설치, 하네스 연결, 첫 번째 실행 확인 | +| [개념](https://docs.befailproof.ai/start/concepts) | 훅 시스템의 동작 방식 | +| [지원 하네스](https://docs.befailproof.ai/reference/harnesses) | 12개 전체 목록 및 각각의 집행 가능 범위 | + +| 관찰 | | |---|---| -| [시작하기](https://docs.befailproof.ai/start/quickstart) | 설치 및 첫 번째 단계 | -| [기본 제공 정책](https://docs.befailproof.ai/policies/builtin) | 파라미터를 포함한 30개 정책 전체 | +| [세션](https://docs.befailproof.ai/sessions/overview) | 실행 추적: 모델, 툴, 에러, 레이턴시 | +| [트레이스 읽기](https://docs.befailproof.ai/sessions/read-a-trace) | 실행 그래프가 전달하는 정보 | +| [감사](https://docs.befailproof.ai/audits/overview) | 여러 세션에 걸친 실패 패턴 탐지 | +| [로컬 대시보드](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, 계정 불필요 | + +| 집행 | | +|---|---| +| [내장 정책](https://docs.befailproof.ai/policies/builtin) | 파라미터 포함 40개 정책 전체 | | [커스텀 정책](https://docs.befailproof.ai/policies/custom) | 직접 작성하기 | | [설정](https://docs.befailproof.ai/policies/local-configuration) | 설정 범위 및 병합 규칙 | -| [대시보드](https://docs.befailproof.ai/sessions/overview) | 세션 모니터 및 정책 활동 | -| [아키텍처](https://docs.befailproof.ai/start/concepts) | 훅 시스템 동작 방식 | + +| 직접 에이전트 계측 | | +|---|---| +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | 하네스 없이 에이전트에서 실행 보고 | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | `allow` / `deny` / `instruct` 레퍼런스 | --- ## 라이선스 -MIT with [Commons Clause](https://commonsclause.com/) — 내부 및 개인 사용은 무료이며, failproofai 자체의 상업적 재판매는 별도 계약이 필요합니다. 전문은 [LICENSE](../../LICENSE)를 참조하세요. +[Commons Clause](https://commonsclause.com/)가 포함된 MIT — 내부 및 개인 사용은 무료이며, failproofai 자체의 상업적 재판매는 별도 계약이 필요합니다. 전문은 [LICENSE](../../LICENSE)를 참고하세요. --- ## 기여 -[CONTRIBUTING.md](../../CONTRIBUTING.md)를 참조하세요. 새로운 정책, 엣지 케이스, 번역 모두 환영합니다. +[CONTRIBUTING.md](../../CONTRIBUTING.md)를 참고하세요. 새로운 정책, 엣지 케이스, 번역 모두 환영합니다. -> **시작 전에 빌드하세요.** 먼저 `bun install && bun run build`를 실행하세요. 이 저장소는 -> failproofai 자체 훅을 자신에게 적용하며, `failproofai` 임포트를 컴파일된 `dist/` 번들에 대해 -> 해석합니다 — 빌드 없이는 `Cannot find package 'failproofai'` 훅 오류가 발생합니다. -> `src/`를 변경한 후에는 다시 빌드하세요. 자세한 내용은 -> [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)를 참조하세요. +> **시작 전에 먼저 빌드하세요.** `bun install && bun run build`를 먼저 실행하세요. 이 저장소는 +> failproofai의 훅을 자신에게 적용하며, 컴파일된 `dist/` 번들을 기준으로 `failproofai` 임포트를 +> 해석합니다 — 빌드 없이는 `Cannot find package 'failproofai'` 훅 에러가 발생합니다. +> `src/`를 수정한 후에는 다시 빌드하세요. 자세한 내용은 +> [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)를 참고하세요. --- -SF와 벵갈루루에서 ❤️로 만든 [befailproof.ai](https://befailproof.ai). +SF와 벵갈루루에서 ❤️를 담아 [befailproof.ai](https://befailproof.ai)가 만들었습니다. diff --git a/docs/i18n/README.pt-br.md b/docs/i18n/README.pt-br.md index 5e5f1823f..842c67216 100644 --- a/docs/i18n/README.pt-br.md +++ b/docs/i18n/README.pt-br.md @@ -18,11 +18,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**Traduções:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**Traduções:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**Resolução de falhas em tempo de execução para agentes de codificação.** -Integra-se ao Claude Code e ao Codex. Detecta loops, ações perigosas e vazamentos de segredos -antes que se tornem incidentes. Zero latência. Executa localmente. +**Observabilidade e controle para todos os ambientes em que seus agentes rodam.** +Onde quer que seus agentes executem, nós enxergamos — e podemos dizer não. O Failproof conecta-se a 12 ambientes de agentes — CLIs de programação como Claude Code e Codex, gateways de chat como Hermes, assistentes auto-hospedados como OpenClaw — capturando cada execução e bloqueando chamadas de ferramentas perigosas antes que aconteçam. 40 políticas integradas. Latência zero. Roda localmente. @@ -32,7 +31,11 @@ antes que se tornem incidentes. Zero latência. Executa localmente. --- -## CLIs de agentes suportados +## Ambientes suportados + +Doze ambientes em duas categorias — dez CLIs de programação, e dois gateways de chat e assistentes (Hermes, OpenClaw). Mesmos eventos, mesmas políticas, mesmo histórico de sessões, independentemente de qual o seu agente utilize. + +Agentes que não rodam em nenhum deles reportam pelo [Python SDK](https://docs.befailproof.ai/reference/python-sdk), que oferece rastreamento, sessões e auditorias. O controle nesses casos exige um hook no seu próprio runtime — [fale conosco](mailto:support@befailproof.ai) e mapeamos juntos. {/* 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 @@ -132,11 +135,11 @@ antes que se tornem incidentes. Zero latência. Executa localmente. ```sh npm install -g failproofai -failproofai policies --install # ou simplesmente execute `failproofai` e aceite o prompt da primeira execução +failproofai policies --install # ou apenas execute `failproofai` e aceite o prompt inicial failproofai ``` -30 políticas integradas são ativadas imediatamente. Dashboard disponível em `localhost:8020`. Desative o prompt da primeira execução com `FAILPROOFAI_NO_FIRST_RUN=1`. +40 políticas integradas são ativadas imediatamente. Dashboard em `localhost:8020`. Desative o prompt inicial com `FAILPROOFAI_NO_FIRST_RUN=1`. --- @@ -144,20 +147,24 @@ failproofai | Política | O que bloqueia | |---|---| -| `block-push-master` | Pushes diretos para `main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | Commits, merges e rebases em `main` / `master` | -| `block-rm-rf` | Exclusão recursiva de arquivos | | `sanitize-api-keys` | Vazamento de chaves de API no contexto do agente | +| `block-env-files` | Leitura de arquivos `.env` e outros arquivos de segredos | +| `warn-repeated-tool-calls` | O agente em loop na mesma chamada | +| `block-sudo` | Escalada de privilégios | +| `warn-destructive-sql` | `DROP`, `TRUNCATE`, `DELETE` sem cláusula WHERE | +| `block-terraform` / `block-kubectl` | Alterações não revisadas em infraestrutura em produção | +| `block-rm-rf` | Exclusão recursiva de arquivos | +| `block-force-push` / `block-push-master` | `git push --force`, pushes diretos para `main` | -→ [Todas as 30 políticas integradas](https://docs.befailproof.ai/policies/builtin) +As cinco primeiras se aplicam a qualquer agente que possa chamar uma ferramenta. As três últimas são as favoritas dos desenvolvedores — as CLIs de programação são a categoria de ambiente que cobrimos com mais profundidade. + +→ [Todas as 40 políticas integradas](https://docs.befailproof.ai/policies/builtin) --- ## Suas próprias políticas -Coloque um arquivo em `.failproofai/policies/` — ele é carregado automaticamente, sem necessidade de flags. -Faça o commit e toda a equipe recebe na próxima atualização. +Coloque um arquivo em `.failproofai/policies/` — ele é carregado automaticamente, sem nenhuma flag necessária. Faça commit e toda a equipe receberá na próxima atualização. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -178,48 +185,70 @@ Três decisões disponíveis para cada política: | Decisão | Efeito | |---|---| | `allow()` | Permite a operação | -| `deny(message)` | Bloqueia — a mensagem é retornada ao agente | +| `deny(message)` | Bloqueia — a mensagem é enviada de volta ao agente | | `instruct(message)` | Deixa passar, mas adiciona contexto ao próximo prompt do agente | → [Guia de políticas personalizadas](https://docs.befailproof.ai/policies/custom) --- -## Visibilidade da sessão +## Observabilidade + +O controle é uma metade. A outra metade é enxergar o que o agente realmente fez. + +Execute `failproofai` sem argumentos e ele serve um dashboard em `localhost:8020` lendo o histórico de execuções já presente na sua máquina — sem conta, sem cadastro, nada sai da máquina. Você tem a lista de sessões, a sequência de chamadas ao modelo, chamadas de ferramentas e decisões de hook em cada execução, o que foi bloqueado e o que a política informou ao agente, além de uma auditoria offline (`failproofai audit`) que examina seu histórico em busca de padrões arriscados e sugere políticas para contê-los. + +→ [Dashboard local](https://docs.befailproof.ai/reference/local-dashboard) · +[Lendo um trace](https://docs.befailproof.ai/sessions/read-a-trace) · +[Auditoria local](https://docs.befailproof.ai/audits/local-audit) -Cada chamada de ferramenta feita pelo seu agente é registrada localmente. O dashboard mostra o que foi executado, -o que foi bloqueado e o que a política comunicou ao agente — para que você não fique no escuro -quando algo der errado. → [Guia do Dashboard](https://docs.befailproof.ai/sessions/overview) +**Failproof AI Observability** é a versão hospedada do mesmo modelo de dados, para equipes que rodam agentes em múltiplas máquinas: todas as execuções de todos os ambientes em um só lugar, um grafo de execução com sub-agentes paralelos em suas próprias raias, latência p50/p95/p99 para modelos, ferramentas e hooks, rastreamento de custo e janela de contexto por modelo, rastreamento de erros, SQL sobre seus próprios traces com dashboards compartilháveis, avaliações pontuadas pelo seu próprio serviço, auditorias agendadas que transformam falhas recorrentes em descobertas baseadas em evidências, e alertas roteados para Slack, e-mail ou um webhook assinado. Auto-hospedagem no seu próprio cluster está disponível no plano Enterprise. + +→ [Sessões](https://docs.befailproof.ai/sessions/overview) · +[Auditorias](https://docs.befailproof.ai/audits/overview) · +[Agendar uma demo](https://befailproof.ai/get-a-demo) --- ## Documentação -| | | +| Início | | +|---|---| +| [Quickstart](https://docs.befailproof.ai/start/quickstart) | Instale, conecte um ambiente, veja a primeira execução | +| [Conceitos](https://docs.befailproof.ai/start/concepts) | Como o sistema de hooks funciona | +| [Ambientes suportados](https://docs.befailproof.ai/reference/harnesses) | Todos os 12, e o que cada um pode controlar | + +| Observar | | |---|---| -| [Primeiros Passos](https://docs.befailproof.ai/start/quickstart) | Instalação e passos iniciais | -| [Políticas Integradas](https://docs.befailproof.ai/policies/builtin) | Todas as 30 políticas com parâmetros | -| [Políticas Personalizadas](https://docs.befailproof.ai/policies/custom) | Escreva as suas próprias | +| [Sessões](https://docs.befailproof.ai/sessions/overview) | Acompanhe uma execução: modelos, ferramentas, erros, latência | +| [Lendo um trace](https://docs.befailproof.ai/sessions/read-a-trace) | O que o grafo de execução está indicando | +| [Auditorias](https://docs.befailproof.ai/audits/overview) | Encontre padrões de falha em várias sessões | +| [Dashboard local](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, sem conta necessária | + +| Controlar | | +|---|---| +| [Políticas integradas](https://docs.befailproof.ai/policies/builtin) | Todas as 40 políticas com parâmetros | +| [Políticas personalizadas](https://docs.befailproof.ai/policies/custom) | Escreva as suas próprias | | [Configuração](https://docs.befailproof.ai/policies/local-configuration) | Escopos de configuração e regras de mesclagem | -| [Dashboard](https://docs.befailproof.ai/sessions/overview) | Monitor de sessão e atividade de políticas | -| [Arquitetura](https://docs.befailproof.ai/start/concepts) | Como o sistema de hooks funciona | + +| Instrumentar seu próprio agente | | +|---|---| +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | Reporte execuções de um agente sem ambiente definido | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | Referência de `allow` / `deny` / `instruct` | --- ## Licença -MIT com [Commons Clause](https://commonsclause.com/) — gratuito para uso interno e pessoal; a revenda comercial do próprio failproofai requer um acordo separado. Consulte [LICENSE](../../LICENSE) para o texto completo. +MIT com [Commons Clause](https://commonsclause.com/) — gratuito para uso interno e pessoal; a revenda comercial do failproofai em si exige um acordo separado. Veja o [LICENSE](../../LICENSE) para o texto completo. --- ## Contribuindo -Consulte [CONTRIBUTING.md](../../CONTRIBUTING.md). Novas políticas, casos extremos e traduções são bem-vindos. +Veja [CONTRIBUTING.md](../../CONTRIBUTING.md). Novas políticas, casos extremos e traduções são bem-vindos. -> **Faça o build antes de começar.** Execute `bun install && bun run build` primeiro. Este repositório executa -> os próprios hooks do failproofai sobre si mesmo, e eles resolvem o import `failproofai` contra o -> bundle compilado em `dist/` — sem um build você terá erros de hook `Cannot find package 'failproofai'`. -> Refaça o build após alterar `src/`. Consulte +> **Faça o build antes de começar.** Execute `bun install && bun run build` primeiro. Este repositório roda os próprios hooks do failproofai sobre si mesmo, e eles resolvem o import `failproofai` contra o bundle compilado em `dist/` — sem um build você encontrará erros de hook com `Cannot find package 'failproofai'`. Refaça o build após alterar `src/`. Veja > [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.ru.md b/docs/i18n/README.ru.md index 030ec2d67..c02709e02 100644 --- a/docs/i18n/README.ru.md +++ b/docs/i18n/README.ru.md @@ -18,21 +18,25 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**Переводы:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**Переводы:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**Разрешение ошибок во время выполнения для кодирующих агентов.** -Интегрируется с Claude Code и Codex. Перехватывает зацикливания, опасные действия и утечки секретов -до того, как они станут инцидентами. Нулевая задержка. Работает локально. +**Наблюдаемость и управление для каждой системы, в которой работают ваши агенты.** +Где бы ни работал ваш агент — мы это видим и можем это запретить. Failproof AI интегрируется с 12 платформами для работы с агентами — средствами разработки кода, такими как Claude Code и Codex, шлюзами чата, такими как Hermes, и самостоятельно развёрнутыми помощниками, такими как OpenClaw — перехватывая каждый запуск и блокируя опасные вызовы инструментов перед их выполнением. 40 встроенных политик. Нулевая задержка. Работает локально.

- Failproof AI in action + Failproof AI в действии

--- -## Поддерживаемые CLI агентов +## Поддерживаемые платформы + +Двенадцать платформ в двух классах — десять средств разработки кода и два шлюза чата и помощников (Hermes, OpenClaw). Одинаковые события, одинаковые политики, одинаковая история сессий, в какой бы платформе ни работал ваш агент. + +Агенты, которые работают ни в одной из них, отправляют данные через [Python SDK](https://docs.befailproof.ai/reference/python-sdk), +что даёт вам трассировку, сессии и аудит. Управление там требует хука в вашей собственной среде выполнения — [напишите нам](mailto:support@befailproof.ai) и мы это реализуем. {/* 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 @@ -132,32 +136,37 @@ ```sh npm install -g failproofai -failproofai policies --install # или просто запустите `failproofai` и подтвердите приглашение при первом запуске +failproofai policies --install # или просто запустите `failproofai` и подтвердите первичный запрос failproofai ``` -30 встроенных политик активируются немедленно. Панель управления доступна по адресу `localhost:8020`. Отключите приглашение при первом запуске с помощью `FAILPROOFAI_NO_FIRST_RUN=1`. +40 встроенных политик активируются немедленно. Панель управления доступна на `localhost:8020`. Отключите первичный запрос с помощью `FAILPROOFAI_NO_FIRST_RUN=1`. --- -## Что блокируется +## Что это блокирует -| Политика | Что блокируется | +| Политика | Что она блокирует | |---|---| -| `block-push-master` | Прямые отправки в `main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | Коммиты, слияния, перебазирования на `main` / `master` | +| `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` | Рекурсивное удаление файлов | -| `sanitize-api-keys` | Утечки ключей API в контекст агента | +| `block-force-push` / `block-push-master` | `git push --force`, прямые пушы в `main` | -→ [Все 30 встроенных политик](https://docs.befailproof.ai/policies/builtin) +Первые пять применяются к любому агенту, который может вызывать инструменты. Последние три — фавориты разработчиков — средства разработки кода являются классом платформ, который мы покрываем наиболее глубоко. + +→ [Все 40 встроенных политик](https://docs.befailproof.ai/policies/builtin) --- -## Собственные политики +## Ваши собственные политики -Поместите файл в `.failproofai/policies/` — он загружается автоматически без необходимости флагов. -Зафиксируйте его, и вся команда получит его при следующем pull. +Разместите файл в `.failproofai/policies/` — он загружается автоматически без каких-либо флагов. +Добавьте его в репозиторий и вся команда получит его при следующем пуле. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -178,31 +187,58 @@ customPolicies.add({ | Решение | Эффект | |---|---| | `allow()` | Разрешить операцию | -| `deny(message)` | Заблокировать — сообщение отправляется обратно агенту | -| `instruct(message)` | Пропустить, но добавить контекст в следующий запрос агента | +| `deny(message)` | Заблокировать её — сообщение вернётся агенту | +| `instruct(message)` | Разрешить, но добавить контекст в следующий запрос агента | → [Руководство по пользовательским политикам](https://docs.befailproof.ai/policies/custom) --- -## Видимость сеанса +## Наблюдаемость + +Управление — это одна половина. Другая половина — видеть то, что на самом деле сделал агент. + +Запустите `failproofai` без аргументов, и он будет обслуживать панель управления на `localhost:8020`, +читая историю запусков, уже находящуюся на вашей машине — без учётной записи, без регистрации, ничего не покидает вашу систему. Вы получите список сессий, последовательность вызовов модели, вызовы инструментов и решения хуков внутри каждого запуска, что было заблокировано и что политика сказала агенту, а также автономный аудит (`failproofai audit`), который сканирует вашу историю на предмет рискованных паттернов и предлагает политики для их остановки. + +→ [Локальная панель управления](https://docs.befailproof.ai/reference/local-dashboard) · +[Чтение трассировки](https://docs.befailproof.ai/sessions/read-a-trace) · +[Локальный аудит](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Observability** — это хостированная часть одной и той же модели данных для команд, +запускающих агентов на множестве систем: каждый запуск от каждой платформы в одном месте, граф выполнения с параллельными подагентами на отдельных дорожках, задержка p50/p95/p99 для моделей, инструментов и хуков, стоимость и отслеживание окна контекста для каждой модели, отслеживание ошибок, SQL над вашими собственными трассировками с общедоступными панелями управления, оценки, отмеченные вашим собственным сервисом, запланированные аудиты, которые превращают повторяющиеся сбои в доказательства, и оповещения, направленные в Slack, по электронной почте или на подписанный вебхук. Самостоятельное хостирование в вашем собственном кластере доступно в плане Enterprise. -Каждый вызов инструмента, который делает ваш агент, регистрируется локально. Панель управления показывает, что запускалось, -что было заблокировано и что политика сообщила агенту — так что вы не гадаете, -когда что-то идёт не так. → [Руководство по панели управления](https://docs.befailproof.ai/sessions/overview) +→ [Сессии](https://docs.befailproof.ai/sessions/overview) · +[Аудиты](https://docs.befailproof.ai/audits/overview) · +[Запросить демонстрацию](https://befailproof.ai/get-a-demo) --- ## Документация -| | | +| Начало | | |---|---| -| [Начало работы](https://docs.befailproof.ai/start/quickstart) | Установка и первые шаги | -| [Встроенные политики](https://docs.befailproof.ai/policies/builtin) | Все 30 политик с параметрами | +| [Быстрый старт](https://docs.befailproof.ai/start/quickstart) | Установка, подключение платформы, первый запуск | +| [Концепции](https://docs.befailproof.ai/start/concepts) | Как работает система хуков | +| [Поддерживаемые платформы](https://docs.befailproof.ai/reference/harnesses) | Все 12 и то, что каждая может управлять | + +| Наблюдение | | +|---|---| +| [Сессии](https://docs.befailproof.ai/sessions/overview) | Следите за запуском: модели, инструменты, ошибки, задержка | +| [Чтение трассировки](https://docs.befailproof.ai/sessions/read-a-trace) | Что вам говорит граф выполнения | +| [Аудиты](https://docs.befailproof.ai/audits/overview) | Найдите паттерны сбоев в множестве сессий | +| [Локальная панель управления](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, без необходимости учётной записи | + +| Управление | | +|---|---| +| [Встроенные политики](https://docs.befailproof.ai/policies/builtin) | Все 40 политик с параметрами | | [Пользовательские политики](https://docs.befailproof.ai/policies/custom) | Напишите свои собственные | -| [Конфигурация](https://docs.befailproof.ai/policies/local-configuration) | Области конфигурации и правила слияния | -| [Панель управления](https://docs.befailproof.ai/sessions/overview) | Монитор сеанса и активность политик | -| [Архитектура](https://docs.befailproof.ai/start/concepts) | Как работает система хуков | +| [Конфигурация](https://docs.befailproof.ai/policies/local-configuration) | Области конфигурации и правила объединения | + +| Инструментируйте свой собственный агент | | +|---|---| +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | Отправляйте запуски от агента без платформы | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | Справочник `allow` / `deny` / `instruct` | --- @@ -212,11 +248,11 @@ MIT с [Commons Clause](https://commonsclause.com/) — бесплатно дл --- -## Внесение вклада +## Участие См. [CONTRIBUTING.md](../../CONTRIBUTING.md). Новые политики, граничные случаи и переводы приветствуются. -> **Соберите перед началом работы.** Сначала запустите `bun install && bun run build`. Этот репозиторий запускает собственные хуки failproofai на себя, и они разрешают импорт `failproofai` относительно скомпилированного пакета `dist/` — без сборки вы столкнётесь с ошибками хуков `Cannot find package 'failproofai'`. Пересоберите после изменений `src/`. См. +> **Соберите проект перед началом.** Сначала запустите `bun install && bun run build`. Этот репозиторий запускает собственные хуки failproofai на себе, и они разрешают импорт `failproofai` в скомпилированный пакет `dist/` — без сборки вы получите ошибки хука `Cannot find package 'failproofai'`. Пересоберите после изменения `src/`. Смотрите > [Build before the in-repo dev hooks will work](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- diff --git a/docs/i18n/README.tr.md b/docs/i18n/README.tr.md index 945fcea21..204602ff2 100644 --- a/docs/i18n/README.tr.md +++ b/docs/i18n/README.tr.md @@ -18,10 +18,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**Çeviriler:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**Çeviriler:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**Kodlama ajanları için çalışma zamanı hatası çözümü.** -Claude Code ve Codex'e bağlanır. Döngüleri, tehlikeli işlemleri ve gizli dizi sızıntılarını olaylara dönüşmeden yakalar. Sıfır gecikme. Yerel olarak çalışır. +**Aracılarınızın çalıştığı her ortam için gözlenebilirlik ve zorlama.** +Aracılarınız nerede çalışırsa çalışsın, biz görebiliriz — ve hayır diyebiliriz. Failproof, 12 aracı ortamına bağlanır — Claude Code ve Codex gibi kodlama CLI'leri, Hermes gibi sohbet ağ geçitleri, OpenClaw gibi kendi kendine barındırılan asistanlar — her çalıştırmayı yakalar ve tehlikeli araç çağrılarını yürütülmeden önce engeller. 40 yerleşik ilke. Sıfır gecikme. Yerel olarak çalışır. @@ -31,7 +31,11 @@ Claude Code ve Codex'e bağlanır. Döngüleri, tehlikeli işlemleri ve gizli di --- -## Desteklenen ajan CLI'ları +## Desteklenen ortamlar + +İki sınıfta on iki ortam — on kodlama CLI'si ve iki sohbet ve asistan ağ geçidi (Hermes, OpenClaw). Aynı olaylar, aynı ilkeler, aynı oturum geçmişi, aracınız hangisinde çalışırsa çalışsın. + +Bunlardan hiçbirinde çalışmayan aracılar [Python SDK](https://docs.befailproof.ai/reference/python-sdk) aracılığıyla rapor verir; bu size izleme, oturumlar ve denetim sağlar. Orada zorlama, kendi çalışma zamanınızda bir kancaya ihtiyaç duyar — [bizimle iletişime geçin](mailto:support@befailproof.ai) ve biz bunu eşleştireceğiz. {/* 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 @@ -127,7 +131,7 @@ Claude Code ve Codex'e bağlanır. Döngüleri, tehlikeli işlemleri ve gizli di -## Yükleme +## Yükle ```sh npm install -g failproofai @@ -135,28 +139,33 @@ failproofai policies --install # veya sadece `failproofai` çalıştırın ve failproofai ``` -30 yerleşik politika hemen etkinleşir. Pano `localhost:8020` adresindedir. İlk çalıştırma istemini `FAILPROOFAI_NO_FIRST_RUN=1` ile devre dışı bırakın. +40 yerleşik ilke hemen etkinleşir. Pano `localhost:8020` adresinde. İlk çalıştırma istemini `FAILPROOFAI_NO_FIRST_RUN=1` ile devre dışı bırakın. --- -## Neyi durdurur +## Neyi engeller -| Politika | Neyi engeller | +| İlke | Neyi engeller | |---|---| -| `block-push-master` | `main` / `master` a doğrudan push işlemleri | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | `main` / `master` üzerinde commit, merge, rebase | +| `sanitize-api-keys` | API anahtarlarının aracının bağlamına sızması | +| `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ırsız `DELETE` | +| `block-terraform` / `block-kubectl` | Gözden geçirilmemiş canlı altyapı değişiklikleri | | `block-rm-rf` | Özyinelemeli dosya silme | -| `sanitize-api-keys` | API anahtarlarının ajan bağlamına sızması | +| `block-force-push` / `block-push-master` | `git push --force`, `main` ağacına doğrudan gönderim | -→ [Tüm 30 yerleşik politika](https://docs.befailproof.ai/policies/builtin) +İlk beş, araç çağırabilen herhangi bir aracı için geçerlidir. Son üç, geliştirici favorileridir — kodlama CLI'leri, en derin kapsama sahip ortam sınıfıdır. + +→ [Tüm 40 yerleşik ilke](https://docs.befailproof.ai/policies/builtin) --- -## Kendi politikalarınız +## Kendi ilkeleriniz -`.failproofai/policies/` klasörüne bir dosya bırakın — otomatik olarak yüklenir, bayrak gerekmez. -Bunu commit edin ve tüm takım bir sonraki pull'da alır. +`.failproofai/policies/` dosyasına bir dosya bırakın — otomatik olarak yüklenir, hiçbir bayrak gerekmez. +Bunu taahhüt edin ve tüm takım sonraki çekişte bunu alır. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -172,50 +181,76 @@ customPolicies.add({ }); ``` -Her politika için kullanılabilir üç karar: +Her ilkeye açık olan üç karar vardır: | Karar | Etki | |---|---| | `allow()` | İşleme izin ver | -| `deny(message)` | Engelle — ileti ajana geri gönderilir | -| `instruct(message)` | Geçir, ama ajanın sonraki istemine bağlam ekle | +| `deny(message)` | Engelle — mesaj aracıya geri dönüşür | +| `instruct(message)` | İzin ver, ancak bağlam aracının sonraki istemiyle ekle | -→ [Özel politikalar rehberi](https://docs.befailproof.ai/policies/custom) +→ [Özel ilkeler rehberi](https://docs.befailproof.ai/policies/custom) --- -## Oturum görünürlüğü +## Gözlenebilirlik + +Zorlama bir yarısı. Diğer yarısı, aracının gerçekten ne yaptığını görmektir. + +`failproofai` komutunu hiçbir argüman olmadan çalıştırın ve `localhost:8020` adresinde makinenizde zaten bulunan çalıştırma geçmişini okuyan bir pano sunar — hesap yok, kaydolma yok, kutu dışına hiçbir şey çıkmaz. Oturum listesini, her çalıştırma içindeki model çağrılarının sırasını, araç çağrılarını ve kanca kararlarını, engellenenleri ve ilkenin aracıya söylediklerini, ve risky desenler için geçmişinizi tarayacak ve onları durdurmak için ilkeler önerecek çevrimdışı bir denetimi (`failproofai audit`) alırsınız. + +→ [Yerel pano](https://docs.befailproof.ai/reference/local-dashboard) · +[İzleme oku](https://docs.befailproof.ai/sessions/read-a-trace) · +[Yerel denetim](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Gözlenebilirlik**, aynı veri modelinin barındırılan tarafıdır ve bir filo genelinde aracı çalıştıran takımlar içindir: her ortamdan her çalıştırma bir yerde, paralel alt-aracıların kendi şeritlerinde bulunduğu bir yürütme grafiği, modeller, araçlar ve kancalar için p50/p95/p99 gecikme, model başına maliyet ve bağlam penceresinin izlenmesi, hata izleme, kendi izlemenizin üzerinde SQL paylaşılabilir panolarla, kendi hizmetiniz tarafından puanlanan değerlendirmeler, periyodik hataları kanıta dayalı bulgulara dönüştüren planlanan denetimler ve Slack, e-posta veya imzalı webhook'a yönlendirilen uyarılar. Kendi kümenizde kendi kendine barındırma Enterprise planında mevcuttur. -Ajanınızın yaptığı her araç çağrısı yerel olarak kaydedilir. Pano hangi işlemin çalıştığını, -hangi işlemlerin engellendiğini ve politikanın ajana ne söylediğini gösterir — böylece bir şey ters gitti mi diye tahmin etmezsiniz. → [Pano rehberi](https://docs.befailproof.ai/sessions/overview) +→ [Oturumlar](https://docs.befailproof.ai/sessions/overview) · +[Denetimler](https://docs.befailproof.ai/audits/overview) · +[Demo rezervasyonu yap](https://befailproof.ai/get-a-demo) --- ## Belgeler -| | | +| Başlayın | | |---|---| -| [Başlarken](https://docs.befailproof.ai/start/quickstart) | Yükleme ve ilk adımlar | -| [Yerleşik Politikalar](https://docs.befailproof.ai/policies/builtin) | Tüm 30 politika ve parametreleri | -| [Özel Politikalar](https://docs.befailproof.ai/policies/custom) | Kendi politikalarınızı yazın | +| [Hızlı başlangıç](https://docs.befailproof.ai/start/quickstart) | Yükle, bir ortamı bağla, ilk çalıştırmayı gör | +| [Kavramlar](https://docs.befailproof.ai/start/concepts) | Kanca sistemi nasıl çalışır | +| [Desteklenen ortamlar](https://docs.befailproof.ai/reference/harnesses) | Tüm 12'si ve her birinin ne uygulayabileceği | + +| Gözlemle | | +|---|---| +| [Oturumlar](https://docs.befailproof.ai/sessions/overview) | Bir çalıştırmayı takip et: modeller, araçlar, hatalar, gecikme | +| [İzleme oku](https://docs.befailproof.ai/sessions/read-a-trace) | Yürütme grafiği sana ne söylüyor | +| [Denetimler](https://docs.befailproof.ai/audits/overview) | Birçok oturum arasında hata desenlerini bul | +| [Yerel pano](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, hesap gerekmez | + +| Zorla | | +|---|---| +| [Yerleşik ilkeler](https://docs.befailproof.ai/policies/builtin) | Tüm 40 ilke parametrelerle | +| [Özel ilkeler](https://docs.befailproof.ai/policies/custom) | Kendi ilkelerini yaz | | [Yapılandırma](https://docs.befailproof.ai/policies/local-configuration) | Yapılandırma kapsamları ve birleştirme kuralları | -| [Pano](https://docs.befailproof.ai/sessions/overview) | Oturum monitörü ve politika etkinliği | -| [Mimari](https://docs.befailproof.ai/start/concepts) | Hook sistemi nasıl çalışır | + +| Kendi aracını enstrüman et | | +|---|---| +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | Ortamı olmayan bir aracıdan çalıştırmaları rapor et | +| [İlke SDK](https://docs.befailproof.ai/reference/policy-sdk) | `allow` / `deny` / `instruct` referansı | --- ## Lisans -MIT ve [Commons Clause](https://commonsclause.com/) ile — dahili ve kişisel kullanım için ücretsiz; failproofai'nin kendisinin ticari yeniden satışı ayrı bir anlaşma gerektirir. Tam metin için [LICENSE](../../LICENSE) bölümüne bakın. +[Commons Clause](https://commonsclause.com/) ile MIT — iç ve kişisel kullanım için ücretsiz; failproofai'nin kendisinin ticari yeniden satışı ayrı bir anlaşma gerektirir. Tam metin için [LICENSE](../../LICENSE) dosyasına bakın. --- -## Katkı Sağlama +## Katkıda bulunun -[CONTRIBUTING.md](../../CONTRIBUTING.md) bölümüne bakın. Yeni politikalar, kenar durumlar ve çeviriler tamamen hoş geldiniz. +[CONTRIBUTING.md](../../CONTRIBUTING.md) dosyasına bakın. Yeni ilkeler, uç durumlar ve çeviriler hepsi hoş geldiniz. -> **Başlamadan önce derleyin.** İlk olarak `bun install && bun run build` çalıştırın. Bu repo failproofai'nin kendi hook'larını kendisinde çalıştırır ve `failproofai` import'unu derlenmiş `dist/` demeti karşısında çözerler — bir derlemeden sonra `Cannot find package 'failproofai'` hook hataları alırsınız. `src/` değiştirdikten sonra yeniden derleyin. Bkz. [In-repo dev hook'larının çalışması için derleyin](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> **Başlamadan önce derle.** Önce `bun install && bun run build` komutunu çalıştırın. Bu depo, failproofai'nin kendi kancalarını kendisi üzerinde çalıştırır ve `failproofai` içeri aktarımını derlenmiş `dist/` paketine göre çözerler — bir derleme olmadan, `Cannot find package 'failproofai'` kanca hatalarıyla karşılaşırsınız. `src/` değiştirdikten sonra yeniden derleyin. [Repo içi geliştirme kancaları çalışması için önce derleyin](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work) dosyasına bakın. --- -SF ve Bengaluru'da [befailproof.ai](https://befailproof.ai) tarafından ❤️ ile yapılmıştır. +Sevgiyle [befailproof.ai](https://befailproof.ai) tarafından SF ve Bengaluru'da yapılmıştır. diff --git a/docs/i18n/README.vi.md b/docs/i18n/README.vi.md index 08323d71c..313331fa1 100644 --- a/docs/i18n/README.vi.md +++ b/docs/i18n/README.vi.md @@ -18,11 +18,10 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**Bản dịch:** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**Bản dịch:** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**Giải pháp xử lý lỗi thời gian chạy cho các agent lập trình.** -Kết nối với Claude Code và Codex. Phát hiện vòng lặp, hành động nguy hiểm và rò rỉ bí mật -trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy cục bộ. +**Quan sát và thực thi cho mọi harness mà agents của bạn chạy.** +Bất kể agents của bạn chạy ở đâu, chúng tôi đều nhìn thấy — và chúng tôi có thể từ chối. Failproof kết nối 12 agent harness — các CLI viết mã như Claude Code và Codex, các gateway chat như Hermes, các trợ lý tự lưu trữ như OpenClaw — ghi lại mọi lần chạy và chặn các lệnh công cụ nguy hiểm trước khi chúng thực thi. 40 chính sách tích hợp sẵn. Độ trễ bằng không. Chạy cục bộ. @@ -32,7 +31,11 @@ trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy c --- -## Hỗ trợ Agent CLIs +## Các harness được hỗ trợ + +Mười hai harness trong hai lớp — mười CLI viết mã, và hai cổng chat và trợ lý (Hermes, OpenClaw). Cùng các sự kiện, cùng chính sách, cùng lịch sử phiên, bất kể agents của bạn chạy trong cái nào. + +Các agents chạy trong cái nào đó khác báo cáo thông qua [Python SDK](https://docs.befailproof.ai/reference/python-sdk), cung cấp cho bạn theo dõi, phiên và kiểm toán. Thực thi ở đó cần một hook trong runtime của riêng bạn — [liên hệ với chúng tôi](mailto:support@befailproof.ai) và chúng tôi sẽ ánh xạ nó. {/* 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 @@ -132,32 +135,36 @@ trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy c ```sh npm install -g failproofai -failproofai policies --install # hoặc chỉ chạy `failproofai` và chấp nhận lời nhắc lần đầu tiên +failproofai policies --install # hoặc chỉ chạy `failproofai` và chấp nhận lời nhắc lần đầu failproofai ``` -30 chính sách tích hợp sẵn kích hoạt ngay lập tức. Bảng điều khiển tại `localhost:8020`. Tắt lời nhắc lần đầu tiên với `FAILPROOFAI_NO_FIRST_RUN=1`. +40 chính sách tích hợp sẵn sẽ kích hoạt ngay lập tức. Dashboard tại `localhost:8020`. Tắt lời nhắc lần đầu với `FAILPROOFAI_NO_FIRST_RUN=1`. --- -## Những gì nó dừng lại +## Những gì nó chặn | Chính sách | Những gì nó chặn | |---|---| -| `block-push-master` | Đẩy trực tiếp đến `main` / `master` | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | Các cam kết, hợp nhất, rebase trên `main` / `master` | +| `sanitize-api-keys` | Các khóa API bị rò rỉ vào bối cảnh của agent | +| `block-env-files` | Đọc các tệp `.env` và tệp bí mật khác | +| `warn-repeated-tool-calls` | Agent lặp lại trên cùng một lệnh gọi | +| `block-sudo` | Nâng cao đặc quyền | +| `warn-destructive-sql` | `DROP`, `TRUNCATE`, `DELETE` không bị giới hạn | +| `block-terraform` / `block-kubectl` | Thay đổi không được xem xét đối với cơ sở hạ tầng trực tiếp | | `block-rm-rf` | Xóa tệp đệ quy | -| `sanitize-api-keys` | Khóa API rò rỉ vào ngữ cảnh agent | +| `block-force-push` / `block-push-master` | `git push --force`, đẩy trực tiếp đến `main` | -→ [Tất cả 30 chính sách tích hợp sẵn](https://docs.befailproof.ai/policies/builtin) +Năm cái đầu tiên áp dụng cho bất kỳ agent nào có thể gọi một công cụ. Ba cái cuối cùng là những ưa thích của nhà phát triển — các CLI viết mã là lớp harness mà chúng tôi bao quát sâu nhất. + +→ [Tất cả 40 chính sách tích hợp sẵn](https://docs.befailproof.ai/policies/builtin) --- -## Chính sách của bạn +## Chính sách của riêng bạn -Thả một tệp vào `.failproofai/policies/` — nó tải tự động, không cần cờ. -Cam kết nó và toàn bộ nhóm của bạn sẽ nhận được nó vào lần pull tiếp theo. +Thả một tệp vào `.failproofai/policies/` — nó tải tự động, không cần cờ. Cam kết nó và toàn bộ nhóm của bạn sẽ nhận được nó khi pull tiếp theo. ```js import { customPolicies, deny, allow } from "failproofai"; @@ -175,53 +182,75 @@ customPolicies.add({ Ba quyết định có sẵn cho mọi chính sách: -| Quyết định | Tác dụng | +| Quyết định | Hiệu ứng | |---|---| | `allow()` | Cho phép hoạt động | | `deny(message)` | Chặn nó — thông báo được gửi lại cho agent | -| `instruct(message)` | Cho phép thông qua, nhưng thêm ngữ cảnh vào lời nhắc tiếp theo của agent | +| `instruct(message)` | Cho phép nó thực hiện, nhưng thêm ngữ cảnh vào lời nhắc tiếp theo của agent | → [Hướng dẫn chính sách tùy chỉnh](https://docs.befailproof.ai/policies/custom) --- -## Hiển thị phiên +## Quan sát + +Thực thi là một nửa. Nửa còn lại là xem agent thực sự đã làm gì. + +Chạy `failproofai` mà không có đối số và nó sẽ phục vụ một dashboard tại `localhost:8020` đọc lịch sử chạy đã có trên máy của bạn — không tài khoản, không đăng ký, không có gì rời khỏi hộp. Bạn sẽ nhận được danh sách phiên, chuỗi lệnh gọi mô hình, lệnh gọi công cụ và quyết định hook bên trong mỗi lần chạy, những gì bị chặn và chính sách nói với agent điều gì, và kiểm toán ngoại tuyến (`failproofai audit`) quét lịch sử của bạn để tìm các mẫu rủi ro và gợi ý các chính sách để dừng chúng. + +→ [Dashboard cục bộ](https://docs.befailproof.ai/reference/local-dashboard) · +[Đọc một trace](https://docs.befailproof.ai/sessions/read-a-trace) · +[Kiểm toán cục bộ](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI Observability** là phía được lưu trữ của cùng một mô hình dữ liệu, dành cho các nhóm chạy agents trên một lfleet: mọi lần chạy từ mọi harness ở một nơi, một biểu đồ thực thi với các sub-agents song song trên làn đường riêng của họ, độ trễ p50/p95/p99 cho các mô hình, công cụ và hook, theo dõi chi phí mỗi mô hình và cửa sổ ngữ cảnh, theo dõi lỗi, SQL trên các trace của riêng bạn với các dashboard có thể chia sẻ, các đánh giá được tính điểm bởi dịch vụ của riêng bạn, các kiểm toán được lên lịch biến các lỗi định kỳ thành các phát hiện được hỗ trợ bằng bằng chứng, và cảnh báo được định tuyến đến Slack, email hoặc một webhook đã ký. Tự lưu trữ trong cluster của riêng bạn có sẵn trên gói Enterprise. -Mọi lệnh gọi công cụ mà agent của bạn thực hiện đều được ghi lại cục bộ. Bảng điều khiển hiển thị những gì đã chạy, -những gì bị chặn và những gì chính sách nói với agent — vì vậy bạn không phải đoán -khi có điều gì đó sai. → [Hướng dẫn bảng điều khiển](https://docs.befailproof.ai/sessions/overview) +→ [Phiên](https://docs.befailproof.ai/sessions/overview) · +[Kiểm toán](https://docs.befailproof.ai/audits/overview) · +[Đặt lịch demo](https://befailproof.ai/get-a-demo) --- ## Tài liệu -| | | +| Bắt đầu | | +|---|---| +| [Quickstart](https://docs.befailproof.ai/start/quickstart) | Cài đặt, kết nối một harness, xem lần chạy đầu tiên | +| [Khái niệm](https://docs.befailproof.ai/start/concepts) | Cách hoạt động của hệ thống hook | +| [Các harness được hỗ trợ](https://docs.befailproof.ai/reference/harnesses) | Tất cả 12 và những gì mỗi cái có thể thực thi | + +| Quan sát | | +|---|---| +| [Phiên](https://docs.befailproof.ai/sessions/overview) | Theo dõi một lần chạy: mô hình, công cụ, lỗi, độ trễ | +| [Đọc một trace](https://docs.befailproof.ai/sessions/read-a-trace) | Những gì biểu đồ thực thi đang cho bạn biết | +| [Kiểm toán](https://docs.befailproof.ai/audits/overview) | Tìm các mẫu lỗi trên nhiều phiên | +| [Dashboard cục bộ](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`, không cần tài khoản | + +| Thực thi | | +|---|---| +| [Chính sách tích hợp sẵn](https://docs.befailproof.ai/policies/builtin) | Tất cả 40 chính sách với các tham số | +| [Chính sách tùy chỉnh](https://docs.befailproof.ai/policies/custom) | Viết của riêng bạn | +| [Cấu hình](https://docs.befailproof.ai/policies/local-configuration) | Các phạm vi cấu hình và quy tắc hợp nhất | + +| Cài đặt agent của riêng bạn | | |---|---| -| [Bắt đầu](https://docs.befailproof.ai/start/quickstart) | Cài đặt và các bước đầu tiên | -| [Chính sách tích hợp sẵn](https://docs.befailproof.ai/policies/builtin) | Tất cả 30 chính sách với các tham số | -| [Chính sách tùy chỉnh](https://docs.befailproof.ai/policies/custom) | Viết chính sách của riêng bạn | -| [Cấu hình](https://docs.befailproof.ai/policies/local-configuration) | Phạm vi cấu hình và quy tắc hợp nhất | -| [Bảng điều khiển](https://docs.befailproof.ai/sessions/overview) | Trình giám sát phiên và hoạt động chính sách | -| [Kiến trúc](https://docs.befailproof.ai/start/concepts) | Cách hệ thống hook hoạt động | +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | Báo cáo các lần chạy từ một agent mà không có harness | +| [Policy SDK](https://docs.befailproof.ai/reference/policy-sdk) | Tham chiếu `allow` / `deny` / `instruct` | --- ## Giấy phép -MIT với [Commons Clause](https://commonsclause.com/) — miễn phí để sử dụng nội bộ và cá nhân; bán lại thương mại failproofai yêu cầu một thỏa thuận riêng biệt. Xem [LICENSE](../../LICENSE) để biết toàn bộ văn bản. +MIT với [Commons Clause](https://commonsclause.com/) — miễn phí cho mục đích sử dụng nội bộ và cá nhân; bán lại thương mại của failproofai yêu cầu một thỏa thuận riêng. Xem [LICENSE](../../LICENSE) để biết toàn bộ văn bản. --- ## Đóng góp -Xem [CONTRIBUTING.md](../../CONTRIBUTING.md). Chính sách mới, trường hợp cạnh và bản dịch đều được chào đón. +Xem [CONTRIBUTING.md](../../CONTRIBUTING.md). Các chính sách mới, trường hợp cạnh và bản dịch đều được chào đón. -> **Xây dựng trước khi bạn bắt đầu.** Chạy `bun install && bun run build` trước tiên. Kho này chạy -> các hook của failproofai trên chính nó, và chúng giải quyết nhập `failproofai` so với -> gói `dist/` được biên dịch — nếu không có bản dựng, bạn sẽ gặp lỗi hook `Cannot find package 'failproofai'`. -> Xây dựng lại sau khi thay đổi `src/`. Xem -> [Xây dựng trước khi các hook dev trong kho sẽ hoạt động](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). +> **Xây dựng trước khi bạn bắt đầu.** Chạy `bun install && bun run build` trước tiên. Kho này chạy các hook của failproofai trên chính nó, và chúng giải quyết nhập `failproofai` so với gói `dist/` được biên dịch — mà không cần xây dựng bạn sẽ gặp `Cannot find package 'failproofai'` lỗi hook. Xây dựng lại sau khi thay đổi `src/`. Xem +> [Xây dựng trước khi các hook dev trong repo sẽ hoạt động](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work). --- -Được xây dựng với ❤️ bởi [befailproof.ai](https://befailproof.ai) ở SF và Bengaluru. +Được xây dựng với ❤️ bởi [befailproof.ai](https://befailproof.ai) tại SF và Bengaluru. diff --git a/docs/i18n/README.zh.md b/docs/i18n/README.zh.md index 224a251a7..1f4265aba 100644 --- a/docs/i18n/README.zh.md +++ b/docs/i18n/README.zh.md @@ -18,10 +18,11 @@ [![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://docs.befailproof.ai/) [![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](../../LICENSE) -**翻译版本：** [简体中文](../../docs-old/i18n/README.zh.md) · [日本語](../../docs-old/i18n/README.ja.md) · [한국어](../../docs-old/i18n/README.ko.md) · [Español](../../docs-old/i18n/README.es.md) · [Português](../../docs-old/i18n/README.pt-br.md) · [Deutsch](../../docs-old/i18n/README.de.md) · [Français](../../docs-old/i18n/README.fr.md) · [Руссий](../../docs-old/i18n/README.ru.md) · [हिन्दी](../../docs-old/i18n/README.hi.md) · [Türkçe](../../docs-old/i18n/README.tr.md) · [Tiếng Việt](../../docs-old/i18n/README.vi.md) · [Italiano](../../docs-old/i18n/README.it.md) · [العربية](../../docs-old/i18n/README.ar.md) · [עברית](../../docs-old/i18n/README.he.md) +**翻译：** [简体中文](../../docs/i18n/README.zh.md) · [日本語](../../docs/i18n/README.ja.md) · [한국어](../../docs/i18n/README.ko.md) · [Español](../../docs/i18n/README.es.md) · [Português](../../docs/i18n/README.pt-br.md) · [Deutsch](../../docs/i18n/README.de.md) · [Français](../../docs/i18n/README.fr.md) · [Русский](../../docs/i18n/README.ru.md) · [हिन्दी](../../docs/i18n/README.hi.md) · [Türkçe](../../docs/i18n/README.tr.md) · [Tiếng Việt](../../docs/i18n/README.vi.md) · [Italiano](../../docs/i18n/README.it.md) · [العربية](../../docs/i18n/README.ar.md) · [עברית](../../docs/i18n/README.he.md) -**为编码 Agent 提供运行时故障解决方案。** -接入 Claude Code 和 Codex。在循环、危险操作和密钥泄露演变成事故之前将其拦截。零延迟，本地运行。 +**为 Agent 运行的每一个运行框架提供可观测性与执行控制。** +无论你的 Agent 在哪里运行，我们都能看到——并且可以说不。Failproof 接入了 12 个 Agent +运行框架——包括 Claude Code、Codex 等编码 CLI，Hermes 等聊天网关，以及 OpenClaw 等自托管助手——捕获每一次运行，并在危险工具调用执行前将其拦截。40 条内置策略，零延迟，本地运行。 @@ -31,7 +32,11 @@ --- -## 支持的 Agent CLI +## 支持的运行框架 + +共 12 个运行框架，分为两类——10 个编码 CLI，以及 2 个聊天与助手网关（Hermes、OpenClaw）。无论你的 Agent 运行在哪个框架中，事件、策略、会话历史完全一致。 + +如果 Agent 不运行在上述任何框架中，可通过 [Python SDK](https://docs.befailproof.ai/reference/python-sdk) 上报数据，提供追踪、会话和审计能力。在自定义运行时中实现执行控制需要接入 Hook——[联系我们](mailto:support@befailproof.ai)，我们会协助完成映射。 {/* 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 @@ -131,31 +136,36 @@ ```sh npm install -g failproofai -failproofai policies --install # 或直接运行 `failproofai` 并接受首次运行提示 +failproofai policies --install # 或直接运行 `failproofai` 并在首次运行提示中确认 failproofai ``` -30 条内置策略即时生效。控制台地址：`localhost:8020`。可通过设置 `FAILPROOFAI_NO_FIRST_RUN=1` 禁用首次运行提示。 +40 条内置策略立即生效。控制台地址：`localhost:8020`。如需禁用首次运行提示，设置 `FAILPROOFAI_NO_FIRST_RUN=1`。 --- -## 拦截范围 +## 能拦截什么 | 策略 | 拦截内容 | |---|---| -| `block-push-master` | 直接推送到 `main` / `master` 分支 | -| `block-force-push` | `git push --force` | -| `block-work-on-main` | 在 `main` / `master` 上进行提交、合并、变基 | +| `sanitize-api-keys` | API 密钥泄漏到 Agent 上下文中 | +| `block-env-files` | 读取 `.env` 及其他密钥文件 | +| `warn-repeated-tool-calls` | Agent 在同一调用上陷入循环 | +| `block-sudo` | 权限提升 | +| `warn-destructive-sql` | `DROP`、`TRUNCATE`、无条件 `DELETE` | +| `block-terraform` / `block-kubectl` | 未经审查的线上基础设施变更 | | `block-rm-rf` | 递归删除文件 | -| `sanitize-api-keys` | API 密钥泄露到 Agent 上下文中 | +| `block-force-push` / `block-push-master` | `git push --force`、直接推送到 `main` | -→ [全部 30 条内置策略](https://docs.befailproof.ai/policies/builtin) +前五条适用于任何能调用工具的 Agent，后三条是开发者最爱——编码 CLI 是我们覆盖最深入的框架类别。 + +→ [全部 40 条内置策略](https://docs.befailproof.ai/policies/builtin) --- ## 自定义策略 -将文件放入 `.failproofai/policies/` 目录即可自动加载，无需任何额外参数。提交后，团队所有成员在下次拉取时即可同步生效。 +将文件放入 `.failproofai/policies/` 目录即可自动加载，无需任何参数。提交到代码库后，团队所有成员在下次拉取时即可生效。 ```js import { customPolicies, deny, allow } from "failproofai"; @@ -176,44 +186,72 @@ customPolicies.add({ | 决策 | 效果 | |---|---| | `allow()` | 允许该操作 | -| `deny(message)` | 阻止操作——消息将返回给 Agent | -| `instruct(message)` | 放行操作，但向 Agent 的下一个提示词中追加上下文信息 | +| `deny(message)` | 拦截操作——消息回传给 Agent | +| `instruct(message)` | 放行，但在 Agent 的下一个提示词中追加上下文 | → [自定义策略指南](https://docs.befailproof.ai/policies/custom) --- -## 会话可视化 +## 可观测性 + +执行控制是一半，另一半是看清 Agent 实际做了什么。 + +不带参数运行 `failproofai`，它会在 `localhost:8020` 提供一个控制台，读取已保存在本机的运行历史——无需账号，无需注册，数据不离开本机。你可以查看会话列表、每次运行中的模型调用序列、工具调用与 Hook 决策，以及哪些操作被拦截、策略向 Agent 传达了什么内容；还有离线审计功能（`failproofai audit`），可扫描历史记录中的风险模式并推荐相应策略。 + +→ [本地控制台](https://docs.befailproof.ai/reference/local-dashboard) · +[解读追踪记录](https://docs.befailproof.ai/sessions/read-a-trace) · +[本地审计](https://docs.befailproof.ai/audits/local-audit) + +**Failproof AI 可观测性**是同一数据模型的托管版本，面向在多台机器上运行 Agent 的团队：所有框架的每一次运行汇聚一处，带并行子 Agent 独立泳道的执行图，模型、工具与 Hook 的 p50/p95/p99 延迟，按模型统计的费用与上下文窗口追踪，错误追踪，基于自有追踪数据的 SQL 查询与可分享的控制台，由你自己的服务评分的评测，将重复失败转化为有据可查结论的定期审计，以及路由至 Slack、邮件或签名 Webhook 的告警。企业版支持在自有集群中自托管。 -Agent 的每次工具调用都会在本地记录日志。控制台展示了哪些操作已执行、哪些被拦截，以及策略告知 Agent 的内容——让你在出现问题时不再一头雾水。→ [控制台指南](https://docs.befailproof.ai/sessions/overview) +→ [会话](https://docs.befailproof.ai/sessions/overview) · +[审计](https://docs.befailproof.ai/audits/overview) · +[预约演示](https://befailproof.ai/get-a-demo) --- ## 文档 -| | | +| 入门 | | |---|---| -| [快速开始](https://docs.befailproof.ai/start/quickstart) | 安装与初步使用 | -| [内置策略](https://docs.befailproof.ai/policies/builtin) | 全部 30 条策略及参数说明 | +| [快速开始](https://docs.befailproof.ai/start/quickstart) | 安装、接入运行框架、查看第一次运行 | +| [核心概念](https://docs.befailproof.ai/start/concepts) | Hook 系统的工作原理 | +| [支持的运行框架](https://docs.befailproof.ai/reference/harnesses) | 全部 12 个及各自的执行能力 | + +| 观测 | | +|---|---| +| [会话](https://docs.befailproof.ai/sessions/overview) | 追踪一次运行：模型、工具、错误、延迟 | +| [解读追踪记录](https://docs.befailproof.ai/sessions/read-a-trace) | 执行图在告诉你什么 | +| [审计](https://docs.befailproof.ai/audits/overview) | 跨多个会话发现失败模式 | +| [本地控制台](https://docs.befailproof.ai/reference/local-dashboard) | `localhost:8020`，无需账号 | + +| 执行控制 | | +|---|---| +| [内置策略](https://docs.befailproof.ai/policies/builtin) | 全部 40 条策略及参数说明 | | [自定义策略](https://docs.befailproof.ai/policies/custom) | 编写你自己的策略 | | [配置](https://docs.befailproof.ai/policies/local-configuration) | 配置作用域与合并规则 | -| [控制台](https://docs.befailproof.ai/sessions/overview) | 会话监控与策略活动 | -| [架构](https://docs.befailproof.ai/start/concepts) | Hook 系统工作原理 | + +| 接入你自己的 Agent | | +|---|---| +| [Python SDK](https://docs.befailproof.ai/reference/python-sdk) | 从无框架的 Agent 上报运行数据 | +| [策略 SDK](https://docs.befailproof.ai/reference/policy-sdk) | `allow` / `deny` / `instruct` 参考文档 | --- ## 许可证 -MIT 附加 [Commons Clause](https://commonsclause.com/) ——内部及个人使用免费；将 failproofai 本身进行商业转售需要单独签署协议。完整条款请参阅 [LICENSE](../../LICENSE)。 +MIT + [Commons Clause](https://commonsclause.com/) ——内部使用和个人使用免费；将 failproofai 本身用于商业转售需另行签订协议。完整条款见 [LICENSE](../../LICENSE)。 --- ## 贡献 -请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md)。欢迎贡献新策略、边界用例及翻译内容。 +请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md)。欢迎贡献新策略、边界情况处理以及翻译。 -> **开始前请先构建项目。** 首先运行 `bun install && bun run build`。本仓库会在自身上运行 failproofai 的 Hook，这些 Hook 会从编译后的 `dist/` 包中解析 `failproofai` 导入——若未构建，则会触发 `Cannot find package 'failproofai'` 的 Hook 错误。修改 `src/` 后请重新构建。详见 [构建后才能使用仓库内开发 Hook](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)。 +> **开始前请先构建项目。** 首先运行 `bun install && bun run build`。本仓库会将 failproofai 自身的 Hook 应用于自身，这些 Hook 会从编译后的 `dist/` 包中解析 `failproofai` 导入——如果未构建，你会遇到 `Cannot find package 'failproofai'` 的 Hook 错误。修改 `src/` 后请重新构建。详见 +> [构建后才能使用仓库内开发 Hook](../../CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)。 --- -由 [befailproof.ai](https://befailproof.ai) 团队在旧金山与班加罗尔倾心打造 ❤️。 +由 [befailproof.ai](https://befailproof.ai) 在旧金山和班加罗尔用 ❤️ 构建。 diff --git a/docs/it/index.mdx b/docs/it/index.mdx index 9728c3853..46890a983 100644 --- a/docs/it/index.mdx +++ b/docs/it/index.mdx @@ -1,40 +1,41 @@ --- ---- -title: "Rendi il tuo agent a prova di errore" -description: "Failproof AI traccia il comportamento dell'agent, controlla le sessioni per identificare i malfunzionamenti e distribuisce policy che impediscono il ripetersi degli stessi errori." +title: "Rendi il tuo agente a prova di errore" +description: "Osservabilità e enforcement per ogni harness in cui i tuoi agenti vengono eseguiti — coding CLI, gateway di chat, assistenti self-hosted e i tuoi agenti strumentati." icon: "shield-check" --- -Failproof AI aiuta i team a comprendere cosa hanno fatto gli agent, a identificare dove hanno fallito e a distribuire misure di protezione prima che lo stesso comportamento si ripeta. +Failproof AI aiuta i team a capire cosa hanno fatto gli agenti, a individuare dove hanno fallito e a distribuire protezioni prima che lo stesso comportamento si ripeta. + +Un **harness** è ciò in cui il tuo agente viene effettivamente eseguito. Failproof AI si integra con 12 di essi — coding CLI come Claude Code e Codex, gateway di chat come Hermes, assistenti self-hosted come OpenClaw — e gli stessi eventi, le stesse policy e la stessa cronologia delle sessioni si applicano a tutti. Gli agenti senza harness inviano report attraverso l'[SDK Python](/it/reference/python-sdk), che li traccia e li audita; l'enforcement di una policy lì richiede un hook nel tuo runtime. - Usa lo skill per strumentare il tuo progetto, collegarlo e verificare che i log dell'agent arrivino correttamente. + Usa lo skill per strumentare il tuo progetto, collegarlo e verificare che i log degli agenti arrivino. - - Analizza, interroga, costruisci dashboard ed esegui audit in linguaggio naturale sui log dell'agent. + + Analizza, interroga, crea dashboard ed esegui audit nel linguaggio naturale sui log dei tuoi agenti. - - Segui le chiamate al modello, gli strumenti, gli errori, l'input umano, la latenza e le decisioni di policy in una singola sessione. + + Segui le chiamate ai modelli, i tool, gli errori, l'input umano, la latenza e le decisioni delle policy in una sessione. - - Controlla un set di sessioni definito, esamina i risultati supportati da prove e traccia la risoluzione come problemi. + + Audita una serie definita di sessioni, rivedi i risultati supportati da prove e traccia la remediation come issue. - - Trasforma una modalità di errore nota in una policy, osserva il suo impatto e distribuiscila su tutta la tua flotta. + + Trasforma una modalità di fallimento nota in una policy, osserva il suo impatto e distribuiscila tra la tua flotta. -> **Sessione → Audit → Risultato → Problema → Policy**
-> Traccia cosa è accaduto, identifica il malfunzionamento, gestisci la risposta, quindi previeni lo stesso comportamento nelle future esecuzioni. +> **Sessione → Audit → Risultato → Issue → Policy**
+> Traccia cosa è successo, trova il fallimento, gestisci la risposta, quindi previeni lo stesso comportamento nelle esecuzioni future. ## Inizia da qui -Se stai distribuendo il tuo primo agent strumentato, inizia con la [guida rapida](/it/start/quickstart). Se i dati stanno già arrivando, apri [Sessioni](/it/sessions/overview) e ispeziona un'esecuzione reale prima di configurare audit o policy. +Se stai distribuendo il tuo primo agente strumentato, inizia con la [guida rapida](/it/start/quickstart). Se i dati stanno già arrivando, apri [Sessioni](/it/sessions/overview) e ispeziona un'esecuzione reale prima di configurare gli audit o le policy. - - Completa il flusso di lavoro end-to-end dall'acquisizione a una policy distribuita in sicurezza. + + Completa il workflow end-to-end dalla cattura a una policy distribuita in modo sicuro. \ No newline at end of file diff --git a/docs/it/reference/harnesses.mdx b/docs/it/reference/harnesses.mdx index 595cb06ef..87c5aeb58 100644 --- a/docs/it/reference/harnesses.mdx +++ b/docs/it/reference/harnesses.mdx @@ -1,61 +1,68 @@ --- -title: "Harness degli agenti" -description: "Cattura sessioni e applica politiche nei CLI degli agenti supportati." +title: "Harness per agenti" +description: "Cattura sessioni e applica policy su tutti e 12 gli harness di agenti supportati." icon: "plug-zap" --- -Failproof AI supporta Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI e Goose. +Un harness è l'ambiente in cui il tuo agente effettivamente viene eseguito. Failproof AI supporta dodici di essi, divisi in due categorie: -| Harness | Ambiti di hook supportati | +- **IDE e CLI per la codifica** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **Gateway di chat e assistenti** (2) — Hermes (Slack, Telegram, cron), OpenClaw (assistente self-hosted) + +Le stesse policy e la stessa cronologia delle sessioni si applicano indipendentemente da quale harness esegue l'agente. Un livello di adapter mappa i nomi degli eventi nativi di ogni harness, i nomi degli strumenti e i campi degli input degli strumenti su 29 eventi canonici prima che qualsiasi policy venga eseguita. + +Un agente che viene eseguito in **nessuno** dei dodici harness viene instrumentato direttamente con l'[SDK Python](/it/reference/python-sdk). Si tratta di un contratto diverso, e vale la pena affermarlo chiaramente: l'SDK fornisce tracciamento, sessioni, valutazioni e audit — **non applica policy autonomamente.** Bloccare un'azione non sicura prima della sua esecuzione richiede un hook di enforcement al confine degli strumenti del tuo runtime; [contattaci](mailto:support@befailproof.ai) e lo mapperemo. + +| Harness | Scope hook supportati | | --- | --- | | Claude Code | User, project, local | | Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | | Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | | Hermes, OpenClaw | User | -Ogni integrazione normalizza i nomi degli eventi hook nativi, i nomi degli strumenti e i campi degli input dello strumento prima dell'esecuzione delle politiche. Una politica può agire solo su eventi esposti dall'harness; verifica il comportamento end-of-turn e le istruzioni sull'harness e la versione esatti che distribuisci. +Ogni integrazione normalizza i nomi nativi degli eventi hook, i nomi degli strumenti e i campi degli input degli strumenti prima che le policy vengano eseguite. Una policy può agire solo su eventi esposti dall'harness; testa il comportamento di fine turno e istruzioni esattamente sull'harness e sulla versione che distribuisci. -## Capacità di applicazione +## Capacità di enforcement -"Block" significa che il verdetto restituito dall'adattatore corrente viene utilizzato dall'harness nominato. Il blocco post-tool può sostituire il risultato mostrato al modello, ma non può annullare un effetto collaterale dello strumento che è già avvenuto. +"Blocca" significa che il verdetto restituito dall'adapter corrente è consumato dall'harness denominato. Il blocco post-strumento può sostituire il risultato mostrato al modello ma non può annullare un effetto collaterale dello strumento già avvenuto. -| Harness | Eventi di blocco verificati | Caveat osservativi o non bloccanti | +| Harness | Eventi di blocco verificati | Caveat solo osservativi o non bloccanti | | --- | --- | --- | | Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` e diversi eventi di task/config | `PostToolUse`, ciclo di vita della sessione, notifiche ed eventi post-errore sono osservativi. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Il blocco post-tool sostituisce il risultato dopo l'esecuzione; gli eventi di inizio sessione e compattamento sono osservativi nell'adattatore corrente. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Il blocco post-tool sostituisce il risultato dopo l'esecuzione; gli eventi di sessione e notifica sono osservativi. | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Il blocco post-strumento sostituisce il risultato dopo l'esecuzione; gli eventi di avvio della sessione e compattamento sono osservativi nell'adapter corrente. | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Il blocco post-strumento sostituisce il risultato dopo l'esecuzione; gli eventi di sessione e notifica sono osservativi. | | Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` e gli eventi di sessione sono osservativi. | -| OpenCode | `PreToolUse` | Gli eventi post-tool e di ciclo di vita sono osservativi; la gestione dello stop corrente è una guida per un turno successivo piuttosto che un gate verificato. | -| Pi | `PreToolUse`, `UserPromptSubmit` | Gli eventi post-tool e di ciclo di vita sono osservativi; la guida di stop si applica a un turno successivo. | -| Hermes | `PreToolUse` | I verdetti post-tool, sessione e subagent-stop non sono gate. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Gli eventi post-tool, sessione, subagent-stop e compattamento sono osservativi. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | I verdetti post-tool e subagent-stop sono osservativi. | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` condizionale | Gli hook di permesso non vengono eseguiti in ogni modalità di permesso; gli eventi post-tool e di sessione sono osservativi. | -| Antigravity CLI | `PreToolUse`, `Stop` | I verdetti di user-prompt e post-tool sono osservativi; le istruzioni di prompt possono comunque essere iniettate. | -| Goose | `PreToolUse` | Gli eventi di user-prompt, post-tool e di sessione sono osservativi. Esiste un hook di stop bloccante nativo a monte, ma non viene installato dall'adattatore corrente. | +| OpenCode | `PreToolUse` | Gli eventi post-strumento e ciclo di vita sono osservativi; la gestione dello stop corrente è una guida per un turno successivo piuttosto che un gate verificato. | +| Pi | `PreToolUse`, `UserPromptSubmit` | Gli eventi post-strumento e ciclo di vita sono osservativi; la guida di stop si applica a un turno successivo. | +| Hermes | `PreToolUse` | I verdetti post-strumento, sessione e subagent-stop non sono gate. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Gli eventi post-strumento, sessione, subagent-stop e compattamento sono osservativi. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | I verdetti post-strumento e subagent-stop sono osservativi. | +| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` condizionale | Gli hook di permission non vengono eseguiti in ogni modalità di permesso; gli eventi post-strumento e sessione sono osservativi. | +| Antigravity CLI | `PreToolUse`, `Stop` | I verdetti di user-prompt e post-strumento sono osservativi; le istruzioni di prompt possono comunque essere iniettate. | +| Goose | `PreToolUse` | Gli eventi di user-prompt, post-strumento e sessione sono osservativi. Esiste uno hook di stop bloccante nativo upstream ma non è installato dall'adapter corrente. | -Le capacità sono sensibili alla versione. Ripeti i test dopo l'aggiornamento di un CLI dell'agente, soprattutto quando una politica si basa sul comportamento di prompt, stop, permesso o post-tool piuttosto che sul gate pre-tool comune. +Le capacità sono sensibili alla versione. Ritesta dopo l'aggiornamento di un agent CLI, specialmente quando una policy si basa su comportamento di prompt, stop, permission o post-strumento piuttosto che il comune gate pre-strumento. -## Installa hook di cattura e politica +## Installa hook di capture e policy 1. Apri **Administration → Keys** e crea una chiave con `events:add` e `policies:pull`, denominata per la macchina o l'ambiente. - 2. Sulla macchina di destinazione, connetti il CLI locale con la chiave visualizzata e installa gli hook dell'harness. - 3. Avvia una nuova sessione dell'agente, quindi conferma i suoi eventi di hook e sessione in **Observe → Events**. - 4. Apri **Observe → policy** per la stessa finestra temporale e conferma che una decisione di politica è attribuita alla macchina. + 2. Sulla macchina target, connetti la CLI locale con la chiave visualizzata e installa gli hook dell'harness. + 3. Avvia una nuova sessione di agente, quindi conferma i suoi eventi di hook e sessione in **Observe → Events**. + 4. Apri **Observe → policy** per la stessa finestra temporale e conferma che una decisione di policy è attribuita alla macchina. - La connessione inizia con una chiave di macchina. Conferma che include sia i permessi di acquisizione che di consegna delle politiche prima di copiare il suo segreto. + La connessione inizia con una chiave di macchina. Conferma che includa sia i permessi di ingestion che di policy-delivery prima di copiare il suo secret. - ![Il nuovo drawer della chiave API utilizzato per concedere i permessi di acquisizione degli eventi e consegna delle politiche.](/images/dashboard/key-create.png) + ![Il drawer della nuova chiave API utilizzato per concedere i permessi di ingestion degli eventi e policy delivery.](/images/dashboard/key-create.png) - Dopo aver installato gli hook, il flusso Events dovrebbe mostrare nuovi eventi dalla macchina e dall'ambiente che hai connesso. + Dopo aver installato gli hook, lo stream degli Events dovrebbe mostrare nuovi eventi dalla macchina e dall'ambiente che hai connesso. - ![Il flusso Events in diretta utilizzato per confermare che un harness appena installato sta segnalando.](/images/dashboard/events-stream.png) + ![Lo stream live degli Events utilizzato per confermare che un harness appena installato sta generando report.](/images/dashboard/events-stream.png) - Infine, verifica che le decisioni di politica siano attribuite alla stessa macchina. Questo conferma che l'harness sta segnalando l'attività di politica così come gli eventi di traccia. + Infine, verifica che le decisioni di policy siano attribuite alla stessa macchina. Questo conferma che l'harness sta generando report sia dell'attività di policy che degli eventi di traccia. - ![La pagina Policy utilizzata per verificare le decisioni di politica da un harness appena connesso.](/images/dashboard/policy-observe.png) + ![La pagina Policy utilizzata per verificare le decisioni di policy da un harness appena connesso.](/images/dashboard/policy-observe.png) Installa gli hook per ogni harness rilevato: @@ -67,7 +74,7 @@ Le capacità sono sensibili alla versione. Ripeti i test dopo l'aggiornamento di failproofai policies --install ``` - Oppure prendi come target harness nominati e un ambito di configurazione: + Oppure scegli harness specifici e uno scope di configurazione: ```bash failproofai policies --install \ @@ -75,7 +82,7 @@ Le capacità sono sensibili alla versione. Ripeti i test dopo l'aggiornamento di --scope user ``` - L'ambito del progetto mantiene la configurazione dell'hook con un repository. L'ambito utente copre il lavoro su più repository. Claude Code supporta anche l'ambito locale; il supporto varia in base all'harness e il CLI rifiuta le combinazioni non supportate. + Lo scope project mantiene la configurazione dell'hook con un repository. Lo scope user copre il lavoro tra repository. Claude Code supporta anche lo scope local; il supporto varia in base all'harness e la CLI rifiuta combinazioni non supportate. Verifica la macchina e i suoi eventi: @@ -91,9 +98,9 @@ Le capacità sono sensibili alla versione. Ripeti i test dopo l'aggiornamento di - I percorsi aggiuntivi sono registrati sulla macchina, non nel Cloud. Dopo aver aggiunto uno, apri **Observe → Sessions**, filtra per l'ambiente della macchina e conferma che le sessioni dal nuovo percorso vengono visualizzate. Apri una sessione e controlla l'agente, l'harness e i timestamp degli eventi prima di affidarti a essa in un audit. + I percorsi extra vengono registrati sulla macchina, non nel Cloud. Dopo aver aggiunto uno, apri **Observe → Sessions**, filtra all'ambiente della macchina e conferma che le sessioni dal nuovo percorso appaiono. Apri una sessione e verifica l'agente, l'harness e i timestamp degli eventi prima di affidarti a essa in un audit. - ![L'elenco Sessions filtrato per l'ambiente che riceve dati dal percorso di cattura aggiuntivo.](/images/dashboard/sessions-list.png) + ![L'elenco delle Sessions filtrato all'ambiente che riceve dati dal percorso di capture aggiuntivo.](/images/dashboard/sessions-list.png) Aggiungi un percorso con un'etichetta opzionale, quindi ispeziona i percorsi configurati: @@ -110,5 +117,5 @@ Le capacità sono sensibili alla versione. Ripeti i test dopo l'aggiornamento di - Esegui una nuova sessione dopo l'installazione. Verifica sia il flusso di eventi in diretta che una decisione di politica effettiva prima di espandere il rollout. + Esegui una nuova sessione dopo l'installazione. Verifica sia lo stream degli eventi live che una decisione di policy effettiva prima di espandere il rollout. \ No newline at end of file diff --git a/docs/it/sessions/live-events.mdx b/docs/it/sessions/live-events.mdx index 5fcedee42..e210b1dee 100644 --- a/docs/it/sessions/live-events.mdx +++ b/docs/it/sessions/live-events.mdx @@ -1,22 +1,21 @@ --- ---- title: "Eventi in diretta" -description: "Guarda l'attività degli agenti arrivare in tempo reale durante una sessione in corso." +description: "Osserva l'attività dell'agent mentre la sessione è in corso." icon: "radio" --- -Gli eventi in diretta ti aiutano a confermare la strumentazione e a monitorare un'esecuzione rischiosa senza attendere il termine della sessione. +Gli eventi in diretta ti aiutano a confermare la strumentazione e a monitorare un'esecuzione rischiosa senza attendere il completamento della sessione. -## Guarda l'attività +## Monitora l'attività 1. Vai a **Observe → Events**. - 2. Inizia con la finestra temporale corrente e nessun filtro per confermare che i dati stanno arrivando. - 3. Filtra per ambiente, tipo di evento, agente o sessione. Usa la ricerca per il testo del payload. - 4. Seleziona un evento per ispezionarne il riepilogo e i dettagli. Segui il link della sessione per la traccia completa. + 2. Inizia con la finestra temporale attuale e nessun filtro per confermare che i dati stanno arrivando. + 3. Filtra per ambiente, tipo di evento, agent o sessione. Usa la ricerca per il testo del payload. + 4. Seleziona un evento per ispezionarne il riepilogo e i dettagli. Segui il collegamento della sua sessione per la traccia completa. - ![Il flusso di eventi in diretta con filtri per ora, ambiente, tipo di evento, agente, modello, contesto, sessione e testo.](/images/dashboard/events-stream-current.png) + ![Il flusso Events in diretta che mostra il traffico da un gateway di chat Hermes insieme alle esecuzioni di coding-CLI, filtrato per ora, ambiente, tipo di evento, agent, modello, contesto e sessione.](/images/dashboard/events-stream-current.png) ```bash @@ -25,20 +24,22 @@ Gli eventi in diretta ti aiutano a confermare la strumentazione e a monitorare u fp --json events --full --session-id --all ``` - Il feed predefinito omette i payload grezzi. Usa `--full` solo per un'indagine di sessione delimitata. + Il feed predefinito omette i payload grezzi. Usa `--full` solo per un'indagine di sessione limitata. Usa il flusso di eventi per rispondere a tre domande immediate: -- L'agente previsto sta segnalando all'ambiente corretto? -- Le chiamate al modello, le chiamate agli strumenti e le decisioni delle policy stanno arrivando in ordine? +- L'agent previsto sta segnalando all'ambiente corretto? +- Le chiamate ai modelli, le chiamate agli strumenti e le decisioni sulle policy arrivano in ordine? - La sessione ha smesso di fare progressi o ha iniziato a ripetere un'azione? -I tipi di evento includono eventi del ciclo di vita dell'agente, richieste e risposte del modello, utilizzo e risultati degli strumenti, esecuzione degli hook, attese e interruzioni umane ed errori espliciti. Gli ID di correlazione collegano gli eventi accoppiati come una chiamata a uno strumento e il suo risultato. +I tipi di evento includono eventi del ciclo di vita dell'agent, richieste e risposte dei modelli, utilizzo e risultati degli strumenti, esecuzione degli hook, attese umane e interrupt, ed errori espliciti. Gli ID di correlazione collegano eventi associati come una chiamata a uno strumento e il suo risultato. - Mantieni la visualizzazione in diretta ampia durante la verifica di una nuova integrazione. Aggiungi filtri solo dopo aver visto il primo evento; un filtro non corretto può sembrare un'acquisizione fallita. + Mantieni la vista in diretta ampia durante la verifica di una nuova integrazione. Aggiungi filtri solo dopo aver visto il primo evento; un filtro errato potrebbe sembrare un'acquisizione fallita. -Se non compaiono eventi, esegui `failproofai config --status`, quindi [risolvi i problemi di acquisizione](/it/reference/troubleshooting). \ No newline at end of file +Se non vengono visualizzati eventi, esegui `failproofai config --status`, quindi [risolvi i problemi di acquisizione](/it/reference/troubleshooting). + +Gli agent che non vengono eseguiti in uno dei 12 [harness](/it/reference/harnesses) supportati segnalano gli stessi tipi di evento tramite [Python SDK](/it/reference/python-sdk), inclusi gli eventi di interazione umana (`human_wait`, `human_input`, `human_interrupt`) su cui dipendono gli agent del gateway e di produzione. \ No newline at end of file diff --git a/docs/it/sessions/overview.mdx b/docs/it/sessions/overview.mdx index 55747f5c9..d82edf801 100644 --- a/docs/it/sessions/overview.mdx +++ b/docs/it/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "Sessioni" -description: "Inizia con il record completo di un'esecuzione agente." +description: "Inizia con il registro completo di un'esecuzione di agente." icon: "workflow" --- -Una sessione è il miglior punto di partenza quando un agente si comporta in modo inaspettato. Riunisce le richieste al modello, le risposte, le chiamate agli strumenti, le interazioni umane, gli errori, le valutazioni e le decisioni politiche che appartengono a un'esecuzione. +Una sessione è il punto di partenza migliore quando un agente si comporta in modo inaspettato. Raggruppa le richieste del modello, le risposte, le chiamate ai tool, le interazioni umane, gli errori, le valutazioni e le decisioni di policy che appartengono a un'esecuzione. + +Le sessioni hanno lo stesso aspetto indipendentemente dal framework che le ha prodotte. Un'esecuzione Claude Code che riscrive un repository, un agente Hermes che risponde a un cliente su Slack e un servizio Python strumentato con l'SDK finiscono tutti nello stesso formato di traccia, così una sola visualizzazione copre l'intera flotta.
-Segui un'esecuzione agente dal suo obiettivo attraverso le chiamate al modello, gli strumenti e la risposta finale. +Segui un'esecuzione di agente dal suo obiettivo attraverso le chiamate al modello, i tool e la risposta finale. -## Trova una sessione +## Trovare una sessione 1. Nella barra laterale Cloud, vai a **Observe → Sessions**. 2. Imposta la finestra temporale, quindi filtra per ambiente, stato, agente o ID sessione. 3. Aggiungi intervalli di punteggio o metrica quando hai bisogno di una sezione per qualità, costo, token o latenza. - 4. Seleziona una riga per aprire la sua traccia. Usa il controllo di copia accanto all'ID sessione quando la condividi. + 4. Seleziona una riga per aprire la sua traccia. Usa il controllo di copia accanto all'ID della sessione quando la condividi. - ![L'elenco Sessions che mostra una riga per esecuzione con filtri per ambiente, agente, stato e punteggio di valutazione.](/images/dashboard/sessions-list.png) + ![L'elenco delle sessioni che mostra una riga per ogni esecuzione con filtri di ambiente, agente, stato e punteggio di valutazione.](/images/dashboard/sessions-list.png) ```bash @@ -30,26 +32,26 @@ Segui un'esecuzione agente dal suo obiettivo attraverso le chiamate al modello, fp --json sessions --session-id ``` - Aggiungi `--agents` per espandere le esecuzioni multi-agente, `--all` per impaginare, o `--fields` per scegliere le colonne di output. + Aggiungi `--agents` per espandere esecuzioni multi-agente, `--all` per impaginare, o `--fields` per scegliere le colonne di output. -## Quello che puoi fare +## Cosa puoi fare -- Trova un'esecuzione per agente, ambiente, ora, modello, tipo di evento o stato di errore. -- Segui la sequenza esatta che ha prodotto un risultato. -- Confronta esecuzioni riuscite e fallite. -- Apri le prove utilizzate da un risultato di audit o da un incidente di avviso. -- Esporta una sessione quando hai bisogno di un record offline. +- Trovare un'esecuzione per agente, ambiente, ora, modello, tipo di evento o stato di errore. +- Seguire la sequenza esatta che ha prodotto un risultato. +- Confrontare esecuzioni riuscite e fallite. +- Aprire le prove utilizzate da un risultato di audit o da un incidente di avviso. +- Esportare una sessione quando hai bisogno di un record offline. ## Un ordine di indagine affidabile 1. Conferma l'obiettivo della sessione e l'ambiente. -2. Trova il primo errore o la prima decisione inaspettata—non solo il fallimento finale. -3. Ispeziona il contesto del modello e l'input dello strumento immediatamente prima. -4. Controlla i tentativi, la latenza e le interruzioni umane. -5. Rivedi i punteggi di valutazione e le decisioni politiche. +2. Trova il primo errore o la prima decisione inaspettata, non solo il fallimento finale. +3. Ispeziona il contesto del modello e l'input del tool immediatamente prima. +4. Verifica i tentativi, la latenza e gli interrupt umani. +5. Rivedi i punteggi di valutazione e le decisioni di policy. - + Scopri come passare dal riepilogo della sessione all'evento che ha causato il risultato. \ No newline at end of file diff --git a/docs/it/start/quickstart.mdx b/docs/it/start/quickstart.mdx index 7954e98a2..28d4d0a0f 100644 --- a/docs/it/start/quickstart.mdx +++ b/docs/it/start/quickstart.mdx @@ -1,15 +1,17 @@ --- title: "Avvio rapido" -description: "Cattura una sessione di agente, trova un errore e inizia a prevenirlo." +description: "Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo." icon: "zap" --- -Questo avvio rapido configura una macchina per segnalare sessioni, esegue un audit e distribuisce una policy. Usa la skill per configurare Failproof AI, oppure segui i passaggi manuali. Ti serve Node.js versione 20.9 o successiva. +Questo avvio rapido configura una macchina per segnalare sessioni, esegue un audit e distribuisce una policy. Utilizza la skill per configurare Failproof, oppure segui i passaggi manuali. + +**Quale percorso è il tuo?** Se il tuo agente gira in uno dei 12 [harness](/it/reference/harnesses) supportati — una CLI di coding, o un gateway come Hermes o OpenClaw — segui i passaggi seguenti; hai bisogno di Node.js 20.9 o versioni successive. Se il tuo agente non ha un harness, strumentalo con l'[SDK Python](/it/reference/python-sdk) per il tracing e gli audit, quindi riprendi da [Esegui il tuo primo controllo di errore](/it/start/first-audit); l'enforcement su quel percorso necessita un hook nel tuo runtime. - + - + ```bash npx skills add FailproofAI/skills ``` @@ -19,16 +21,16 @@ Questo avvio rapido configura una macchina per segnalare sessioni, esegue un aud Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - Il tuo agente ispeziona il progetto, sceglie l'integrazione rilevante, esegue la configurazione e la verifica. Consulta il [repository delle skill di FailproofAI](https://github.com/FailproofAI/skills) per le skill individuali e le opzioni di installazione avanzate. + Il tuo agente ispeziona il progetto, sceglie l'integrazione pertinente, esegue la configurazione e la verifica. Consulta il [repository delle skill FailproofAI](https://github.com/FailproofAI/skills) per le singole skill e le opzioni di installazione avanzate. ## Prima di iniziare -1. Apri la [dashboard di Failproof AI](https://app.befailproof.ai) e crea un account o accedi con la tua email di lavoro. -2. Vai a **Administration → Keys** e crea una chiave con i permessi `events:add` e `policies:pull`. -3. Copia il segreto monouso e memorizzalo sulla macchina di destinazione: +1. Apri la [dashboard Failproof AI](https://app.befailproof.ai) e crea un account o accedi con la tua email aziendale. +2. Vai a **Administration → Keys** e crea una chiave con `events:add` e `policies:pull`. +3. Copia il secret monouso e salvalo sulla macchina target: ```bash export FAILPROOFAI_KEY="" @@ -43,9 +45,9 @@ export FAILPROOFAI_KEY="" failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - I transcript delle sessioni vengono inviati per impostazione predefinita. Aggiungi `--no-transcripts` per segnalare l'attività degli hook e le decisioni delle policy senza il contenuto dei transcript. + I transcript di sessione vengono inviati per impostazione predefinita. Aggiungi `--no-transcripts` per segnalare l'attività dell'hook e le decisioni delle policy senza contenuto di transcript. - Se questa macchina ha già una cronologia di agente, visualizza in anteprima e importa gli ultimi sette giorni, quindi attendi il completamento della consegna. Salta questo passaggio su una macchina nuova. + Se questa macchina ha già una cronologia di agenti, visualizza in anteprima e importa gli ultimi sette giorni, quindi attendi il completamento della consegna. Salta questo passaggio su una macchina nuova. ```bash failproofai backfill --since 7d --dry-run @@ -55,20 +57,23 @@ export FAILPROOFAI_KEY="" Apri **Sessions** in Failproof AI e seleziona una sessione importata. - - Questo collega Failproof AI alla tua CLI dell'agente e installa le policy integrate. Usale per vedere le decisioni delle policy locali e provare l'enforcement prima che Failproof AI auditi le tue sessioni e scriva policy per i tuoi agenti. + + Questo collega Failproof AI al tuo harness e installa le 40 policy built-in. Utilizzale per vedere le decisioni di policy locali e provare l'enforcement prima che Failproof AI auditi le tue sessioni e scrivi policy per i tuoi agenti. - Lascia che il programma di installazione rilevi la tua CLI dell'agente, oppure specificane una esplicitamente. + Lascia che il programma di installazione rilevi il tuo harness, oppure specificane uno esplicitamente. Ognuno dei 12 è un valore `--cli` valido — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # una CLI di coding + failproofai policies --install --cli hermes --scope user # un gateway Slack/Telegram ``` + + Il blocco di una chiamata di tool prima dell'esecuzione è verificato su tutti e 12. I gate di fine turno sono verificati su 8 — consulta [capacità di enforcement](/it/reference/harnesses#enforcement-capability) per la matrice per-harness. - Segui [Esegui il tuo primo controllo di errore](/it/start/first-audit). Usa un obiettivo concreto come "trovare sessioni dove l'agente ha ritentato uno strumento fallito senza cambiare il suo approccio." + Segui [Esegui il tuo primo controllo di errore](/it/start/first-audit). Utilizza un obiettivo concreto come ad esempio "trovare sessioni dove l'agente ha ritentato uno strumento non riuscito senza cambiare il suo approccio." - Segui [Previeni il tuo primo errore con una policy](/it/start/first-policy). Inizia in modalità di osservazione, ispeziona i risultati corrispondenti, quindi applica la versione esaminata. + Segui [Previeni il tuo primo errore con una policy](/it/start/first-policy). Inizia in modalità di osservazione, ispeziona i corrispondenti, quindi applica l'enforce della versione revisionata. diff --git a/docs/ja/index.mdx b/docs/ja/index.mdx index b31456176..e7c061fcb 100644 --- a/docs/ja/index.mdx +++ b/docs/ja/index.mdx @@ -1,39 +1,41 @@ --- title: "エージェントをフェイルプルーフにする" -description: "Failproof AI はエージェントの動作をトレースし、セッションの失敗を監査し、再発を防ぐポリシーをデプロイします。" +description: "コーディングCLI、チャットゲートウェイ、セルフホスト型アシスタント、独自のインストルメント済みエージェントなど、あらゆるハーネスに対応したオブザーバビリティと制御の仕組みです。" icon: "shield-check" --- -Failproof AI は、エージェントが何をしたかを把握し、失敗箇所を特定し、同じ動作が再発する前に安全策をデプロイするためにチームを支援します。 +Failproof AI は、エージェントが何をしたかを把握し、どこで失敗したかを特定し、同じ問題が再発する前に安全策を展開するためのツールです。 + +**ハーネス**とは、エージェントが実際に動作する実行環境のことです。Failproof AI は Claude Code や Codex などのコーディングCLI、Hermes などのチャットゲートウェイ、OpenClaw などのセルフホスト型アシスタントを含む12種類のハーネスに対応しており、すべてに同じイベント・ポリシー・セッション履歴が適用されます。ハーネスを使用しないエージェントは [Python SDK](/ja/reference/python-sdk) 経由でトレースと監査を行いますが、そこでポリシーを強制するには独自のランタイムにフックを実装する必要があります。 - - スキルを使ってプロジェクトにインスツルメンテーションを行い、接続して、エージェントのログが届いていることを確認します。 + + スキルを使ってプロジェクトをインストルメントし、接続して、エージェントログが届いていることを確認します。 - + エージェントログに対して自然言語で分析・クエリ・ダッシュボード作成・監査を実行します。 - - モデルの呼び出し、ツール、エラー、人間の入力、レイテンシー、ポリシーの判断を1つのセッションで追跡します。 + + モデル呼び出し、ツール、エラー、人間の入力、レイテンシ、ポリシーの判断を1つのセッションで追跡します。 - - 定義されたセッションセットを監査し、根拠に基づいた発見事項をレビューし、課題として修正状況を追跡します。 + + 定義されたセッションセットを監査し、根拠に基づく知見をレビューし、課題として修正状況を追跡します。 - 既知の失敗パターンをポリシーに変換し、その影響を観察して、フリート全体にデプロイします。 + 既知の障害パターンをポリシーに変換し、その影響を観察して、フリート全体に展開します。 -> **セッション → 監査 → 発見事項 → 課題 → ポリシー**
-> 何が起きたかをトレースし、失敗を特定し、対応を管理し、将来の実行で同じ動作が起きないよう防止します。 +> **セッション → 監査 → 知見 → 課題 → ポリシー**
+> 何が起きたかをトレースし、障害を特定し、対応を管理して、将来の実行で同じ問題が起きないようにします。 -## まずはここから +## はじめに -初めてインスツルメンテーション済みエージェントをデプロイする場合は、[クイックスタート](/ja/start/quickstart)から始めてください。すでにデータが届いている場合は、[Sessions](/ja/sessions/overview) を開いて実際の実行を確認してから、監査やポリシーの設定を行ってください。 +初めてインストルメント済みエージェントをデプロイする場合は、[クイックスタート](/ja/start/quickstart)から始めてください。データがすでに届いている場合は、[セッション](/ja/sessions/overview)を開いて、監査やポリシーを設定する前に実際の実行結果を確認してください。 - - キャプチャから安全にデプロイされたポリシーまでのエンドツーエンドのワークフローを完了します。 + + キャプチャから安全にデプロイされたポリシーまで、エンドツーエンドのワークフローを完了します。 \ No newline at end of file diff --git a/docs/ja/reference/harnesses.mdx b/docs/ja/reference/harnesses.mdx index ead0c6ab2..7924231d5 100644 --- a/docs/ja/reference/harnesses.mdx +++ b/docs/ja/reference/harnesses.mdx @@ -1,64 +1,71 @@ --- title: "エージェントハーネス" -description: "対応するエージェントCLIでセッションをキャプチャし、ポリシーを適用します。" +description: "サポートされている12のエージェントハーネス全体でセッションをキャプチャし、ポリシーを適用します。" icon: "plug-zap" --- -Failproof AI は Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi、Hermes、OpenClaw、Factory Droid、Devin CLI、Antigravity CLI、および Goose をサポートしています。 +ハーネスとは、エージェントが実際に動作する環境のことです。Failproof AI は12種類のハーネスを2つのクラスに分けてサポートしています。 -| ハーネス | サポートされるフックスコープ | +- **コーディングCLI**（10種）— Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi、Factory Droid、Devin CLI、Antigravity CLI、Goose +- **チャット・アシスタントゲートウェイ**（2種）— Hermes（Slack、Telegram、cron）、OpenClaw（セルフホスト型アシスタント） + +どのハーネスでエージェントが動作していても、同じポリシーと同じセッション履歴が適用されます。アダプター層が各ハーネスのネイティブイベント名、ツール名、ツール入力フィールドを29の標準イベントにマッピングしてから、ポリシーが実行されます。 + +12種類のいずれにも属さないエージェントは、[Python SDK](/ja/reference/python-sdk) を使って直接インスツルメントします。これは別のコントラクトであり、明確に説明しておく価値があります。SDKはトレーシング、セッション、評価、監査を提供しますが、**それ自体ではポリシーを適用しません。** 安全でないアクションが実行される前にブロックするには、ランタイムのツール境界にエンフォースメントフックが必要です。[お問い合わせ](mailto:support@befailproof.ai)いただければ、マッピングをご支援します。 + +| ハーネス | サポートされているフックスコープ | | --- | --- | -| Claude Code | ユーザー、プロジェクト、ローカル | -| Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi | ユーザー、プロジェクト | -| Factory Droid、Devin CLI、Antigravity CLI、Goose | ユーザー、プロジェクト | -| Hermes、OpenClaw | ユーザー | +| Claude Code | User、project、local | +| Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi | User、project | +| Factory Droid、Devin CLI、Antigravity CLI、Goose | User、project | +| Hermes、OpenClaw | User | -各インテグレーションは、ポリシーが実行される前に、ネイティブのフックイベント名、ツール名、ツール入力フィールドを正規化します。ポリシーはハーネスが公開するイベントにのみ作用できます。ターン終了時の動作やインストラクションの挙動は、実際にデプロイするハーネスとバージョンで必ずテストしてください。 +各インテグレーションは、ポリシーが実行される前にネイティブフックイベント名、ツール名、ツール入力フィールドを正規化します。ポリシーはハーネスが公開するイベントに対してのみ作用します。ターン終了時の動作やインストラクションの動作は、デプロイする実際のハーネスとバージョンでテストしてください。 -## 適用能力 +## エンフォースメント機能 -「ブロック」とは、現在のアダプターが返した判定が、指定のハーネスによって消費されることを意味します。ポストツールのブロックはモデルに表示される結果を差し替えることができますが、すでに発生したツールの副作用を元に戻すことはできません。 +「ブロック」とは、現在のアダプターが返す評決が、指定されたハーネスによって消費されることを意味します。ポストツールブロッキングはモデルに表示される結果を置き換えることができますが、すでに発生したツールの副作用を取り消すことはできません。 -| ハーネス | 検証済みのブロックイベント | 観察専用または非ブロックの注意事項 | +| ハーネス | 検証済みブロッキングイベント | 観察のみまたは非ブロッキングの注意事項 | | --- | --- | --- | -| Claude Code | `PreToolUse`、`UserPromptSubmit`、`PermissionRequest`、`Stop`、`SubagentStop`、`PreCompact`、およびいくつかのタスク/設定イベント | `PostToolUse`、セッションライフサイクル、通知、および失敗後のイベントは観察専用です。 | -| Codex | `PreToolUse`、`PermissionRequest`、`UserPromptSubmit`、`Stop`、`SubagentStop`、`PostToolUse` | ポストツールのブロックは実行後に結果を差し替えます。セッション開始とコンパクトイベントは現在のアダプターでは観察専用です。 | -| GitHub Copilot CLI | `PreToolUse`、`UserPromptSubmit`、`PermissionRequest`、`Stop`、`SubagentStop`、`PostToolUse` | ポストツールのブロックは実行後に結果を差し替えます。セッションと通知イベントは観察専用です。 | -| Cursor | `PreToolUse`、`UserPromptSubmit`、`Stop` | `PostToolUse` とセッションイベントは観察専用です。 | -| OpenCode | `PreToolUse` | ポストツールおよびライフサイクルイベントは観察専用です。現在のストップ処理は、検証済みゲートではなく後続ターンへのガイダンスとして機能します。 | -| Pi | `PreToolUse`、`UserPromptSubmit` | ポストツールおよびライフサイクルイベントは観察専用です。ストップのガイダンスは後続ターンに適用されます。 | -| Hermes | `PreToolUse` | ポストツール、セッション、サブエージェントストップの判定はゲートとして機能しません。 | -| OpenClaw | `PreToolUse`、`UserPromptSubmit`、`Stop` | ポストツール、セッション、サブエージェントストップ、およびコンパクションイベントは観察専用です。 | -| Factory Droid | `PreToolUse`、`UserPromptSubmit`、`Stop`、`PreCompact` | ポストツールおよびサブエージェントストップの判定は観察専用です。 | -| Devin CLI | `PreToolUse`、`UserPromptSubmit`、`Stop`、条件付き `PermissionRequest` | パーミッションフックはすべてのパーミッションモードで実行されるわけではありません。ポストツールおよびセッションイベントは観察専用です。 | -| Antigravity CLI | `PreToolUse`、`Stop` | ユーザープロンプトおよびポストツールの判定は観察専用です。プロンプトへのインストラクション注入は引き続き可能です。 | -| Goose | `PreToolUse` | ユーザープロンプト、ポストツール、およびセッションイベントは観察専用です。ネイティブのブロッキングストップフックが上流に存在しますが、現在のアダプターではインストールされていません。 | - -各機能はバージョンに依存します。エージェントCLIをアップグレードした後は、特にポリシーが共通のプリツールゲートではなく、プロンプト・ストップ・パーミッション・ポストツールの挙動に依存している場合は、必ず再テストしてください。 +| Claude Code | `PreToolUse`、`UserPromptSubmit`、`PermissionRequest`、`Stop`、`SubagentStop`、`PreCompact`、およびいくつかのタスク/設定イベント | `PostToolUse`、セッションライフサイクル、通知、失敗後のイベントは観察のみです。 | +| Codex | `PreToolUse`、`PermissionRequest`、`UserPromptSubmit`、`Stop`、`SubagentStop`、`PostToolUse` | ポストツールブロッキングは実行後に結果を置き換えます。セッション開始とコンパクトイベントは現在のアダプターでは観察のみです。 | +| GitHub Copilot CLI | `PreToolUse`、`UserPromptSubmit`、`PermissionRequest`、`Stop`、`SubagentStop`、`PostToolUse` | ポストツールブロッキングは実行後に結果を置き換えます。セッションと通知イベントは観察のみです。 | +| Cursor | `PreToolUse`、`UserPromptSubmit`、`Stop` | `PostToolUse` とセッションイベントは観察のみです。 | +| OpenCode | `PreToolUse` | ポストツールおよびライフサイクルイベントは観察のみです。現在の停止処理は検証済みゲートではなく、後のターンへのガイダンスです。 | +| Pi | `PreToolUse`、`UserPromptSubmit` | ポストツールおよびライフサイクルイベントは観察のみです。停止ガイダンスは後のターンに適用されます。 | +| Hermes | `PreToolUse` | ポストツール、セッション、サブエージェント停止の評決はゲートではありません。 | +| OpenClaw | `PreToolUse`、`UserPromptSubmit`、`Stop` | ポストツール、セッション、サブエージェント停止、コンパクションイベントは観察のみです。 | +| Factory Droid | `PreToolUse`、`UserPromptSubmit`、`Stop`、`PreCompact` | ポストツールとサブエージェント停止の評決は観察のみです。 | +| Devin CLI | `PreToolUse`、`UserPromptSubmit`、`Stop`、条件付き `PermissionRequest` | パーミッションフックはすべてのパーミッションモードで動作するわけではありません。ポストツールとセッションイベントは観察のみです。 | +| Antigravity CLI | `PreToolUse`、`Stop` | ユーザープロンプトとポストツールの評決は観察のみです。プロンプトインストラクションは引き続き注入できます。 | +| Goose | `PreToolUse` | ユーザープロンプト、ポストツール、セッションイベントは観察のみです。ネイティブのブロッキング停止フックが上流に存在しますが、現在のアダプターではインストールされていません。 | + +機能はバージョンに依存します。エージェントCLIをアップグレードした後は、特にポリシーが共通のプリツールゲートではなく、プロンプト、停止、パーミッション、またはポストツールの動作に依存している場合は、再テストしてください。 ## キャプチャとポリシーフックのインストール - 1. **Administration → Keys** を開き、マシンまたは環境の名前を付けた `events:add` および `policies:pull` 権限を持つキーを作成します。 + 1. **Administration → Keys** を開き、`events:add` と `policies:pull` の権限を持つキーをマシンまたは環境の名前で作成します。 2. 対象マシンで、表示されたキーを使ってローカルCLIを接続し、ハーネスフックをインストールします。 - 3. 新しいエージェントセッションを開始し、**Observe → Events** でフックとセッションイベントを確認します。 - 4. 同じ時間帯の **Observe → policy** を開き、そのマシンに紐付いたポリシー判定を確認します。 + 3. 新しいエージェントセッションを開始し、**Observe → Events** でそのフックとセッションイベントを確認します。 + 4. 同じ時間枠で **Observe → policy** を開き、ポリシー決定がそのマシンに帰属していることを確認します。 - 接続はマシンキーから始まります。シークレットをコピーする前に、インジェストとポリシー配信の両方の権限が含まれていることを確認してください。 + 接続はマシンキーから始まります。シークレットをコピーする前に、インジェスションとポリシー配信の両方の権限が含まれていることを確認してください。 - ![イベントインジェストとポリシー配信の権限を付与するために使用する新規APIキードロワー。](/images/dashboard/key-create.png) + ![イベントインジェストとポリシー配信の権限を付与するために使用する新しいAPIキードロワー。](/images/dashboard/key-create.png) - フックをインストールした後、Eventsストリームに接続したマシンと環境からの新しいイベントが表示されるはずです。 + フックをインストールした後、Events ストリームには接続したマシンと環境からの新しいイベントが表示されるはずです。 - ![新たにインストールされたハーネスがレポートしていることを確認するために使用するライブEventsストリーム。](/images/dashboard/events-stream.png) + ![新しくインストールされたハーネスが報告しているかどうかを確認するためのライブEventsストリーム。](/images/dashboard/events-stream.png) - 最後に、ポリシー判定が同じマシンに紐付いていることを確認します。これにより、ハーネスがトレースイベントだけでなくポリシーアクティビティもレポートしていることが確認できます。 + 最後に、ポリシー決定が同じマシンに帰属していることを確認します。これにより、ハーネスがトレースイベントだけでなくポリシーアクティビティも報告していることが確認できます。 - ![新たに接続されたハーネスからのポリシー判定を確認するために使用するPolicyページ。](/images/dashboard/policy-observe.png) + ![新しく接続されたハーネスからのポリシー決定を確認するためのPolicyページ。](/images/dashboard/policy-observe.png) - 検出されたすべてのハーネスにフックをインストールします： + 検出されたすべてのハーネスにフックをインストールします。 ```bash failproofai config \ @@ -67,7 +74,7 @@ Failproof AI は Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、 failproofai policies --install ``` - または、特定のハーネスと設定スコープを指定します： + または、特定のハーネスと設定スコープを指定します。 ```bash failproofai policies --install \ @@ -75,9 +82,9 @@ Failproof AI は Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、 --scope user ``` - プロジェクトスコープはリポジトリにフック設定を保持します。ユーザースコープはリポジトリをまたいだ作業をカバーします。Claude Code はローカルスコープもサポートしていますが、サポート状況はハーネスによって異なり、CLIはサポートされていない組み合わせを拒否します。 + プロジェクトスコープはフック設定をリポジトリと一緒に保持します。ユーザースコープはリポジトリをまたいだ作業をカバーします。Claude Code はローカルスコープもサポートしていますが、サポート状況はハーネスによって異なり、CLIはサポートされていない組み合わせを拒否します。 - マシンとそのイベントを確認します： + マシンとそのイベントを確認します。 ```bash failproofai config --status @@ -91,12 +98,12 @@ Failproof AI は Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、 - 追加パスはクラウドではなくマシン上に登録されます。追加後は **Observe → Sessions** を開き、マシンの環境でフィルタリングして、新しいパスからのセッションが表示されることを確認します。セッションを開き、監査で使用する前にエージェント、ハーネス、イベントのタイムスタンプを確認してください。 + 追加パスはクラウドではなくマシン上で登録されます。追加した後、**Observe → Sessions** を開き、マシンの環境でフィルタリングして、新しいパスからのセッションが表示されることを確認します。監査で使用する前に、セッションを開いてエージェント、ハーネス、イベントのタイムスタンプを確認してください。 - ![追加キャプチャパスからデータを受信している環境にフィルタリングされたSessionsリスト。](/images/dashboard/sessions-list.png) + ![追加のキャプチャパスからデータを受信している環境にフィルタリングされたSessionsリスト。](/images/dashboard/sessions-list.png) - オプションのラベルを付けてパスを追加し、設定済みのパスを確認します： + オプションのラベルを付けてパスを追加し、設定済みのパスを確認します。 ```bash failproofai harness add-path claude checkout=/srv/checkout/.claude @@ -105,10 +112,10 @@ Failproof AI は Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、 failproofai backfill --since 7d ``` - `failproofai harness remove-path claude checkout` でパスを削除します。 + パスを削除するには `failproofai harness remove-path claude checkout` を使用します。 - インストール後に新しいセッションを1つ実行してください。ロールアウトを拡大する前に、ライブイベントストリームと実際のポリシー判定の両方を確認してください。 + インストール後に新しいセッションを1つ実行してください。ロールアウトを拡大する前に、ライブイベントストリームと実際のポリシー決定の両方を確認してください。 \ No newline at end of file diff --git a/docs/ja/sessions/live-events.mdx b/docs/ja/sessions/live-events.mdx index 537ffacea..74a0aa5c2 100644 --- a/docs/ja/sessions/live-events.mdx +++ b/docs/ja/sessions/live-events.mdx @@ -1,21 +1,21 @@ --- title: "ライブイベント" -description: "セッション実行中にエージェントのアクティビティをリアルタイムで確認します。" +description: "セッション実行中にエージェントのアクティビティをリアルタイムで確認できます。" icon: "radio" --- -ライブイベントを使えば、インストゥルメンテーションの確認や、リスクの高い実行をセッション終了を待たずにモニタリングできます。 +ライブイベントを使用すると、インストルメンテーションの確認や、リスクのある実行をセッション終了を待たずに監視できます。 -## アクティビティを確認する +## アクティビティの監視 1. **Observe → Events** に移動します。 - 2. 現在の時間ウィンドウとフィルターなしの状態から始めて、データが届いていることを確認します。 - 3. 環境、イベントタイプ、エージェント、またはセッションでフィルタリングします。ペイロードテキストの検索にはサーチ機能を使用します。 - 4. イベントを選択して概要と詳細を確認します。セッションリンクをたどると完全なトレースを参照できます。 + 2. 現在の時間ウィンドウでフィルターなしから始め、データが届いていることを確認します。 + 3. 環境、イベントタイプ、エージェント、またはセッションでフィルタリングします。ペイロードテキストの検索にはサーチを使用してください。 + 4. イベントを選択して概要と詳細を確認します。セッションリンクをたどると完全なトレースが表示されます。 - ![時刻、環境、イベントタイプ、エージェント、モデル、コンテキスト、セッション、テキストフィルターを備えたライブイベントストリーム。](/images/dashboard/events-stream-current.png) + ![Hermes チャットゲートウェイのトラフィックとコーディング CLI の実行をリアルタイムで表示するイベントストリーム。時間、環境、イベントタイプ、エージェント、モデル、コンテキスト、セッションでフィルタリング可能。](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ icon: "radio" fp --json events --full --session-id --all ``` - デフォルトのフィードは生のペイロードを省略します。`--full` は範囲が限定されたセッションの調査にのみ使用してください。 + デフォルトのフィードでは生のペイロードは省略されます。`--full` は範囲を限定したセッション調査のみに使用してください。 -イベントストリームを使用して、次の3つの疑問にすぐ答えられます。 +イベントストリームを使用して、次の3つの即時的な疑問に答えられます。 -- 対象のエージェントが正しい環境にレポートしているか？ -- モデルの呼び出し、ツールの呼び出し、ポリシーの判断が正しい順序で届いているか？ -- セッションが進捗を停止したり、同じアクションを繰り返し始めたりしていないか？ +- 期待されるエージェントが正しい環境に報告しているか？ +- モデル呼び出し、ツール呼び出し、ポリシー決定が順番に届いているか？ +- セッションが進行を停止したり、同じアクションを繰り返し始めていないか？ -イベントタイプには、エージェントのライフサイクルイベント、モデルのリクエストとレスポンス、ツールの使用と結果、フックの実行、人間の待機と割り込み、明示的なエラーが含まれます。相関IDは、ツール呼び出しとその結果など、対応するイベントを紐付けます。 +イベントタイプには、エージェントのライフサイクルイベント、モデルのリクエストとレスポンス、ツールの使用と結果、フックの実行、ヒューマンウェイトと割り込み、明示的なエラーが含まれます。ツール呼び出しとその結果などのペアイベントは相関IDで紐付けられます。 - 新しいインテグレーションを確認する際は、ライブビューを広い範囲のまま維持してください。最初のイベントが表示されてからフィルターを追加しましょう。誤ったフィルターを設定すると、インジェストに失敗しているように見えることがあります。 + 新しいインテグレーションを検証する際は、ライブビューを広い範囲で表示したままにしてください。最初のイベントを確認してからフィルターを追加してください。誤ったフィルターはインジェスションの失敗と見分けがつかないことがあります。 -イベントが表示されない場合は、`failproofai config --status` を実行してから、[インジェストのトラブルシューティング](/ja/reference/troubleshooting)を参照してください。 \ No newline at end of file +イベントが表示されない場合は、`failproofai config --status` を実行してから、[インジェスションのトラブルシューティング](/ja/reference/troubleshooting)を参照してください。 + +サポートされている12種類の[ハーネス](/ja/reference/harnesses)のいずれかで実行されないエージェントも、[Python SDK](/ja/reference/python-sdk) を通じて同じイベントタイプを報告します。ゲートウェイや本番エージェントが依存するヒューマン・イン・ザ・ループイベント（`human_wait`、`human_input`、`human_interrupt`）も含まれます。 \ No newline at end of file diff --git a/docs/ja/sessions/overview.mdx b/docs/ja/sessions/overview.mdx index 4e4f5dc91..c7cbf6634 100644 --- a/docs/ja/sessions/overview.mdx +++ b/docs/ja/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "セッション" -description: "エージェント実行の完全な記録から調査を始めましょう。" +description: "エージェントの1回の実行記録全体を起点に調査を始める。" icon: "workflow" --- -セッションは、エージェントが予期しない動作をした際の最適な調査起点です。1回の実行に属するモデルのリクエスト・レスポンス、ツール呼び出し、人間との対話、エラー、評価、ポリシー判断をまとめて確認できます。 +セッションは、エージェントが予期しない動作をした際の最良の出発点です。1回の実行に属するモデルへのリクエスト、レスポンス、ツール呼び出し、人間との対話、エラー、評価、ポリシー決定を一か所に集約します。 + +セッションの表示形式は、どのハーネスが生成したかに関わらず統一されています。リポジトリを書き換える Claude Code の実行、Slack で顧客対応する Hermes エージェント、SDK でインストルメントされた Python サービス——いずれも同じトレース形式に格納されるため、1つのビューでフリート全体を把握できます。
-エージェントの1回の実行を、目標設定からモデル呼び出し、ツール使用、最終レスポンスまで一連の流れで追跡できます。 +エージェントの1回の実行を、目標設定からモデル呼び出し、ツール利用、最終レスポンスまで追跡します。 ## セッションを見つける - 1. クラウドのサイドバーで **Observe → Sessions** に移動します。 - 2. 時間範囲を設定し、環境・ステータス・エージェント・セッションIDでフィルタリングします。 - 3. 品質・コスト・トークン数・レイテンシで絞り込む場合は、スコアやメトリクスの範囲を追加します。 - 4. 行を選択してトレースを開きます。セッションIDの横にあるコピーボタンを使うと共有が簡単です。 + 1. Cloud サイドバーで **Observe → Sessions** に移動します。 + 2. 時間ウィンドウを設定し、環境・ステータス・エージェント・セッション ID でフィルタリングします。 + 3. 品質・コスト・トークン・レイテンシで絞り込む場合は、スコアやメトリクスの範囲を追加します。 + 4. 行を選択してトレースを開きます。セッション ID の横にあるコピーコントロールを使って共有できます。 - ![環境・エージェント・ステータス・評価スコアのフィルターとともに、実行ごとに1行表示されるセッション一覧。](/images/dashboard/sessions-list.png) + ![環境・エージェント・ステータス・評価スコアのフィルターとともに、1行1実行で表示されたセッション一覧。](/images/dashboard/sessions-list.png) ```bash @@ -30,26 +32,26 @@ icon: "workflow" fp --json sessions --session-id ``` - マルチエージェント実行を展開するには `--agents`、全件取得するには `--all`、出力カラムを選択するには `--fields` を追加します。 + `--agents` でマルチエージェント実行を展開、`--all` でページネーション、`--fields` で出力カラムを選択できます。 ## できること - エージェント・環境・時間・モデル・イベント種別・エラー状態でセッションを検索する。 -- ある結果を生み出した正確なイベントの順序を追う。 +- ある結果を生んだ正確な処理シーケンスを追跡する。 - 成功した実行と失敗した実行を比較する。 -- 監査結果やアラートインシデントで使用されたエビデンスを確認する。 +- 監査の発見事項やアラートインシデントで使用された証拠を開く。 - オフライン記録が必要な場合にセッションをエクスポートする。 -## 効果的な調査の手順 +## 信頼できる調査の順序 1. セッションの目標と環境を確認する。 -2. 最終的な失敗だけでなく、最初のエラーや予期しない判断を特定する。 -3. その直前のモデルコンテキストとツールの入力内容を確認する。 +2. 最終的な失敗だけでなく、最初のエラーや予期しない判断を見つける。 +3. その直前のモデルコンテキストとツール入力を調べる。 4. リトライ・レイテンシ・人間による割り込みを確認する。 -5. 評価スコアとポリシー判断をレビューする。 +5. 評価スコアとポリシー決定をレビューする。 - セッションのサマリーから結果の原因となったイベントへの追い方を学びましょう。 + セッションのサマリーから、結果を引き起こしたイベントへと辿る方法を学びます。 \ No newline at end of file diff --git a/docs/ja/start/quickstart.mdx b/docs/ja/start/quickstart.mdx index 1168481d2..52ed4487c 100644 --- a/docs/ja/start/quickstart.mdx +++ b/docs/ja/start/quickstart.mdx @@ -1,10 +1,12 @@ --- title: "クイックスタート" -description: "エージェントセッションをキャプチャし、障害を発見して、防止策を導入する。" +description: "エージェントセッションをキャプチャし、障害を発見して、その防止を開始する。" icon: "zap" --- -このクイックスタートでは、1台のマシンでセッションのレポートを開始し、監査を実行して、ポリシーを展開します。スキルを使って Failproof を設定するか、手動手順に従ってください。Node.js 20.9 以降が必要です。 +このクイックスタートでは、1台のマシンでセッションのレポートを開始し、監査を実行して、ポリシーをデプロイします。スキルを使って Failproof を設定するか、手動手順に従って進めてください。 + +**どちらの方法を選びますか？** エージェントが12のサポート対象[ハーネス](/ja/reference/harnesses)のいずれか（コーディング CLI、または Hermes や OpenClaw などのゲートウェイ）で動作している場合は、以下の手順に従ってください。Node.js 20.9 以降が必要です。エージェントにハーネスがない場合は、[Python SDK](/ja/reference/python-sdk) でトレースと監査のインストルメンテーションを行い、[最初の障害チェックを実行する](/ja/start/first-audit) から再合流してください。この場合の強制実行にはランタイムへのフックが必要です。 @@ -14,20 +16,20 @@ icon: "zap" npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - エージェントがプロジェクトを検査し、適切なインテグレーションを選択して、セットアップを実行し、動作を確認します。個別のスキルや高度なインストールオプションについては、[FailproofAI スキルリポジトリ](https://github.com/FailproofAI/skills)を参照してください。 + エージェントがプロジェクトを検査し、適切なインテグレーションを選択してセットアップを実行し、セッションの到達を確認します。個別のスキルと高度なインストールオプションについては [FailproofAI スキルリポジトリ](https://github.com/FailproofAI/skills) を参照してください。 - ## 始める前に + ## 開始前の準備 -1. [Failproof AI ダッシュボード](https://app.befailproof.ai)を開き、アカウントを作成するか、仕事用メールアドレスでサインインします。 -2. **Administration → Keys** に移動し、`events:add` と `policies:pull` の権限を持つキーを作成します。 +1. [Failproof AI ダッシュボード](https://app.befailproof.ai) を開き、アカウントを作成するか業務用メールでサインインします。 +2. **Administration → Keys** に移動し、`events:add` と `policies:pull` 権限を持つキーを作成します。 3. ワンタイムシークレットをコピーして、対象マシンに保存します。 ```bash @@ -43,7 +45,7 @@ export FAILPROOFAI_KEY="" failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - セッションのトランスクリプトはデフォルトで送信されます。トランスクリプトの内容を除いてフックのアクティビティとポリシーの決定のみをレポートするには、`--no-transcripts` を追加してください。 + セッションのトランスクリプトはデフォルトで送信されます。トランスクリプトの内容を除き、フックアクティビティとポリシー決定のみをレポートするには `--no-transcripts` を追加してください。 このマシンにすでにエージェントの履歴がある場合は、過去7日間のデータをプレビューしてインポートし、配信が完了するまで待ちます。新しいマシンではこの手順をスキップしてください。 @@ -53,27 +55,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - Failproof AI で **Sessions** を開き、インポートされたセッションを選択します。 + Failproof AI の **Sessions** を開き、インポートしたセッションを選択します。 - - これにより、Failproof AI がエージェント CLI に接続され、組み込みポリシーがインストールされます。Failproof AI がセッションを監査してエージェント向けのポリシーを作成する前に、ローカルでのポリシー決定を確認したり、適用をテストしたりするために活用してください。 + + これにより Failproof AI がハーネスにアタッチされ、40の組み込みポリシーがインストールされます。Failproof AI がセッションを監査してエージェント用のポリシーを作成する前に、ローカルでのポリシー決定を確認したり強制実行を試したりするのに活用してください。 - インストーラーにエージェント CLI を自動検出させるか、明示的に指定することもできます。 + インストーラーにハーネスを自動検出させるか、明示的に指定することもできます。12種類すべてが有効な `--cli` 値です。`claude`、`codex`、`copilot`、`cursor`、`opencode`、`pi`、`hermes`、`openclaw`、`factory`、`devin`、`antigravity`、`goose`。 ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # コーディング CLI + failproofai policies --install --cli hermes --scope user # Slack/Telegram ゲートウェイ ``` + + ツール呼び出しの実行前ブロックは全12種類で検証済みです。ターン終了ゲートは8種類で検証済みです。ハーネスごとのマトリックスは [強制実行機能](/ja/reference/harnesses#enforcement-capability) を参照してください。 - [初めての障害チェックを実行する](/ja/start/first-audit)に従ってください。「エージェントがアプローチを変えずに失敗したツールを再試行したセッションを見つける」など、具体的な目標を設定して行ってください。 + [最初の障害チェックを実行する](/ja/start/first-audit) に従ってください。「エージェントがアプローチを変えずに失敗したツールを再試行したセッションを見つける」などの具体的な目標を設定してください。 - [ポリシーで初めての障害を防止する](/ja/start/first-policy)に従ってください。オブザーブモードから始め、マッチしたものを確認してから、レビュー済みのバージョンを適用してください。 + [ポリシーを使って最初の障害を防止する](/ja/start/first-policy) に従ってください。オブザーブモードで開始し、マッチを確認してから、レビュー済みのバージョンを強制実行します。 - `failproofai config --status` を実行してください。正常なセットアップでは、クラウド接続、デーモンの状態、適用が一時停止中かどうかが報告されます。 + `failproofai config --status` を実行してください。正常なセットアップでは、クラウド接続、デーモンの状態、および強制実行が一時停止されているかどうかが表示されます。 \ No newline at end of file diff --git a/docs/ko/index.mdx b/docs/ko/index.mdx index 5eb4e8dad..ee34ded56 100644 --- a/docs/ko/index.mdx +++ b/docs/ko/index.mdx @@ -1,39 +1,41 @@ --- title: "에이전트를 안전하게 만드세요" -description: "Failproof AI는 에이전트 동작을 추적하고, 세션의 실패를 감사하며, 동일한 문제가 반복되지 않도록 정책을 배포합니다." +description: "코딩 CLI, 채팅 게이트웨이, 자체 호스팅 어시스턴트, 직접 계측한 에이전트 등 모든 하네스에 대한 관찰 가능성과 정책 적용." icon: "shield-check" --- -Failproof AI는 팀이 에이전트가 무엇을 했는지 파악하고, 어디서 실패했는지 찾아내며, 동일한 동작이 재발하기 전에 안전장치를 배포할 수 있도록 돕습니다. +Failproof AI는 팀이 에이전트가 무엇을 했는지 파악하고, 어디서 실패했는지 찾아내며, 동일한 동작이 다시 발생하기 전에 안전장치를 배포할 수 있도록 도와줍니다. + +**하네스**는 에이전트가 실제로 실행되는 환경을 의미합니다. Failproof AI는 Claude Code, Codex 같은 코딩 CLI, Hermes 같은 채팅 게이트웨이, OpenClaw 같은 자체 호스팅 어시스턴트 등 12가지 하네스를 지원하며, 동일한 이벤트, 동일한 정책, 동일한 세션 히스토리가 모든 하네스에 적용됩니다. 하네스가 없는 에이전트는 [Python SDK](/ko/reference/python-sdk)를 통해 보고하며, 이를 통해 추적 및 감사가 이루어집니다. 해당 환경에서 정책을 적용하려면 자체 런타임에 훅을 추가해야 합니다. - 스킬을 사용하여 프로젝트를 계측하고, 연결하고, 에이전트 로그가 정상적으로 수신되는지 확인하세요. + 스킬을 사용해 프로젝트를 계측하고, 연결하고, 에이전트 로그가 도착하는지 확인하세요. - + 에이전트 로그를 자연어로 분석하고, 쿼리하고, 대시보드를 만들고, 감사를 실행하세요. - - 하나의 세션에서 모델 호출, 도구, 오류, 사용자 입력, 지연 시간, 정책 결정을 추적하세요. + + 하나의 세션에서 모델 호출, 툴, 오류, 사람의 입력, 지연 시간, 정책 결정을 한눈에 확인하세요. - 정의된 세션 집합을 감사하고, 근거가 뒷받침된 발견 사항을 검토하며, 이슈로서 해결 과정을 추적하세요. + 정의된 세션 집합을 감사하고, 근거가 뒷받침된 발견 사항을 검토하며, 이슈로 해결 진행 상황을 추적하세요. - 알려진 실패 유형을 정책으로 전환하고, 영향을 관찰한 후 전체 플릿에 배포하세요. + 알려진 실패 패턴을 정책으로 전환하고, 영향을 관찰하며, 전체 플릿에 배포하세요. > **세션 → 감사 → 발견 사항 → 이슈 → 정책**
-> 무슨 일이 있었는지 추적하고, 실패를 찾아내고, 대응을 관리한 다음, 향후 실행에서 동일한 동작을 방지하세요. +> 무슨 일이 있었는지 추적하고, 실패를 찾아내고, 대응을 관리한 다음, 이후 실행에서 동일한 동작이 반복되지 않도록 방지하세요. ## 시작하기 -처음으로 계측된 에이전트를 배포하는 경우 [빠른 시작](/ko/start/quickstart)부터 시작하세요. 데이터가 이미 수신되고 있다면 [세션](/ko/sessions/overview)을 열어 감사나 정책을 구성하기 전에 실제 실행을 먼저 검토해 보세요. +처음으로 계측된 에이전트를 배포하는 경우, [퀵스타트](/ko/start/quickstart)부터 시작하세요. 데이터가 이미 들어오고 있다면 [Sessions](/ko/sessions/overview)를 열어 감사나 정책을 설정하기 전에 실제 실행 결과를 먼저 확인하세요. - - 캡처부터 안전하게 배포된 정책까지 전체 워크플로를 완료하세요. + + 캡처에서 안전하게 배포된 정책까지 전체 엔드투엔드 워크플로우를 완료하세요. \ No newline at end of file diff --git a/docs/ko/reference/harnesses.mdx b/docs/ko/reference/harnesses.mdx index 37e300d4c..a2eb7a731 100644 --- a/docs/ko/reference/harnesses.mdx +++ b/docs/ko/reference/harnesses.mdx @@ -1,64 +1,71 @@ --- title: "에이전트 하네스" -description: "지원되는 에이전트 CLI에서 세션을 캡처하고 정책을 적용합니다." +description: "지원되는 12개의 에이전트 하네스 전체에서 세션을 캡처하고 정책을 적용합니다." icon: "plug-zap" --- -Failproof AI는 Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI, Goose를 지원합니다. +하네스(harness)란 에이전트가 실제로 실행되는 환경을 의미합니다. Failproof AI는 두 가지 유형으로 분류된 12개의 하네스를 지원합니다. -| 하네스 | 지원되는 훅 범위 | +- **코딩 CLI** (10개) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **채팅 및 어시스턴트 게이트웨이** (2개) — Hermes (Slack, Telegram, cron), OpenClaw (셀프호스팅 어시스턴트) + +어떤 하네스에서 에이전트가 실행되더라도 동일한 정책과 동일한 세션 히스토리가 적용됩니다. 어댑터 레이어 하나가 각 하네스의 네이티브 이벤트 이름, 도구 이름, 도구 입력 필드를 정책 실행 전에 29개의 표준 이벤트로 매핑합니다. + +12개 중 **어느 하네스에도 해당하지 않는** 에이전트는 [Python SDK](/ko/reference/python-sdk)를 통해 직접 계측할 수 있습니다. 이는 별도의 계약 방식으로, 명확히 짚고 넘어갈 필요가 있습니다. SDK는 트레이싱, 세션, 평가, 감사 기능을 제공하지만 **자체적으로 정책을 적용하지는 않습니다.** 실행 전에 안전하지 않은 동작을 차단하려면 런타임의 도구 경계에 적용 훅이 필요합니다. [문의하기](mailto:support@befailproof.ai)를 통해 연락 주시면 매핑 작업을 도와드립니다. + +| 하네스 | 지원되는 훅 스코프 | | --- | --- | | Claude Code | User, project, local | | Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | | Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | | Hermes, OpenClaw | User | -각 통합은 정책이 실행되기 전에 네이티브 훅 이벤트 이름, 도구 이름, 도구 입력 필드를 정규화합니다. 정책은 하네스가 노출하는 이벤트에만 적용할 수 있으며, 실제로 배포할 하네스 및 버전에서 턴 종료와 명령 동작을 직접 테스트하십시오. +각 통합은 정책 실행 전에 네이티브 훅 이벤트 이름, 도구 이름, 도구 입력 필드를 정규화합니다. 정책은 해당 하네스가 노출하는 이벤트에만 작용할 수 있으므로, 실제 배포에 사용할 정확한 하네스와 버전에서 턴 종료 및 명령 동작을 테스트하세요. ## 적용 기능 -"블록"이란 현재 어댑터가 반환한 판정이 해당 하네스에 의해 소비됨을 의미합니다. 도구 사후 차단은 모델에 표시되는 결과를 대체할 수 있지만, 이미 발생한 도구 사이드 이펙트를 되돌릴 수는 없습니다. +"차단(Block)"은 현재 어댑터가 반환한 판정을 지정된 하네스가 수용함을 의미합니다. 도구 사후 차단(Post-tool blocking)은 모델에 표시되는 결과를 교체할 수 있지만, 이미 발생한 도구 부작용을 되돌릴 수는 없습니다. -| 하네스 | 검증된 차단 이벤트 | 관찰 전용 또는 비차단 주의사항 | +| 하네스 | 검증된 차단 이벤트 | 관찰 전용 또는 비차단 주의 사항 | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, 및 여러 태스크/설정 이벤트 | `PostToolUse`, 세션 라이프사이클, 알림, 실패 후 이벤트는 관찰용입니다. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | 도구 사후 차단은 실행 후 결과를 대체하며, 세션 시작 및 컴팩트 이벤트는 현재 어댑터에서 관찰용입니다. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | 도구 사후 차단은 실행 후 결과를 대체하며, 세션 및 알림 이벤트는 관찰용입니다. | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` 및 세션 이벤트는 관찰용입니다. | -| OpenCode | `PreToolUse` | 도구 사후 및 라이프사이클 이벤트는 관찰용이며, 현재 stop 처리는 검증된 게이트가 아닌 이후 턴에 대한 안내입니다. | -| Pi | `PreToolUse`, `UserPromptSubmit` | 도구 사후 및 라이프사이클 이벤트는 관찰용이며, stop 안내는 이후 턴에 적용됩니다. | -| Hermes | `PreToolUse` | 도구 사후, 세션, 서브에이전트 stop 판정은 게이트가 아닙니다. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | 도구 사후, 세션, 서브에이전트 stop, 컴팩션 이벤트는 관찰용입니다. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | 도구 사후 및 서브에이전트 stop 판정은 관찰용입니다. | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, 조건부 `PermissionRequest` | 권한 훅은 모든 권한 모드에서 실행되지 않으며, 도구 사후 및 세션 이벤트는 관찰용입니다. | -| Antigravity CLI | `PreToolUse`, `Stop` | 사용자 프롬프트 및 도구 사후 판정은 관찰용이며, 프롬프트 명령은 여전히 주입될 수 있습니다. | -| Goose | `PreToolUse` | 사용자 프롬프트, 도구 사후, 세션 이벤트는 관찰용입니다. 네이티브 차단 stop 훅이 업스트림에 존재하지만 현재 어댑터에는 설치되지 않습니다. | - -기능은 버전에 따라 달라집니다. 특히 정책이 공통 사전 도구 게이트가 아닌 프롬프트, stop, 권한, 도구 사후 동작에 의존하는 경우, 에이전트 CLI를 업그레이드한 후 반드시 재테스트하십시오. +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` 및 여러 태스크/설정 이벤트 | `PostToolUse`, 세션 라이프사이클, 알림, 장애 후 이벤트는 관찰 전용입니다. | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | 도구 사후 차단은 실행 후 결과를 교체하며, 세션 시작 및 compact 이벤트는 현재 어댑터에서 관찰 전용입니다. | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | 도구 사후 차단은 실행 후 결과를 교체하며, 세션 및 알림 이벤트는 관찰 전용입니다. | +| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` 및 세션 이벤트는 관찰 전용입니다. | +| OpenCode | `PreToolUse` | 도구 사후 및 라이프사이클 이벤트는 관찰 전용이며, 현재 stop 처리는 검증된 게이트가 아닌 이후 턴에 대한 가이드입니다. | +| Pi | `PreToolUse`, `UserPromptSubmit` | 도구 사후 및 라이프사이클 이벤트는 관찰 전용이며, stop 가이드는 이후 턴에 적용됩니다. | +| Hermes | `PreToolUse` | 도구 사후, 세션, subagent-stop 판정은 게이트로 작동하지 않습니다. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | 도구 사후, 세션, subagent-stop, compaction 이벤트는 관찰 전용입니다. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | 도구 사후 및 subagent-stop 판정은 관찰 전용입니다. | +| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, 조건부 `PermissionRequest` | 권한 훅은 모든 권한 모드에서 실행되지 않으며, 도구 사후 및 세션 이벤트는 관찰 전용입니다. | +| Antigravity CLI | `PreToolUse`, `Stop` | 사용자 프롬프트 및 도구 사후 판정은 관찰 전용이나, 프롬프트 명령 주입은 여전히 가능합니다. | +| Goose | `PreToolUse` | 사용자 프롬프트, 도구 사후, 세션 이벤트는 관찰 전용입니다. 네이티브 차단 stop 훅이 상위에 존재하지만 현재 어댑터에는 설치되어 있지 않습니다. | + +기능은 버전에 따라 달라집니다. 에이전트 CLI를 업그레이드한 후, 특히 공통 도구 사전 게이트(pre-tool gate)가 아닌 프롬프트, stop, 권한, 도구 사후 동작에 의존하는 정책이 있는 경우 반드시 재테스트하세요. ## 캡처 및 정책 훅 설치 - 1. **관리 → 키**를 열고 머신 또는 환경 이름으로 `events:add`와 `policies:pull` 권한을 가진 키를 생성합니다. + 1. **Administration → Keys**를 열고 머신 또는 환경에 맞는 이름으로 `events:add` 및 `policies:pull` 권한이 있는 키를 생성합니다. 2. 대상 머신에서 표시된 키로 로컬 CLI를 연결하고 하네스 훅을 설치합니다. - 3. 새 에이전트 세션을 시작한 후 **관찰 → 이벤트**에서 해당 훅 및 세션 이벤트를 확인합니다. - 4. 동일한 시간대에 **관찰 → 정책**을 열고 해당 머신에 정책 결정이 귀속되었는지 확인합니다. + 3. 새 에이전트 세션을 시작한 후 **Observe → Events**에서 해당 훅과 세션 이벤트를 확인합니다. + 4. 동일한 시간 범위에서 **Observe → policy**를 열고 해당 머신에 정책 결정이 귀속되는지 확인합니다. - 연결은 머신 키로 시작됩니다. 시크릿을 복사하기 전에 인제스션 및 정책 전달 권한이 모두 포함되어 있는지 확인하십시오. + 연결은 머신 키로 시작됩니다. 시크릿을 복사하기 전에 수집 및 정책 전달 권한이 모두 포함되어 있는지 확인하세요. - ![이벤트 인제스션 및 정책 전달 권한을 부여하는 새 API 키 드로어.](/images/dashboard/key-create.png) + ![이벤트 수집 및 정책 전달 권한을 부여하는 데 사용되는 새 API 키 드로어.](/images/dashboard/key-create.png) - 훅을 설치한 후, 이벤트 스트림에 연결한 머신 및 환경의 새 이벤트가 표시되어야 합니다. + 훅을 설치한 후 Events 스트림에 연결한 머신 및 환경의 새 이벤트가 표시되어야 합니다. - ![새로 설치된 하네스가 보고 중인지 확인하는 라이브 이벤트 스트림.](/images/dashboard/events-stream.png) + ![새로 설치된 하네스가 보고 중임을 확인하는 데 사용되는 실시간 Events 스트림.](/images/dashboard/events-stream.png) - 마지막으로, 동일한 머신에 정책 결정이 귀속되는지 확인합니다. 이는 하네스가 트레이스 이벤트뿐만 아니라 정책 활동도 보고하고 있음을 확인합니다. + 마지막으로, 동일한 머신에 정책 결정이 귀속되는지 확인합니다. 이를 통해 하네스가 트레이스 이벤트뿐만 아니라 정책 활동도 보고하고 있음을 확인할 수 있습니다. - ![새로 연결된 하네스의 정책 결정을 검증하는 정책 페이지.](/images/dashboard/policy-observe.png) + ![새로 연결된 하네스의 정책 결정을 검증하는 데 사용되는 Policy 페이지.](/images/dashboard/policy-observe.png) - 감지된 모든 하네스에 훅을 설치합니다: + 감지된 모든 하네스에 훅 설치: ```bash failproofai config \ @@ -67,7 +74,7 @@ Failproof AI는 Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, He failproofai policies --install ``` - 또는 특정 하네스와 설정 범위를 지정합니다: + 또는 특정 하네스와 설정 스코프를 지정하여 설치: ```bash failproofai policies --install \ @@ -75,9 +82,9 @@ Failproof AI는 Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, He --scope user ``` - 프로젝트 범위는 훅 설정을 저장소와 함께 유지합니다. 사용자 범위는 여러 저장소에 걸친 작업을 포괄합니다. Claude Code는 local 범위도 지원하며, 지원 여부는 하네스에 따라 다르고 CLI는 지원되지 않는 조합을 거부합니다. + Project 스코프는 훅 설정을 리포지토리에 함께 보관합니다. User 스코프는 리포지토리 전반의 작업을 포괄합니다. Claude Code는 local 스코프도 지원하며, 지원 여부는 하네스마다 다르고 CLI는 지원되지 않는 조합을 거부합니다. - 머신 및 이벤트를 확인합니다: + 머신 및 이벤트 확인: ```bash failproofai config --status @@ -91,9 +98,9 @@ Failproof AI는 Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, He - 추가 경로는 클라우드가 아닌 머신에 등록됩니다. 경로를 추가한 후 **관찰 → 세션**을 열고 머신 환경으로 필터링하여 새 경로의 세션이 표시되는지 확인합니다. 세션을 열고 감사에 활용하기 전에 에이전트, 하네스, 이벤트 타임스탬프를 확인하십시오. + 추가 경로는 클라우드가 아닌 머신에 등록됩니다. 경로를 추가한 후 **Observe → Sessions**을 열고, 해당 머신의 환경으로 필터링하여 새 경로의 세션이 표시되는지 확인합니다. 감사에 활용하기 전에 세션을 열어 에이전트, 하네스, 이벤트 타임스탬프를 점검하세요. - ![추가 캡처 경로의 데이터를 수신하는 환경으로 필터링된 세션 목록.](/images/dashboard/sessions-list.png) + ![추가 캡처 경로에서 데이터를 수신하는 환경으로 필터링된 Sessions 목록.](/images/dashboard/sessions-list.png) 선택적 레이블과 함께 경로를 추가한 후 설정된 경로를 확인합니다: @@ -110,5 +117,5 @@ Failproof AI는 Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, He - 설치 후 새 세션을 하나 실행하십시오. 롤아웃을 확대하기 전에 라이브 이벤트 스트림과 실제 정책 결정을 모두 확인하십시오. + 설치 후 새 세션을 한 번 실행해 보세요. 롤아웃을 확대하기 전에 실시간 이벤트 스트림과 실제 정책 결정 모두를 확인하세요. \ No newline at end of file diff --git a/docs/ko/sessions/live-events.mdx b/docs/ko/sessions/live-events.mdx index 5964cbcd9..87c4484a9 100644 --- a/docs/ko/sessions/live-events.mdx +++ b/docs/ko/sessions/live-events.mdx @@ -1,21 +1,21 @@ --- -title: "실시간 이벤트" -description: "세션이 실행되는 동안 에이전트 활동이 들어오는 것을 실시간으로 확인하세요." +title: "라이브 이벤트" +description: "세션이 실행되는 동안 에이전트 활동을 실시간으로 확인하세요." icon: "radio" --- -실시간 이벤트를 통해 계측(instrumentation)이 올바르게 작동하는지 확인하고, 세션이 완료될 때까지 기다리지 않고도 위험한 실행 상황을 모니터링할 수 있습니다. +라이브 이벤트를 통해 계측이 올바르게 작동하는지 확인하고, 세션이 완료될 때까지 기다리지 않고 위험한 실행을 실시간으로 모니터링할 수 있습니다. ## 활동 모니터링 1. **Observe → Events**로 이동합니다. - 2. 데이터가 수신되는지 확인하기 위해 현재 시간 범위를 선택하고 필터를 적용하지 않은 상태로 시작합니다. - 3. 환경, 이벤트 유형, 에이전트, 세션으로 필터링합니다. 페이로드 텍스트 검색에는 검색 기능을 활용하세요. + 2. 데이터가 수신되는지 확인하려면 현재 시간 범위에서 필터 없이 시작하세요. + 3. 환경, 이벤트 유형, 에이전트, 또는 세션으로 필터링합니다. 페이로드 텍스트는 검색을 사용하세요. 4. 이벤트를 선택하면 요약 및 세부 정보를 확인할 수 있습니다. 세션 링크를 따라가면 전체 트레이스를 볼 수 있습니다. - ![시간, 환경, 이벤트 유형, 에이전트, 모델, 컨텍스트, 세션, 텍스트 필터가 포함된 실시간 Events 스트림.](/images/dashboard/events-stream-current.png) + ![시간, 환경, 이벤트 유형, 에이전트, 모델, 컨텍스트, 세션으로 필터링된 라이브 이벤트 스트림 — Hermes 채팅 게이트웨이와 코딩 CLI 실행의 트래픽이 표시됩니다.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ icon: "radio" fp --json events --full --session-id --all ``` - 기본 피드에는 원시 페이로드가 포함되지 않습니다. `--full` 옵션은 범위가 한정된 세션 조사 시에만 사용하세요. + 기본 피드에는 원시 페이로드가 포함되지 않습니다. `--full` 옵션은 범위가 정해진 세션 조사에서만 사용하세요. -이벤트 스트림을 활용하면 다음 세 가지 핵심 질문에 즉시 답할 수 있습니다. +이벤트 스트림을 활용해 다음 세 가지 즉각적인 질문에 답할 수 있습니다: -- 예상한 에이전트가 올바른 환경에 보고하고 있는가? -- 모델 호출, 도구 호출, 정책 결정이 순서대로 수신되고 있는가? -- 세션이 진행을 멈추거나 동일한 작업을 반복하기 시작했는가? +- 예상된 에이전트가 올바른 환경에 보고하고 있는가? +- 모델 호출, 툴 호출, 정책 결정이 순서대로 수신되고 있는가? +- 세션이 진행을 멈추거나 동일한 작업을 반복하고 있지는 않은가? -이벤트 유형에는 에이전트 생명주기 이벤트, 모델 요청 및 응답, 도구 사용 및 결과, 훅 실행, 사람의 대기 및 중단, 명시적 오류가 포함됩니다. 상관 관계 ID(Correlation ID)는 도구 호출과 그 결과처럼 쌍을 이루는 이벤트를 연결합니다. +이벤트 유형에는 에이전트 라이프사이클 이벤트, 모델 요청 및 응답, 툴 사용 및 결과, 훅 실행, 사람의 대기 및 인터럽트, 명시적 오류가 포함됩니다. 상관 관계 ID는 툴 호출과 그 결과처럼 쌍을 이루는 이벤트를 연결합니다. - 새로운 통합을 검증할 때는 실시간 뷰를 넓게 유지하세요. 첫 번째 이벤트가 확인된 후에만 필터를 추가하세요. 잘못된 필터를 적용하면 수집(ingestion)이 실패한 것처럼 보일 수 있습니다. + 새로운 통합을 검증할 때는 라이브 뷰를 넓게 유지하세요. 첫 번째 이벤트가 확인된 후에만 필터를 추가하세요. 잘못된 필터를 적용하면 수집 실패처럼 보일 수 있습니다. -이벤트가 나타나지 않는다면 `failproofai config --status`를 실행한 후 [수집 문제 해결](/ko/reference/troubleshooting)을 참고하세요. \ No newline at end of file +이벤트가 표시되지 않으면 `failproofai config --status`를 실행한 후 [수집 문제 해결](/ko/reference/troubleshooting)을 참고하세요. + +지원되는 12개의 [하네스](/ko/reference/harnesses) 중 하나에서 실행되지 않는 에이전트는 [Python SDK](/ko/reference/python-sdk)를 통해 동일한 이벤트 유형을 보고하며, 게이트웨이 및 프로덕션 에이전트가 의존하는 human-in-the-loop 이벤트(`human_wait`, `human_input`, `human_interrupt`)도 포함됩니다. \ No newline at end of file diff --git a/docs/ko/sessions/overview.mdx b/docs/ko/sessions/overview.mdx index c0da780ca..d5b09d4a9 100644 --- a/docs/ko/sessions/overview.mdx +++ b/docs/ko/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "세션" -description: "에이전트 실행의 전체 기록으로 시작하세요." +description: "에이전트 실행의 전체 기록부터 시작하세요." icon: "workflow" --- -세션은 에이전트가 예상치 못한 동작을 보일 때 가장 좋은 출발점입니다. 하나의 실행에 속하는 모델 요청, 응답, 도구 호출, 사람의 상호작용, 오류, 평가, 정책 결정을 모두 통합하여 보여줍니다. +에이전트가 예상치 못한 동작을 보일 때 세션이 최적의 출발점입니다. 세션은 하나의 실행에 속하는 모델 요청, 응답, 도구 호출, 사람의 개입, 오류, 평가, 정책 결정을 하나로 묶어줍니다. + +세션은 어떤 환경에서 생성됐든 동일한 형태로 표시됩니다. 저장소를 재작성하는 Claude Code 실행, Slack에서 고객에게 응답하는 Hermes 에이전트, SDK로 계측된 Python 서비스 모두 동일한 트레이스 형식으로 저장되므로, 단일 뷰로 전체 플릿을 파악할 수 있습니다.
-에이전트 실행의 목표부터 모델 호출, 도구 사용, 최종 응답까지 하나의 흐름으로 추적하세요. +에이전트 실행의 목표부터 모델 호출, 도구 사용, 최종 응답까지 전 과정을 추적하세요. ## 세션 찾기 1. 클라우드 사이드바에서 **Observe → Sessions**으로 이동합니다. - 2. 시간 범위를 설정한 후 환경, 상태, 에이전트, 또는 세션 ID로 필터링합니다. - 3. 품질, 비용, 토큰, 레이턴시 기준으로 조회할 때는 점수나 메트릭 범위를 추가합니다. - 4. 행을 선택하면 해당 트레이스가 열립니다. 세션 ID 옆의 복사 버튼을 사용해 공유하세요. + 2. 시간 범위를 설정한 후 환경, 상태, 에이전트, 세션 ID로 필터링합니다. + 3. 품질, 비용, 토큰, 지연 시간 기준으로 좁혀볼 때는 점수 또는 메트릭 범위를 추가합니다. + 4. 행을 선택하면 트레이스가 열립니다. 세션 ID 옆의 복사 컨트롤을 사용하면 공유할 수 있습니다. - ![환경, 에이전트, 상태, 평가 점수 필터와 함께 실행당 한 행씩 표시되는 세션 목록.](/images/dashboard/sessions-list.png) + ![환경, 에이전트, 상태, 평가 점수 필터와 함께 실행당 한 행으로 표시되는 Sessions 목록.](/images/dashboard/sessions-list.png) ```bash @@ -30,24 +32,24 @@ icon: "workflow" fp --json sessions --session-id ``` - `--agents`를 추가하면 멀티 에이전트 실행을 펼쳐볼 수 있고, `--all`은 페이지네이션, `--fields`는 출력 컬럼을 선택합니다. + `--agents`를 추가하면 멀티 에이전트 실행을 펼쳐 볼 수 있고, `--all`로 페이지네이션을, `--fields`로 출력 컬럼을 선택할 수 있습니다. ## 할 수 있는 작업 -- 에이전트, 환경, 시간, 모델, 이벤트 유형, 오류 상태로 실행을 찾습니다. -- 특정 결과를 만들어낸 정확한 실행 순서를 추적합니다. +- 에이전트, 환경, 시간, 모델, 이벤트 유형, 오류 상태로 실행을 검색합니다. +- 특정 결과를 만들어낸 정확한 순서를 추적합니다. - 성공한 실행과 실패한 실행을 비교합니다. -- 감사 결과나 알림 인시던트에 사용된 근거를 확인합니다. +- 감사 결과나 알림 인시던트의 근거 자료를 확인합니다. - 오프라인 기록이 필요할 때 세션을 내보냅니다. -## 체계적인 조사 순서 +## 신뢰할 수 있는 조사 순서 -1. 세션 목표와 환경을 확인합니다. -2. 최종 실패만이 아니라 첫 번째 오류 또는 예상치 못한 결정을 찾습니다. -3. 그 직전의 모델 컨텍스트와 도구 입력을 검사합니다. -4. 재시도, 레이턴시, 사람의 개입을 확인합니다. +1. 세션의 목표와 환경을 확인합니다. +2. 최종 실패만이 아니라, 첫 번째 오류 또는 예상치 못한 결정을 찾습니다. +3. 해당 시점 직전의 모델 컨텍스트와 도구 입력을 검사합니다. +4. 재시도, 지연 시간, 사람의 개입 여부를 확인합니다. 5. 평가 점수와 정책 결정을 검토합니다. diff --git a/docs/ko/start/quickstart.mdx b/docs/ko/start/quickstart.mdx index d5e87ac64..71f53c023 100644 --- a/docs/ko/start/quickstart.mdx +++ b/docs/ko/start/quickstart.mdx @@ -1,10 +1,12 @@ --- title: "빠른 시작" -description: "에이전트 세션을 캡처하고, 실패를 찾고, 방지책을 배포하세요." +description: "에이전트 세션을 캡처하고, 실패를 발견하고, 이를 예방하기 시작합니다." icon: "zap" --- -이 빠른 시작 가이드는 한 대의 머신에서 세션을 보고하고, 감사를 실행하며, 정책을 배포하는 과정을 안내합니다. 스킬을 사용하거나 아래의 수동 단계를 따라 Failproof AI를 설정하세요. Node.js 20.9 이상이 필요합니다. +이 빠른 시작 가이드에서는 하나의 머신이 세션을 보고하도록 설정하고, 감사를 실행하고, 정책을 배포합니다. 스킬을 사용하거나 수동 단계를 따르세요. + +**어떤 방법이 맞나요?** 에이전트가 지원되는 12개 [하네스](/ko/reference/harnesses) 중 하나(코딩 CLI, 또는 Hermes나 OpenClaw 같은 게이트웨이)에서 실행된다면, 아래 단계를 따르세요. Node.js 20.9 이상이 필요합니다. 에이전트에 하네스가 없다면 [Python SDK](/ko/reference/python-sdk)로 트레이싱과 감사를 위한 계측을 추가한 후, [첫 번째 실패 검사 실행](/ko/start/first-audit)에서 다시 합류하세요. 이 경우 적용을 위해서는 런타임에 훅이 필요합니다. @@ -14,21 +16,21 @@ icon: "zap" npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - 에이전트가 프로젝트를 검사하고, 적절한 통합 방식을 선택하고, 설정을 수행한 후 세션이 정상적으로 도착하는지 확인합니다. 개별 스킬 및 고급 설치 옵션은 [FailproofAI 스킬 저장소](https://github.com/FailproofAI/skills)를 참고하세요. + 에이전트가 프로젝트를 검사하고, 관련 통합을 선택하고, 설정을 수행하고, 검증합니다. 개별 스킬과 고급 설치 옵션은 [FailproofAI 스킬 저장소](https://github.com/FailproofAI/skills)를 참고하세요. ## 시작하기 전에 -1. [Failproof AI 대시보드](https://app.befailproof.ai)를 열고 계정을 생성하거나 업무용 이메일로 로그인하세요. -2. **관리 → 키**로 이동하여 `events:add` 및 `policies:pull` 권한을 가진 키를 생성하세요. -3. 일회용 시크릿을 복사하고 대상 머신에 저장하세요: +1. [Failproof AI 대시보드](https://app.befailproof.ai)를 열고 계정을 만들거나 업무용 이메일로 로그인합니다. +2. **관리 → 키**로 이동하여 `events:add`와 `policies:pull` 권한이 있는 키를 생성합니다. +3. 일회용 시크릿을 복사하여 대상 머신에 저장합니다: ```bash export FAILPROOFAI_KEY="" @@ -43,9 +45,9 @@ export FAILPROOFAI_KEY="" failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - 세션 트랜스크립트는 기본적으로 전송됩니다. 트랜스크립트 내용 없이 훅 활동 및 정책 결정만 보고하려면 `--no-transcripts`를 추가하세요. + 세션 기록은 기본적으로 전송됩니다. 기록 내용 없이 훅 활동과 정책 결정만 보고하려면 `--no-transcripts`를 추가하세요. - 이 머신에 이미 에이전트 기록이 있다면, 최근 7일 치를 미리 확인하고 가져온 후 전송이 완료될 때까지 기다리세요. 새 머신에서는 이 단계를 건너뛰세요. + 이 머신에 이미 에이전트 기록이 있다면, 최근 7일 치를 미리 보고 가져온 후 전송이 완료될 때까지 기다리세요. 새 머신이라면 이 단계를 건너뛰세요. ```bash failproofai backfill --since 7d --dry-run @@ -53,27 +55,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - Failproof AI에서 **세션**을 열고 가져온 세션을 선택하세요. + Failproof AI에서 **세션**을 열고 가져온 세션을 선택합니다. - 이 단계는 Failproof AI를 에이전트 CLI에 연결하고 기본 제공 정책을 설치합니다. Failproof AI가 세션을 감사하고 에이전트에 맞는 정책을 작성하기 전에, 로컬 정책 결정을 확인하고 적용을 미리 시험해볼 수 있습니다. + 이 단계에서는 Failproof AI를 하네스에 연결하고 40개의 기본 제공 정책을 설치합니다. Failproof AI가 세션을 감사하고 에이전트에 맞는 정책을 작성하기 전에, 로컬 정책 결정을 확인하고 적용을 시험해 볼 수 있습니다. - 에이전트 CLI를 자동으로 감지하도록 두거나 명시적으로 지정할 수 있습니다. + 설치 프로그램이 하네스를 자동으로 감지하도록 하거나 직접 지정할 수 있습니다. 지원되는 12개 모두 유효한 `--cli` 값입니다 — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # 코딩 CLI + failproofai policies --install --cli hermes --scope user # Slack/Telegram 게이트웨이 ``` + + 도구 호출을 실행 전에 차단하는 기능은 12개 모두에서 검증되었습니다. 턴 종료 게이트는 8개에서 검증되었습니다 — 하네스별 매트릭스는 [적용 기능](/ko/reference/harnesses#enforcement-capability)을 참고하세요. - [첫 번째 실패 검사 실행](/ko/start/first-audit)을 따라 진행하세요. "에이전트가 접근 방식을 바꾸지 않고 실패한 도구를 반복 재시도한 세션 찾기"와 같이 구체적인 목표를 사용하세요. + [첫 번째 실패 검사 실행](/ko/start/first-audit)을 따르세요. "에이전트가 접근 방식을 바꾸지 않고 실패한 도구를 재시도한 세션 찾기"와 같이 구체적인 목표를 사용하세요. - - [정책으로 첫 번째 실패 방지하기](/ko/start/first-policy)를 따라 진행하세요. 관찰 모드로 시작하여 일치 항목을 검토한 후, 검토된 버전을 적용하세요. + + [정책으로 첫 번째 실패 예방](/ko/start/first-policy)을 따르세요. 관찰 모드에서 시작하여 매칭 결과를 검토한 후, 검토된 버전을 적용하세요. - `failproofai config --status`를 실행하세요. 정상적으로 설정된 경우 클라우드 연결 상태, 데몬 상태, 그리고 적용이 일시 중지되었는지 여부가 표시됩니다. + `failproofai config --status`를 실행하세요. 정상적인 설정은 클라우드 연결 상태, 데몬 상태, 그리고 적용이 일시 중지되었는지 여부를 보고합니다. \ No newline at end of file diff --git a/docs/pt-br/index.mdx b/docs/pt-br/index.mdx index b98ffd594..e9582c7f9 100644 --- a/docs/pt-br/index.mdx +++ b/docs/pt-br/index.mdx @@ -1,17 +1,19 @@ --- title: "Torne seu agente à prova de falhas" -description: "Failproof AI rastreia o comportamento de agentes, audita sessões em busca de falhas e implanta políticas que evitam a recorrência de incidentes." +description: "Observabilidade e aplicação de regras para cada ambiente em que seus agentes rodam — CLIs de codificação, gateways de chat, assistentes auto-hospedados e seus próprios agentes instrumentados." icon: "shield-check" --- -Failproof AI ajuda equipes a entender o que os agentes fizeram, identificar onde falharam e implantar salvaguardas antes que o mesmo comportamento se repita. +O Failproof AI ajuda equipes a entender o que os agentes fizeram, identificar onde falharam e implantar salvaguardas antes que o mesmo comportamento se repita. + +Um **harness** é o ambiente no qual seu agente efetivamente roda. O Failproof AI se integra a 12 deles — CLIs de codificação como Claude Code e Codex, gateways de chat como Hermes, assistentes auto-hospedados como OpenClaw — e os mesmos eventos, as mesmas políticas e o mesmo histórico de sessões se aplicam a todos. Agentes sem harness se reportam por meio do [Python SDK](/pt-br/reference/python-sdk), que os rastreia e audita; para aplicar uma política nesses casos, é necessário um hook no seu próprio runtime. Use a skill para instrumentar seu projeto, conectá-lo e verificar que os logs do agente estão chegando. - - Analise, consulte, crie dashboards e execute auditorias em linguagem natural nos logs do seu agente. + + Analise, consulte, crie dashboards e execute auditorias em linguagem natural sobre os logs do seu agente. @@ -28,12 +30,12 @@ Failproof AI ajuda equipes a entender o que os agentes fizeram, identificar onde > **Sessão → Auditoria → Descoberta → Issue → Política**
-> Rastreie o que aconteceu, encontre a falha, gerencie a resposta e evite o mesmo comportamento em execuções futuras. +> Rastreie o que aconteceu, encontre a falha, gerencie a resposta e previna o mesmo comportamento em execuções futuras. -## Comece aqui +## Comece por aqui Se você está implantando seu primeiro agente instrumentado, comece pelo [quickstart](/pt-br/start/quickstart). Se os dados já estão chegando, abra [Sessions](/pt-br/sessions/overview) e inspecione uma execução real antes de configurar auditorias ou políticas. - Complete o fluxo de trabalho de ponta a ponta, desde a captura até a implantação segura de uma política. + Complete o fluxo de trabalho completo, da captura até a implantação segura de uma política. \ No newline at end of file diff --git a/docs/pt-br/reference/harnesses.mdx b/docs/pt-br/reference/harnesses.mdx index d29080049..7a836f3f8 100644 --- a/docs/pt-br/reference/harnesses.mdx +++ b/docs/pt-br/reference/harnesses.mdx @@ -1,10 +1,17 @@ --- -title: "Harnessess de agentes" -description: "Capture sessões e aplique políticas em CLIs de agentes suportados." +title: "Harnesses de agente" +description: "Capture sessões e aplique políticas em todos os 12 harnesses de agente suportados." icon: "plug-zap" --- -Failproof AI suporta Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI e Goose. +Um harness é o ambiente em que seu agente efetivamente executa. O Failproof AI suporta doze deles, em duas categorias: + +- **CLIs de codificação** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **Gateways de chat e assistente** (2) — Hermes (Slack, Telegram, cron), OpenClaw (assistente self-hosted) + +As mesmas políticas e o mesmo histórico de sessões se aplicam independentemente do harness em que o agente é executado. Uma camada de adaptador mapeia os nomes de eventos nativos, nomes de ferramentas e campos de entrada de ferramentas de cada harness para 29 eventos canônicos antes que qualquer política seja executada. + +Um agente que não é executado em **nenhum** dos doze é instrumentado diretamente com o [Python SDK](/pt-br/reference/python-sdk). Esse é um contrato diferente, e vale deixar claro: o SDK fornece rastreamento, sessões, avaliações e auditorias — **ele não aplica políticas por conta própria.** Bloquear uma ação insegura antes de sua execução requer um hook de aplicação na fronteira de ferramenta do seu runtime; [entre em contato conosco](mailto:support@befailproof.ai) e faremos o mapeamento. | Harness | Escopos de hook suportados | | --- | --- | @@ -13,49 +20,49 @@ Failproof AI suporta Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, P | Factory Droid, Devin CLI, Antigravity CLI, Goose | Usuário, projeto | | Hermes, OpenClaw | Usuário | -Cada integração normaliza os nomes de eventos de hook nativos, nomes de ferramentas e campos de entrada de ferramentas antes que as políticas sejam executadas. Uma política só pode agir sobre eventos que o harness expõe; teste o comportamento de fim de turno e de instrução no harness e na versão exatos que você irá implantar. +Cada integração normaliza seus nomes de eventos de hook nativos, nomes de ferramentas e campos de entrada de ferramentas antes da execução das políticas. Uma política só pode atuar sobre eventos que o harness expõe; teste o comportamento de fim de turno e de instrução no harness e na versão exatos que você implanta. ## Capacidade de aplicação -"Bloquear" significa que o veredicto retornado pelo adaptador atual é consumido pelo harness indicado. O bloqueio pós-ferramenta pode substituir o resultado exibido ao modelo, mas não pode desfazer um efeito colateral de ferramenta que já ocorreu. +"Bloquear" significa que o veredicto retornado pelo adaptador atual é consumido pelo harness indicado. O bloqueio pós-ferramenta pode substituir o resultado exibido ao modelo, mas não consegue desfazer um efeito colateral de ferramenta que já ocorreu. -| Harness | Eventos de bloqueio verificados | Ressalvas de apenas-observação ou não-bloqueio | +| Harness | Eventos de bloqueio verificados | Ressalvas de observação apenas ou não bloqueantes | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` e vários eventos de tarefa/configuração | `PostToolUse`, ciclo de vida da sessão, notificações e eventos pós-falha são observacionais. | +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` e vários eventos de tarefa/configuração | `PostToolUse`, ciclo de vida da sessão, notificações e eventos pós-falha são apenas observacionais. | | Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | O bloqueio pós-ferramenta substitui o resultado após a execução; eventos de início de sessão e compactação são observacionais no adaptador atual. | | GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | O bloqueio pós-ferramenta substitui o resultado após a execução; eventos de sessão e notificação são observacionais. | | Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` e eventos de sessão são observacionais. | -| OpenCode | `PreToolUse` | Eventos pós-ferramenta e de ciclo de vida são observacionais; o tratamento de parada atual é uma orientação para um turno posterior, não um bloqueio verificado. | -| Pi | `PreToolUse`, `UserPromptSubmit` | Eventos pós-ferramenta e de ciclo de vida são observacionais; a orientação de parada se aplica a um turno posterior. | -| Hermes | `PreToolUse` | Veredictos pós-ferramenta, de sessão e de parada de subagente não são bloqueios. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Eventos pós-ferramenta, de sessão, de parada de subagente e de compactação são observacionais. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Veredictos pós-ferramenta e de parada de subagente são observacionais. | +| OpenCode | `PreToolUse` | Eventos pós-ferramenta e de ciclo de vida são observacionais; o tratamento de stop atual é uma orientação para um turno posterior, e não uma barreira verificada. | +| Pi | `PreToolUse`, `UserPromptSubmit` | Eventos pós-ferramenta e de ciclo de vida são observacionais; a orientação de stop se aplica a um turno posterior. | +| Hermes | `PreToolUse` | Os veredictos de pós-ferramenta, sessão e subagent-stop não são barreiras. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Eventos pós-ferramenta, de sessão, subagent-stop e compactação são observacionais. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Os veredictos pós-ferramenta e subagent-stop são observacionais. | | Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` condicional | Os hooks de permissão não são executados em todos os modos de permissão; eventos pós-ferramenta e de sessão são observacionais. | -| Antigravity CLI | `PreToolUse`, `Stop` | Veredictos de prompt do usuário e pós-ferramenta são observacionais; instruções de prompt ainda podem ser injetadas. | -| Goose | `PreToolUse` | Eventos de prompt do usuário, pós-ferramenta e de sessão são observacionais. Um hook de parada de bloqueio nativo existe upstream, mas não é instalado pelo adaptador atual. | +| Antigravity CLI | `PreToolUse`, `Stop` | Os veredictos de user-prompt e pós-ferramenta são observacionais; instruções de prompt ainda podem ser injetadas. | +| Goose | `PreToolUse` | Eventos de user-prompt, pós-ferramenta e de sessão são observacionais. Um hook de stop de bloqueio nativo existe upstream, mas não é instalado pelo adaptador atual. | -As capacidades são sensíveis à versão. Refaça os testes após atualizar um CLI de agente, especialmente quando uma política depende de comportamento de prompt, parada, permissão ou pós-ferramenta em vez do bloqueio pré-ferramenta comum. +As capacidades são sensíveis à versão. Refaça os testes após atualizar um CLI de agente, especialmente quando uma política depende do comportamento de prompt, stop, permissão ou pós-ferramenta em vez da barreira comum pré-ferramenta. ## Instalar hooks de captura e política 1. Abra **Administração → Chaves** e crie uma chave com `events:add` e `policies:pull`, nomeada para a máquina ou ambiente. - 2. Na máquina de destino, conecte a CLI local com a chave exibida e instale os hooks do harness. - 3. Inicie uma nova sessão de agente e confirme seus eventos de hook e sessão em **Observe → Events**. - 4. Abra **Observe → policy** para a mesma janela de tempo e confirme que uma decisão de política está atribuída à máquina. + 2. Na máquina de destino, conecte o CLI local com a chave exibida e instale os hooks de harness. + 3. Inicie uma nova sessão de agente e confirme seus eventos de hook e sessão em **Observar → Eventos**. + 4. Abra **Observar → política** para a mesma janela de tempo e confirme que uma decisão de política está atribuída à máquina. - A conexão começa com uma chave de máquina. Confirme que ela inclui permissões de ingestão e entrega de políticas antes de copiar o segredo. + A conexão começa com uma chave de máquina. Confirme que ela inclui permissões de ingestão e de entrega de políticas antes de copiar o segredo. - ![O drawer de nova chave de API usado para conceder permissões de ingestão de eventos e entrega de políticas.](/images/dashboard/key-create.png) + ![O painel de nova chave de API usado para conceder permissões de ingestão de eventos e entrega de políticas.](/images/dashboard/key-create.png) - Após instalar os hooks, o stream de Events deve exibir novos eventos da máquina e do ambiente conectados. + Após instalar os hooks, o stream de Eventos deve mostrar novos eventos da máquina e do ambiente que você conectou. - ![O stream de Events ao vivo usado para confirmar que um harness recém-instalado está reportando.](/images/dashboard/events-stream.png) + ![O stream de Eventos ao vivo usado para confirmar que um harness recém-instalado está reportando.](/images/dashboard/events-stream.png) - Por fim, verifique se as decisões de política estão atribuídas à mesma máquina. Isso confirma que o harness está reportando atividade de política, além dos eventos de rastreamento. + Por fim, verifique se as decisões de política estão atribuídas à mesma máquina. Isso confirma que o harness está reportando a atividade de política além dos eventos de rastreamento. - ![A página Policy usada para verificar decisões de política de um harness recém-conectado.](/images/dashboard/policy-observe.png) + ![A página de Política usada para verificar as decisões de política de um harness recém-conectado.](/images/dashboard/policy-observe.png) Instale hooks para todos os harnesses detectados: @@ -67,7 +74,7 @@ As capacidades são sensíveis à versão. Refaça os testes após atualizar um failproofai policies --install ``` - Ou direcione harnesses específicos e um escopo de configuração: + Ou selecione harnesses específicos e um escopo de configuração: ```bash failproofai policies --install \ @@ -75,7 +82,7 @@ As capacidades são sensíveis à versão. Refaça os testes após atualizar um --scope user ``` - O escopo de projeto mantém a configuração de hooks junto ao repositório. O escopo de usuário cobre o trabalho em múltiplos repositórios. Claude Code também suporta escopo local; o suporte varia por harness e a CLI rejeita combinações não suportadas. + O escopo de projeto mantém a configuração de hook junto com um repositório. O escopo de usuário cobre o trabalho em todos os repositórios. Claude Code também suporta escopo local; o suporte varia por harness e o CLI rejeita combinações não suportadas. Verifique a máquina e seus eventos: @@ -91,12 +98,12 @@ As capacidades são sensíveis à versão. Refaça os testes após atualizar um - Caminhos extras são registrados na máquina, não na nuvem. Após adicionar um, abra **Observe → Sessions**, filtre pelo ambiente da máquina e confirme que as sessões do novo caminho aparecem. Abra uma sessão e verifique o agente, o harness e os timestamps de eventos antes de utilizá-la em uma auditoria. + Caminhos extras são registrados na máquina, não na nuvem. Após adicionar um, abra **Observar → Sessões**, filtre pelo ambiente da máquina e confirme que as sessões do novo caminho aparecem. Abra uma sessão e verifique o agente, o harness e os timestamps de eventos antes de utilizá-la em uma auditoria. - ![A lista de Sessions filtrada para o ambiente que recebe dados do caminho de captura adicional.](/images/dashboard/sessions-list.png) + ![A lista de Sessões filtrada pelo ambiente que está recebendo dados do caminho de captura adicional.](/images/dashboard/sessions-list.png) - Adicione um caminho com um rótulo opcional e inspecione os caminhos configurados: + Adicione um caminho com um rótulo opcional e, em seguida, inspecione os caminhos configurados: ```bash failproofai harness add-path claude checkout=/srv/checkout/.claude diff --git a/docs/pt-br/sessions/live-events.mdx b/docs/pt-br/sessions/live-events.mdx index 1b0afc306..0defb692b 100644 --- a/docs/pt-br/sessions/live-events.mdx +++ b/docs/pt-br/sessions/live-events.mdx @@ -1,10 +1,10 @@ --- -title: "Eventos ao vivo" +title: "Eventos em tempo real" description: "Acompanhe a atividade do agente enquanto uma sessão está em execução." icon: "radio" --- -Os eventos ao vivo ajudam você a confirmar a instrumentação e acompanhar uma execução arriscada sem esperar a sessão terminar. +Os eventos em tempo real ajudam você a confirmar a instrumentação e acompanhar uma execução arriscada sem precisar aguardar o término da sessão. ## Monitorar atividade @@ -15,7 +15,7 @@ Os eventos ao vivo ajudam você a confirmar a instrumentação e acompanhar uma 3. Filtre por ambiente, tipo de evento, agente ou sessão. Use a busca para texto no payload. 4. Selecione um evento para inspecionar seu resumo e detalhes. Siga o link da sessão para o rastreamento completo. - ![O stream de eventos ao vivo com filtros de tempo, ambiente, tipo de evento, agente, modelo, contexto, sessão e texto.](/images/dashboard/events-stream-current.png) + ![O stream de eventos ao vivo mostrando tráfego de um gateway de chat Hermes ao lado de execuções de CLI de codificação, filtrado por tempo, ambiente, tipo de evento, agente, modelo, contexto e sessão.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ Os eventos ao vivo ajudam você a confirmar a instrumentação e acompanhar uma fp --json events --full --session-id --all ``` - O feed padrão omite os payloads brutos. Use `--full` apenas para investigações em sessões com escopo definido. + O feed padrão omite os payloads brutos. Use `--full` apenas para investigações limitadas a uma sessão específica. Use o stream de eventos para responder três perguntas imediatas: -- O agente esperado está reportando para o ambiente correto? -- As chamadas de modelo, chamadas de ferramentas e decisões de política estão chegando na ordem certa? +- O agente esperado está reportando ao ambiente correto? +- As chamadas de modelo, chamadas de ferramenta e decisões de política estão chegando na ordem correta? - A sessão parou de progredir ou começou a repetir uma ação? -Os tipos de evento incluem eventos do ciclo de vida do agente, requisições e respostas de modelo, uso de ferramentas e resultados, execução de hooks, esperas e interrupções humanas, e erros explícitos. IDs de correlação associam eventos pareados, como uma chamada de ferramenta e seu resultado. +Os tipos de evento incluem eventos de ciclo de vida do agente, requisições e respostas de modelo, uso de ferramentas e resultados, execução de hooks, esperas e interrupções humanas, e erros explícitos. IDs de correlação conectam eventos pareados, como uma chamada de ferramenta e seu resultado. - Mantenha a visualização ao vivo ampla enquanto verifica uma nova integração. Adicione filtros somente após ver o primeiro evento; um filtro incorreto pode parecer uma falha na ingestão de dados. + Mantenha a visualização ao vivo ampla enquanto verifica uma nova integração. Adicione filtros somente após ver o primeiro evento; um filtro incorreto pode parecer uma falha na ingestão. -Se nenhum evento aparecer, execute `failproofai config --status` e depois [solucione problemas de ingestão](/pt-br/reference/troubleshooting). \ No newline at end of file +Se nenhum evento aparecer, execute `failproofai config --status` e depois [solucione problemas de ingestão](/pt-br/reference/troubleshooting). + +Agentes que não executam em um dos 12 [harnesses](/pt-br/reference/harnesses) suportados reportam os mesmos tipos de evento através do [Python SDK](/pt-br/reference/python-sdk), incluindo os eventos de humano no loop (`human_wait`, `human_input`, `human_interrupt`) dos quais os agentes de gateway e produção dependem. \ No newline at end of file diff --git a/docs/pt-br/sessions/overview.mdx b/docs/pt-br/sessions/overview.mdx index f99533dfd..0d93bc277 100644 --- a/docs/pt-br/sessions/overview.mdx +++ b/docs/pt-br/sessions/overview.mdx @@ -1,24 +1,26 @@ --- title: "Sessões" -description: "Comece com o registro completo de uma execução do agente." +description: "Comece com o registro completo de uma execução de agente." icon: "workflow" --- Uma sessão é o melhor ponto de partida quando um agente se comporta de forma inesperada. Ela reúne as requisições ao modelo, respostas, chamadas de ferramentas, interações humanas, erros, avaliações e decisões de políticas que pertencem a uma única execução. +As sessões têm a mesma aparência independentemente do ambiente que as gerou. Uma execução do Claude Code reescrevendo um repositório, um agente Hermes respondendo um cliente no Slack e um serviço Python instrumentado com o SDK chegam todos no mesmo formato de trace — assim, uma única visão cobre toda a frota. +
-Acompanhe uma execução do agente desde seu objetivo, passando pelas chamadas ao modelo e ferramentas, até a resposta final. +Acompanhe uma execução de agente do início ao fim — do objetivo às chamadas de modelo, ferramentas e resposta final. ## Encontrar uma sessão - 1. Na barra lateral do Cloud, vá para **Observe → Sessions**. + 1. Na barra lateral do Cloud, acesse **Observe → Sessions**. 2. Defina o intervalo de tempo e filtre por ambiente, status, agente ou ID de sessão. - 3. Adicione intervalos de pontuação ou métricas quando precisar de um recorte por qualidade, custo, tokens ou latência. + 3. Adicione intervalos de pontuação ou métricas quando precisar filtrar por qualidade, custo, tokens ou latência. 4. Selecione uma linha para abrir seu trace. Use o controle de cópia ao lado do ID de sessão ao compartilhá-lo. ![A lista de Sessions exibindo uma linha por execução com filtros de ambiente, agente, status e pontuação de avaliação.](/images/dashboard/sessions-list.png) @@ -30,7 +32,7 @@ Acompanhe uma execução do agente desde seu objetivo, passando pelas chamadas a fp --json sessions --session-id ``` - Adicione `--agents` para expandir execuções multi-agente, `--all` para paginar ou `--fields` para escolher as colunas de saída. + Adicione `--agents` para expandir execuções multi-agente, `--all` para paginar, ou `--fields` para escolher as colunas de saída. @@ -39,17 +41,17 @@ Acompanhe uma execução do agente desde seu objetivo, passando pelas chamadas a - Encontrar uma execução por agente, ambiente, tempo, modelo, tipo de evento ou estado de erro. - Acompanhar a sequência exata que produziu um resultado. - Comparar execuções bem-sucedidas e com falha. -- Abrir as evidências usadas por uma conclusão de auditoria ou incidente de alerta. +- Acessar as evidências utilizadas por uma descoberta de auditoria ou incidente de alerta. - Exportar uma sessão quando precisar de um registro offline. -## Uma ordem de investigação confiável +## Uma ordem confiável de investigação 1. Confirme o objetivo da sessão e o ambiente. -2. Encontre o primeiro erro ou decisão inesperada — não apenas a falha final. -3. Inspecione o contexto do modelo e a entrada da ferramenta imediatamente antes disso. -4. Verifique tentativas repetidas, latência e interrupções humanas. +2. Identifique o primeiro erro ou decisão inesperada — não apenas a falha final. +3. Inspecione o contexto do modelo e a entrada da ferramenta imediatamente antes do problema. +4. Verifique novas tentativas, latência e interrupções humanas. 5. Revise as pontuações de avaliação e as decisões de políticas. - Aprenda como ir do resumo da sessão até o evento que causou o resultado. + Aprenda a navegar do resumo da sessão até o evento que causou o resultado. \ No newline at end of file diff --git a/docs/pt-br/start/quickstart.mdx b/docs/pt-br/start/quickstart.mdx index 0aa74eefd..e7cee7981 100644 --- a/docs/pt-br/start/quickstart.mdx +++ b/docs/pt-br/start/quickstart.mdx @@ -4,12 +4,14 @@ description: "Capture uma sessão de agente, encontre uma falha e comece a preve icon: "zap" --- -Este guia de início rápido configura uma máquina para reportar sessões, executa uma auditoria e implanta uma política. Use a skill para configurar o Failproof, ou siga os passos manuais. Você precisa do Node.js 20.9 ou superior. +Este início rápido configura uma máquina para reportar sessões, executa uma auditoria e implanta uma política. Use a skill para configurar o Failproof ou siga os passos manuais. + +**Qual é o seu caminho?** Se o seu agente roda em um dos 12 [harnesses](/pt-br/reference/harnesses) suportados — uma CLI de codificação ou um gateway como Hermes ou OpenClaw — siga os passos abaixo; você precisa do Node.js 20.9 ou superior. Se o seu agente não tem harness, instrumente-o com o [Python SDK](/pt-br/reference/python-sdk) para rastreamento e auditorias, depois retome em [Execute sua primeira verificação de falha](/pt-br/start/first-audit); a aplicação de políticas nesse caminho requer um hook no seu runtime. - + ```bash npx skills add FailproofAI/skills ``` @@ -19,14 +21,14 @@ Este guia de início rápido configura uma máquina para reportar sessões, exec Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - Seu agente inspeciona o projeto, escolhe a integração relevante, realiza a configuração e verifica o resultado. Consulte o [repositório de skills do FailproofAI](https://github.com/FailproofAI/skills) para ver skills individuais e opções avançadas de instalação. + Seu agente inspeciona o projeto, escolhe a integração adequada, realiza a configuração e verifica o funcionamento. Consulte o [repositório de skills do FailproofAI](https://github.com/FailproofAI/skills) para skills individuais e opções avançadas de instalação. ## Antes de começar -1. Abra o [painel do Failproof AI](https://app.befailproof.ai) e crie uma conta ou entre com seu e-mail de trabalho. +1. Abra o [dashboard do Failproof AI](https://app.befailproof.ai) e crie uma conta ou faça login com seu e-mail corporativo. 2. Acesse **Administration → Keys** e crie uma chave com `events:add` e `policies:pull`. 3. Copie o segredo de uso único e armazene-o na máquina de destino: @@ -34,18 +36,18 @@ Este guia de início rápido configura uma máquina para reportar sessões, exec export FAILPROOFAI_KEY="" ``` - ## Instalar + ## Instalação - + ```bash npm install -g failproofai failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - Os transcritos de sessão são enviados por padrão. Adicione `--no-transcripts` para reportar atividade de hooks e decisões de políticas sem o conteúdo do transcrito. + As transcrições de sessão são enviadas por padrão. Adicione `--no-transcripts` para reportar atividade de hooks e decisões de políticas sem o conteúdo das transcrições. - Se esta máquina já possui histórico de agente, visualize e importe os últimos sete dias, depois aguarde a conclusão da entrega. Pule este passo em uma máquina nova. + Se esta máquina já possui histórico de agente, visualize e importe os últimos sete dias e aguarde a entrega ser concluída. Pule este passo em uma máquina nova. ```bash failproofai backfill --since 7d --dry-run @@ -55,25 +57,28 @@ export FAILPROOFAI_KEY="" Abra **Sessions** no Failproof AI e selecione uma sessão importada. - - Isso conecta o Failproof AI ao CLI do seu agente e instala as políticas integradas. Use-as para visualizar decisões de políticas locais e testar a aplicação antes que o Failproof AI audite suas sessões e escreva políticas para seus agentes. + + Isso conecta o Failproof AI ao seu harness e instala as 40 políticas integradas. Use-as para visualizar decisões de políticas locais e testar a aplicação antes que o Failproof AI audite suas sessões e escreva políticas para seus agentes. - Deixe o instalador detectar o CLI do seu agente automaticamente, ou especifique um explicitamente. + Deixe o instalador detectar seu harness automaticamente ou especifique um explicitamente. Todos os 12 são valores válidos para `--cli` — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # uma CLI de codificação + failproofai policies --install --cli hermes --scope user # um gateway Slack/Telegram ``` + + O bloqueio de uma chamada de ferramenta antes de sua execução é verificado em todos os 12. Gates de fim de turno são verificados em 8 — consulte a [capacidade de aplicação](/pt-br/reference/harnesses#enforcement-capability) para a matriz por harness. - - Siga [Execute sua primeira verificação de falhas](/pt-br/start/first-audit). Use um objetivo concreto, como "encontrar sessões em que o agente repetiu uma ferramenta com falha sem mudar sua abordagem." + + Siga [Execute sua primeira verificação de falha](/pt-br/start/first-audit). Use um objetivo concreto como "encontrar sessões em que o agente repetiu uma ferramenta com falha sem mudar sua abordagem". - - Siga [Previna sua primeira falha com uma política](/pt-br/start/first-policy). Comece no modo de observação, inspecione as correspondências e, em seguida, aplique a versão revisada. + + Siga [Previna sua primeira falha com uma política](/pt-br/start/first-policy). Comece no modo de observação, inspecione as correspondências e depois aplique a versão revisada. - Execute `failproofai config --status`. Uma configuração saudável reporta a conexão com a nuvem, o estado do daemon e se a aplicação está pausada. + Execute `failproofai config --status`. Uma configuração saudável reporta a conexão com a nuvem, o estado do daemon e se a aplicação de políticas está pausada. \ No newline at end of file diff --git a/docs/ru/index.mdx b/docs/ru/index.mdx index 09ef309ad..fec2c93a0 100644 --- a/docs/ru/index.mdx +++ b/docs/ru/index.mdx @@ -1,39 +1,41 @@ --- -title: "Сделайте вашего агента failproof" -description: "Failproof AI отслеживает поведение агента, проводит аудит сеансов на предмет сбоев и развертывает политики, которые предотвращают повторение инцидентов." +title: "Сделайте вашего агента надежным" +description: "Наблюдаемость и управление для каждой среды, в которой работают ваши агенты — кодовые CLI, шлюзы чатов, самоуправляемые ассистенты и ваши собственные инструментированные агенты." icon: "shield-check" --- -Failproof AI помогает командам понять, что делали агенты, найти места, где они сбились, и развернуть средства защиты до повторения того же поведения. +Failproof AI помогает командам понять, что сделали агенты, найти причины отказов и развернуть защиту до того, как такое поведение повторится. + +**Среда** — это то, в чем работает ваш агент. Failproof AI интегрируется с 12 средами — кодовыми CLI вроде Claude Code и Codex, шлюзами чатов вроде Hermes, самоуправляемыми ассистентами вроде OpenClaw — и одни и те же события, политики и история сеанса применяются ко всем. Агенты без среды отправляют отчеты через [Python SDK](/ru/reference/python-sdk), который их отслеживает и проверяет; для применения политики там нужен хук в вашем собственном runtime. - Используйте навык для инструментирования вашего проекта, подключите его и проверьте, что логи агента поступают. + Используйте инструмент для инструментирования проекта, подключите его и убедитесь, что логи агентов поступают. - - Анализируйте, запрашивайте, создавайте панели мониторинга и запускайте аудиты на естественном языке для логов вашего агента. + + Анализируйте, выполняйте запросы, создавайте панели мониторинга и проводите аудиты на естественном языке по логам вашего агента. - - Отслеживайте вызовы моделей, инструменты, ошибки, ввод пользователя, задержку и решения политик в одном сеансе. + + Отслеживайте вызовы моделей, инструменты, ошибки, ввод от пользователя, задержку и решения по политикам в одном сеансе. - - Проведите аудит определенного набора сеансов, проверьте результаты с подтверждением, и отслеживайте устранение как проблемы. + + Проверьте определенный набор сеансов, просмотрите выводы с доказательствами и отслеживайте исправления как задачи. - Превратите известный режим сбоя в политику, наблюдайте за ее воздействием и разверните ее на всем вашем парке агентов. + Превратите известный режим отказа в политику, наблюдайте ее влияние и разверните ее по всему вашему парку. -> **Сеанс → Аудит → Результат → Проблема → Политика**
-> Отследите, что произошло, найдите сбой, управляйте ответом, затем предотвратите то же поведение в будущих запусках. +> **Сеанс → Аудит → Вывод → Задача → Политика**
+> Отследите, что произошло, найдите отказ, управляйте ответом, затем предотвратите такое же поведение в будущих запусках. -## Начните отсюда +## С чего начать -Если вы развертываете своего первого инструментированного агента, начните с [быстрого старта](/ru/start/quickstart). Если данные уже поступают, откройте [Сеансы](/ru/sessions/overview) и проверьте реальный запуск перед настройкой аудитов или политик. +Если вы развертываете свой первый инструментированный агент, начните с [быстрого старта](/ru/start/quickstart). Если данные уже поступают, откройте [Сеансы](/ru/sessions/overview) и проверьте реальный запуск перед настройкой аудитов или политик. - - Пройдите сквозной рабочий процесс от захвата до безопасного развертывания политики. + + Пройдите полный рабочий процесс от сбора до безопасного развертывания политики. \ No newline at end of file diff --git a/docs/ru/reference/harnesses.mdx b/docs/ru/reference/harnesses.mdx index 4cbf22f42..ac3979415 100644 --- a/docs/ru/reference/harnesses.mdx +++ b/docs/ru/reference/harnesses.mdx @@ -1,64 +1,71 @@ --- -title: "Адаптеры для агентов" -description: "Захватывайте сессии и применяйте политики в поддерживаемых CLI агентов." +title: "Адаптеры агентов" +description: "Захватывайте сессии и применяйте политики во всех 12 поддерживаемых адаптерах агентов." icon: "plug-zap" --- -Failproof AI поддерживает Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI и Goose. +Адаптер — это среда, в которой фактически работает ваш агент. Failproof AI поддерживает двенадцать адаптеров, разделённых на два класса: -| Адаптер | Поддерживаемые области hook | +- **Coding CLIs** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **Шлюзы чата и ассистентов** (2) — Hermes (Slack, Telegram, cron), OpenClaw (самостоятельно развёрнутый ассистент) + +Одни и те же политики и одна и та же история сессий применяются независимо от того, в каком адаптере работает агент. Один слой адаптера преобразует собственные имена событий каждого адаптера, имена инструментов и поля входных данных инструментов в 29 канонических событий перед выполнением любой политики. + +Агент, работающий **ни в одном из** двенадцати адаптеров, инструментируется непосредственно с помощью [Python SDK](/ru/reference/python-sdk). Это другой контракт, и стоит сказать ясно: SDK обеспечивает трассировку, сессии, оценки и аудиты — **он не применяет политики самостоятельно.** Блокировка небезопасного действия перед его выполнением требует перехвата применения в границе инструмента вашего времени выполнения; [свяжитесь с нами](mailto:support@befailproof.ai) и мы это реализуем. + +| Адаптер | Поддерживаемые области перехвата | | --- | --- | | Claude Code | User, project, local | | Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | | Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | | Hermes, OpenClaw | User | -Каждая интеграция нормализует собственные имена событий hook, имена инструментов и поля входных данных инструментов перед запуском политик. Политика может действовать только на события, которые предоставляет адаптер; протестируйте поведение конца хода и инструкции на точном адаптере и версии, которые вы развертываете. +Каждая интеграция нормализует собственные имена событий перехвата, имена инструментов и поля входных данных инструментов перед выполнением политик. Политика может действовать только на события, которые предоставляет адаптер; проверьте поведение конца хода и инструкции на точном адаптере и версии, которые вы развёртываете. -## Возможности блокировки +## Возможность применения -«Блокировка» означает, что вердикт, возвращаемый текущим адаптером, обрабатывается названным адаптером. Блокировка после использования инструмента может заменить результат, показываемый модели, но не может отменить уже произошедший побочный эффект инструмента. +«Block» означает, что решение, возвращённое текущим адаптером, принимается названным адаптером. Блокировка после инструмента может заменить результат, показанный модели, но не может отменить побочный эффект инструмента, который уже произошёл. | Адаптер | Проверенные события блокировки | Замечания только для наблюдения или без блокировки | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` и несколько событий задач/конфигурации | `PostToolUse`, жизненный цикл сессии, уведомления и события после сбоя являются наблюдательными. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Блокировка после использования инструмента заменяет результат после выполнения; события начала сессии и компактизации являются наблюдательными в текущем адаптере. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Блокировка после использования инструмента заменяет результат после выполнения; события сессии и уведомления являются наблюдательными. | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` и события сессии являются наблюдательными. | -| OpenCode | `PreToolUse` | События после использования инструмента и жизненный цикл являются наблюдательными; текущая обработка остановки является рекомендацией для следующего хода, а не проверенным механизмом управления. | -| Pi | `PreToolUse`, `UserPromptSubmit` | События после использования инструмента и жизненный цикл являются наблюдательными; рекомендация по остановке применяется к следующему ходу. | -| Hermes | `PreToolUse` | Вердикты после использования инструмента, сессии и остановки подагента не являются механизмами управления. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | События после использования инструмента, сессии, остановки подагента и компактизации являются наблюдательными. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Вердикты после использования инструмента и остановки подагента являются наблюдательными. | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, условный `PermissionRequest` | Hooks разрешения не запускаются в каждом режиме разрешения; события после использования инструмента и сессии являются наблюдательными. | -| Antigravity CLI | `PreToolUse`, `Stop` | Вердикты по подсказке пользователя и после использования инструмента являются наблюдательными; инструкции по подсказкам все еще можно внедрять. | -| Goose | `PreToolUse` | События подсказки пользователя, после использования инструмента и сессии являются наблюдательными. Собственный hook остановки блокировки существует выше по потоку, но не установлен текущим адаптером. | - -Возможности зависят от версии. Повторно протестируйте после обновления CLI агента, особенно когда политика полагается на поведение подсказки, остановки, разрешения или после использования инструмента, а не на общий механизм управления перед использованием. - -## Установка hooks захвата и политик +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` и несколько событий задачи/конфигурации | `PostToolUse`, жизненный цикл сессии, уведомления и события после ошибки доступны только для наблюдения. | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Блокировка после инструмента заменяет результат после выполнения; события начала сессии и уплотнения доступны только для наблюдения в текущем адаптере. | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Блокировка после инструмента заменяет результат после выполнения; события сессии и уведомления доступны только для наблюдения. | +| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` и события сессии доступны только для наблюдения. | +| OpenCode | `PreToolUse` | События после инструмента и жизненного цикла доступны только для наблюдения; текущая обработка остановки — это рекомендация для последующего хода, а не проверенный шлюз. | +| Pi | `PreToolUse`, `UserPromptSubmit` | События после инструмента и жизненного цикла доступны только для наблюдения; рекомендация остановки применяется к последующему ходу. | +| Hermes | `PreToolUse` | Решения после инструмента, сессии и остановки субагента не являются шлюзами. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | События после инструмента, сессии, остановки субагента и уплотнения доступны только для наблюдения. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Решения после инструмента и остановки субагента доступны только для наблюдения. | +| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, условный `PermissionRequest` | Перехваты разрешений работают не во всех режимах разрешения; события после инструмента и сессии доступны только для наблюдения. | +| Antigravity CLI | `PreToolUse`, `Stop` | Решения по запросу пользователя и после инструмента доступны только для наблюдения; инструкции подсказок всё ещё можно внедрить. | +| Goose | `PreToolUse` | События запроса пользователя, после инструмента и сессии доступны только для наблюдения. Существует собственный перехват блокировки остановки выше по потоку, но он не установлен текущим адаптером. | + +Возможности зависят от версии. Перепроверьте после обновления CLI агента, особенно если политика полагается на поведение подсказки, остановки, разрешения или после инструмента, а не на обычный шлюз перед инструментом. + +## Установка перехватов захвата и политик - - 1. Откройте **Administration → Keys** и создайте ключ с разрешениями `events:add` и `policies:pull`, назвав его для машины или среды. - 2. На целевой машине подключите локальный CLI с отображаемым ключом и установите hooks адаптера. - 3. Запустите новую сессию агента, затем подтвердите её hook и события сессии в разделе **Observe → Events**. - 4. Откройте **Observe → policy** за тот же временной интервал и подтвердите, что решение политики приписано машине. + + 1. Откройте **Administration → Keys** и создайте ключ с правами `events:add` и `policies:pull`, назвав его по имени машины или окружения. + 2. На целевой машине подключите локальный CLI с отображённым ключом и установите перехваты адаптера. + 3. Запустите новую сессию агента, а затем подтвердите события перехвата и сессии в разделе **Observe → Events**. + 4. Откройте **Observe → policy** для того же временного окна и подтвердите, что решение политики атрибутировано машине. - Соединение начинается с ключа машины. Подтвердите, что он включает разрешения как на приём данных, так и на доставку политик, перед копированием его секрета. + Соединение начинается с ключа машины. Убедитесь, что он включает оба разрешения на приём и доставку политик перед копированием его секрета. - ![Новое окно создания ключа API для предоставления разрешений на приём событий и доставку политик.](/images/dashboard/key-create.png) + ![Ящик нового ключа API, используемый для предоставления разрешений на приём событий и доставку политик.](/images/dashboard/key-create.png) - После установки hooks, поток событий должен показывать новые события от подключённой машины и среды. + После установки перехватов поток событий должен показать новые события от машины и окружения, которые вы подключили. - ![Живой поток событий для подтверждения того, что недавно установленный адаптер передаёт данные.](/images/dashboard/events-stream.png) + ![Живой поток событий, используемый для подтверждения того, что вновь установленный адаптер сообщает данные.](/images/dashboard/events-stream.png) - Наконец, убедитесь, что решения политик приписаны той же машине. Это подтверждает, что адаптер передаёт как деятельность политик, так и события трассировки. + Наконец, убедитесь, что решения политик атрибутируются той же машине. Это подтверждает, что адаптер сообщает как о деятельности политик, так и о событиях трассировки. - ![Страница политик для проверки решений политик от недавно подключённого адаптера.](/images/dashboard/policy-observe.png) + ![Страница политики, используемая для проверки решений политик от вновь подключённого адаптера.](/images/dashboard/policy-observe.png) - Установите hooks для всех обнаруженных адаптеров: + Установите перехваты для каждого обнаруженного адаптера: ```bash failproofai config \ @@ -67,7 +74,7 @@ Failproof AI поддерживает Claude Code, Codex, GitHub Copilot CLI, Cu failproofai policies --install ``` - Или выберите конкретные адаптеры и область конфигурации: + Или выберите именованные адаптеры и область конфигурации: ```bash failproofai policies --install \ @@ -75,7 +82,7 @@ Failproof AI поддерживает Claude Code, Codex, GitHub Copilot CLI, Cu --scope user ``` - Область project сохраняет конфигурацию hook в репозитории. Область user охватывает работу во всех репозиториях. Claude Code также поддерживает область local; поддержка варьируется в зависимости от адаптера, и CLI отвергает неподдерживаемые комбинации. + Область проекта хранит конфигурацию перехвата в репозитории. Область пользователя охватывает работу между репозиториями. Claude Code также поддерживает локальную область; поддержка варьируется по адаптерам и CLI отклоняет неподдерживаемые комбинации. Проверьте машину и её события: @@ -87,13 +94,13 @@ Failproof AI поддерживает Claude Code, Codex, GitHub Copilot CLI, Cu -## Добавление нестандартного пути сессии +## Добавьте нестандартный путь сессии - - Дополнительные пути регистрируются на машине, а не в Cloud. После добавления одного откройте **Observe → Sessions**, отфильтруйте по среде машины и подтвердите, что сессии из нового пути появляются. Откройте сессию и проверьте агента, адаптер и временные метки событий перед использованием в аудите. + + Дополнительные пути регистрируются на машине, а не в облаке. После добавления откройте **Observe → Sessions**, отфильтруйте по окружению машины и подтвердите, что сессии с нового пути появляются. Откройте сессию и проверьте агента, адаптер и временные метки событий перед использованием в аудите. - ![Список сессий, отфильтрованный по среде, которая получает данные от дополнительного пути захвата.](/images/dashboard/sessions-list.png) + ![Список сессий, отфильтрованный по окружению, получающему данные из дополнительного пути захвата.](/images/dashboard/sessions-list.png) Добавьте путь с необязательной меткой, затем проверьте настроенные пути: @@ -105,10 +112,10 @@ Failproof AI поддерживает Claude Code, Codex, GitHub Copilot CLI, Cu failproofai backfill --since 7d ``` - Удалите путь командой `failproofai harness remove-path claude checkout`. + Удалите путь с помощью `failproofai harness remove-path claude checkout`. - Запустите одну новую сессию после установки. Проверьте как живой поток событий, так и фактическое решение политики перед расширением развёртывания. + Запустите одну новую сессию после установки. Проверьте как живой поток событий, так и актуальное решение политики перед расширением развёртывания. \ No newline at end of file diff --git a/docs/ru/sessions/live-events.mdx b/docs/ru/sessions/live-events.mdx index 53f26b031..286788ea2 100644 --- a/docs/ru/sessions/live-events.mdx +++ b/docs/ru/sessions/live-events.mdx @@ -1,21 +1,21 @@ --- -title: "Живые события" +title: "Live events" description: "Наблюдайте за активностью агента в реальном времени во время выполнения сеанса." icon: "radio" --- -Живые события помогают вам подтвердить инструментализацию и следить за рисковым запуском без ожидания завершения сеанса. +Live events помогут вам подтвердить инструментирование и отследить рискованный запуск без ожидания завершения сеанса. -## Просмотр активности +## Наблюдение за активностью 1. Перейдите в **Observe → Events**. - 2. Начните с текущего временного окна без фильтров, чтобы подтвердить поступление данных. - 3. Фильтруйте по окружению, типу события, агенту или сеансу. Используйте поиск для текста в полезной нагрузке. - 4. Выберите событие, чтобы просмотреть его сводку и детали. Следуйте ссылке сеанса для полной трассировки. + 2. Начните с текущего временного окна и без фильтров, чтобы подтвердить поступление данных. + 3. Фильтруйте по окружению, типу события, агенту или сеансу. Используйте поиск по тексту полезной нагрузки. + 4. Выберите событие, чтобы проинспектировать его резюме и детали. Перейдите по ссылке сеанса для полной трассировки. - ![Поток живых событий с фильтрами по времени, окружению, типу события, агенту, модели, контексту, сеансу и тексту.](/images/dashboard/events-stream-current.png) + ![Поток Live Events, показывающий трафик от шлюза Hermes chat рядом с запусками coding-CLI, отфильтрованный по времени, окружению, типу события, агенту, модели, контексту и сеансу.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ icon: "radio" fp --json events --full --session-id --all ``` - Канал по умолчанию опускает необработанные полезные нагрузки. Используйте `--full` только для ограниченного исследования сеанса. + Поток по умолчанию исключает исходные полезные нагрузки. Используйте `--full` только для ограниченного расследования сеанса. -Используйте поток событий, чтобы ответить на три немедленных вопроса: +Используйте поток событий, чтобы ответить на три срочных вопроса: -- Сообщает ли ожидаемый агент в правильное окружение? -- Поступают ли вызовы модели, вызовы инструментов и решения политики в правильном порядке? -- Прекратил ли сеанс прогресс или начал повторять действие? +- Отправляет ли ожидаемый агент отчёты в правильное окружение? +- Поступают ли вызовы модели, вызовы инструментов и решения политики в порядке? +- Остановил ли сеанс прогресс или начал повторять действие? -Типы событий включают события жизненного цикла агента, запросы и ответы модели, использование инструментов и результаты, выполнение hook'ов, ожидание человека и прерывания, а также явные ошибки. Идентификаторы корреляции связывают парные события, такие как вызов инструмента и его результат. +Типы событий включают события жизненного цикла агента, запросы и ответы модели, использование и результаты инструментов, выполнение хуков, ожидание человека и прерывания, а также явные ошибки. ID корреляции связывают парные события, такие как вызов инструмента и его результат. - Держите живое представление широким при проверке новой интеграции. Добавляйте фильтры только после того, как вы увидите первое событие; неправильный фильтр может выглядеть как ошибка при приёме данных. + Держите live view широким при проверке новой интеграции. Добавляйте фильтры только после того, как вы увидите первое событие; неправильный фильтр может выглядеть как неудачное поглощение. -Если события не отображаются, запустите `failproofai config --status`, затем [устраните неполадки при приёме](/ru/reference/troubleshooting). \ No newline at end of file +Если события не появляются, выполните `failproofai config --status`, затем [устраните неполадки с поглощением](/ru/reference/troubleshooting). + +Агенты, которые не работают в одном из 12 поддерживаемых [harnesses](/ru/reference/harnesses), отправляют те же типы событий через [Python SDK](/ru/reference/python-sdk), включая события взаимодействия с человеком (`human_wait`, `human_input`, `human_interrupt`), на которые полагаются шлюзовые и производственные агенты. \ No newline at end of file diff --git a/docs/ru/sessions/overview.mdx b/docs/ru/sessions/overview.mdx index c000dff16..ae038234c 100644 --- a/docs/ru/sessions/overview.mdx +++ b/docs/ru/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "Сессии" -description: "Начните с полной записи одного запуска агента." +description: "Начните с полной записи одного прогона агента." icon: "workflow" --- -Сессия — это лучшая отправная точка, когда агент ведёт себя неожиданно. Она объединяет запросы модели, ответы, вызовы инструментов, взаимодействия с человеком, ошибки, оценки и решения политик, относящиеся к одному запуску. +Сессия — это лучшая точка старта, когда агент ведёт себя неожиданно. Она объединяет запросы к модели, ответы, вызовы инструментов, взаимодействия с человеком, ошибки, оценки и решения по политикам, относящиеся к одному прогону. + +Сессии выглядят одинаково независимо от того, какая система их создала. Прогон Claude Code, переписывающий репозиторий, агент Hermes, отвечающий клиенту в Slack, и сервис на Python, инструментированный с помощью SDK, все попадают в один формат трассировки, поэтому один вид охватывает весь парк.
-Проследите один запуск агента от его цели через вызовы модели, инструменты и финальный ответ. +Проследите один прогон агента от его цели через вызовы моделей, инструменты и финальный ответ. -## Найдите сессию +## Найти сессию - 1. На боковой панели Cloud перейдите в **Observe → Sessions**. - 2. Установите временное окно, затем отфильтруйте по окружению, статусу, агенту или ID сессии. - 3. Добавьте диапазоны оценок или метрик, когда вам нужен срез по качеству, стоимости, токенам или задержке. + 1. На панели Cloud перейдите в **Observe → Sessions**. + 2. Установите временное окно, затем отфильтруйте по среде, статусу, агенту или ID сессии. + 3. Добавьте диапазоны оценки или метрик, когда вам нужен срез по качеству, стоимости, токенам или задержке. 4. Выберите строку, чтобы открыть её трассировку. Используйте элемент копирования рядом с ID сессии при её передаче. - ![Список Sessions, показывающий одну строку для каждого запуска с фильтрами по окружению, агенту, статусу и оценке результата.](/images/dashboard/sessions-list.png) + ![Список сессий с одной строкой за прогон, показывающий фильтры по среде, агенту, статусу и оценке.](/images/dashboard/sessions-list.png) ```bash @@ -30,26 +32,26 @@ icon: "workflow" fp --json sessions --session-id ``` - Добавьте `--agents` для развёртывания запусков с несколькими агентами, `--all` для разбивки по страницам или `--fields` для выбора столбцов вывода. + Добавьте `--agents` для развёртывания многоагентных прогонов, `--all` для постраничного просмотра или `--fields` для выбора столбцов вывода. ## Что вы можете делать -- Найти запуск по агенту, окружению, времени, модели, типу события или состоянию ошибки. +- Найти прогон по агенту, среде, времени, модели, типу события или состоянию ошибки. - Проследить точную последовательность, которая привела к результату. -- Сравнить успешные и неудачные запуски. -- Открыть доказательства, использованные аудитом или инцидентом оповещения. -- Экспортировать сессию, когда вам нужна офлайн-запись. +- Сравнивать успешные и неудачные прогоны. +- Открыть доказательства, использованные при обнаружении аудита или инциденте оповещения. +- Экспортировать сессию, когда вам нужна оффлайн-запись. ## Надёжный порядок расследования -1. Подтвердите цель сессии и окружение. +1. Подтвердите цель сессии и среду. 2. Найдите первую ошибку или неожиданное решение — не только финальный отказ. -3. Проверьте контекст модели и входные данные инструмента непосредственно перед ним. -4. Проверьте повторные попытки, задержку и прерывания со стороны человека. -5. Просмотрите оценки результатов и решения политик. +3. Изучите контекст модели и вход инструмента непосредственно перед этим. +4. Проверьте повторные попытки, задержку и прерывания человеком. +5. Просмотрите оценки и решения по политикам. - - Узнайте, как перейти от сводки сессии к событию, которое привело к результату. + + Узнайте, как перейти от сводки сессии к событию, вызвавшему результат. \ No newline at end of file diff --git a/docs/ru/start/quickstart.mdx b/docs/ru/start/quickstart.mdx index 2d37c6d1d..5196ebb37 100644 --- a/docs/ru/start/quickstart.mdx +++ b/docs/ru/start/quickstart.mdx @@ -1,25 +1,28 @@ --- +--- title: "Быстрый старт" -description: "Захватите сессию агента, найдите сбой и начните его предотвращать." +description: "Захватите сеанс агента, найдите сбой и начните его предотвращать." icon: "zap" --- -Этот быстрый старт настроит одну машину на отправку сессий, запустит аудит и развернет политику. Используйте навык для установки Failproof AI или следуйте ручным шагам. Вам нужен Node.js версии 20.9 или выше. +Этот быстрый старт настроит одну машину на отправку сеансов, запустит аудит и развернёт политику. Используйте умение для установки Failproof AI или следуйте ручным шагам. + +**Какой путь для вас?** Если ваш агент работает в одной из 12 поддерживаемых [оболочек](/ru/reference/harnesses) — кодирующий CLI или шлюз типа Hermes или OpenClaw — следуйте шагам ниже; вам нужен Node.js 20.9 или позже. Если ваш агент не имеет оболочки, используйте [Python SDK](/ru/reference/python-sdk) для трассировки и аудитов, затем вернитесь к разделу [Запустите первую проверку сбоев](/ru/start/first-audit); для принудительного применения на этом пути требуется хук в вашей среде выполнения. - + - + ```bash npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - Ваш агент проинспектирует проект, выберет релевантную интеграцию, выполнит настройку и проверит её. Смотрите [репозиторий навыков FailproofAI](https://github.com/FailproofAI/skills) для отдельных навыков и опций расширенной установки. + Ваш агент проверит проект, выберет нужную интеграцию, выполнит настройку и проверит её. Смотрите [репозиторий умений FailproofAI](https://github.com/FailproofAI/skills) для отдельных умений и продвинутых вариантов установки. @@ -43,9 +46,9 @@ export FAILPROOFAI_KEY="" failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - Транскрипты сессий отправляются по умолчанию. Добавьте `--no-transcripts` для отправки активности хуков и решений политик без содержимого транскриптов. + Транскрипты сеансов отправляются по умолчанию. Добавьте `--no-transcripts` для отправки активности хуков и решений политик без содержимого транскриптов. - Если на этой машине уже есть история агента, предпросмотрите и импортируйте последние семь дней, затем дождитесь завершения доставки. Пропустите этот шаг на новой машине. + Если на этой машине уже есть история агента, просмотрите и импортируйте последние семь дней, затем дождитесь завершения доставки. Пропустите этот шаг на новой машине. ```bash failproofai backfill --since 7d --dry-run @@ -53,27 +56,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - Откройте **Sessions** в Failproof AI и выберите импортированную сессию. + Откройте **Sessions** в Failproof AI и выберите импортированный сеанс. - Это присоединит Failproof AI к CLI вашего агента и установит встроенные политики. Используйте их, чтобы видеть локальные решения политик и попробовать принудительное применение до того, как Failproof AI проведет аудит ваших сессий и напишет политики для ваших агентов. + Это подключит Failproof AI к вашей оболочке и установит 40 встроенных политик. Используйте их для просмотра локальных решений политик и тестирования принудительного применения до того, как Failproof AI проведёт аудит ваших сеансов и напишет политики для ваших агентов. - Позвольте установщику автоматически обнаружить CLI вашего агента или укажите его явно. + Позвольте установщику обнаружить вашу оболочку или укажите её явно. Каждая из 12 является допустимым значением `--cli` — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # кодирующий CLI + failproofai policies --install --cli hermes --scope user # шлюз Slack/Telegram ``` + + Блокирование вызова инструмента перед его запуском проверяется на всех 12. Врата конца хода проверяются на 8 — смотрите [возможность принудительного применения](/ru/reference/harnesses#enforcement-capability) для матрицы по оболочкам. - Следуйте [Запустите первую проверку на сбои](/ru/start/first-audit). Используйте конкретную цель, такую как «найти сессии, где агент повторил попытку неудачного инструмента без изменения своего подхода». + Следуйте разделу [Запустите первую проверку сбоев](/ru/start/first-audit). Используйте конкретную цель, такую как "найти сеансы, где агент повторил неудачный вызов инструмента без изменения своего подхода." - Следуйте [Предотвратите первый сбой с помощью политики](/ru/start/first-policy). Начните в режиме наблюдения, проверьте совпадения, затем примените проверенную версию. + Следуйте разделу [Предотвратите первый сбой с помощью политики](/ru/start/first-policy). Начните в режиме наблюдения, проверьте совпадения, затем примените проверенную версию. - Запустите `failproofai config --status`. Здоровая установка сообщает о облачном подключении, состоянии демона и о том, приостановлено ли принудительное применение. + Запустите `failproofai config --status`. Здоровая установка сообщает о подключении облака, состоянии демона и о том, приостановлено ли принудительное применение. \ No newline at end of file diff --git a/docs/tr/index.mdx b/docs/tr/index.mdx index fe225ff3a..8bd25a895 100644 --- a/docs/tr/index.mdx +++ b/docs/tr/index.mdx @@ -1,39 +1,42 @@ --- -title: "Acentanızı failproof yapın" -description: "Failproof AI, ajan davranışlarını izler, oturumları hatalar açısından denetler ve tekrarlayan olayları durduran politikalar dağıtır." +--- +title: "Aracınızı failproof yapın" +description: "Aracılarınızın çalıştığı her ortam için gözlemlenebilirlik ve zorlama — kodlama CLI'ları, sohbet ağ geçitleri, kendi kendini barındıran asistanlar ve kendi enstrümente edilmiş aracılarınız." icon: "shield-check" --- -Failproof AI, takımların ajanların ne yaptığını anlamalarına, nerede başarısız olduklarını bulmalarına ve aynı davranış tekrar gerçekleşmeden önce önlemler almalarına yardımcı olur. +Failproof AI, ekiplerin aracılarının ne yaptığını anlamalarına, nerede başarısız olduklarını bulmalarına ve aynı davranış tekrar gerçekleşmeden önce güvenlik önlemleri almalarına yardımcı olur. + +Bir **harness**, aracılarınızın gerçekten çalıştığı ortamdır. Failproof AI bunlardan 12 tanesine bağlanır — Claude Code ve Codex gibi kodlama CLI'ları, Hermes gibi sohbet ağ geçitleri, OpenClaw gibi kendi kendini barındıran asistanlar — ve aynı olaylar, aynı politikalar ve aynı oturum geçmişi tümünde uygulanır. Harnessi olmayan aracılar [Python SDK](/tr/reference/python-sdk) üzerinden rapor verir; bu rapor izlenir ve denetlenir; bir politika burada uygulamak için kendi çalışma zamanınızda bir kanca gerekir. - - Projenizi enstrüman etmek, bağlamak ve ajan günlüklerinin ulaştığını doğrulamak için beceriyi kullanın. + + Projenizi enstrümente etmek, bağlamak ve aracı günlüklerinin geldiğini doğrulamak için beceriyi kullanın. - Ajan günlüklerinde analiz yapın, sorgular çalıştırın, pano oluşturun ve denetimleri doğal dilde yapın. + Aracı günlüklerinizi doğal dilde analiz edin, sorgulayın, panolar oluşturun ve denetimler çalıştırın. - - Model çağrılarını, araçları, hataları, insan girdisini, gecikmeyi ve politika kararlarını tek bir oturumda izleyin. + + Model çağrılarını, araçları, hataları, insan girdisini, gecikmesini ve politika kararlarını bir oturumda izleyin. - Tanımlanmış bir oturum kümesini denetleyin, kanıta dayalı bulguları gözden geçirin ve iyileştirmeleri sorun olarak takip edin. + Tanımlanmış bir oturum kümesini denetleyin, kanıtla desteklenen bulguları gözden geçirin ve düzeltmeyi sorun olarak izleyin. - Bilinen bir hata modunu politikaya dönüştürün, etkisini izleyin ve bunu tüm filonuzda dağıtın. + Bilinen bir başarısızlık modunu bir politikaya dönüştürün, etkisini gözlemleyin ve tüm filoğunuzda dağıtın. > **Oturum → Denetim → Bulgu → Sorun → Politika**
-> Ne olduğunu izleyin, hatayı bulun, yanıtı yönetin, ardından gelecekteki çalıştırmalarda aynı davranışı önleyin. +> Ne olduğunu izleyin, başarısızlığı bulun, yanıtı yönetin, ardından gelecekteki çalışmalarda aynı davranışı önleyin. ## Buradan başlayın -İlk enstrüman edilen ajaninızı dağıtıyorsanız, [quickstart](/tr/start/quickstart) ile başlayın. Veriler zaten geliyorsa, [Sessions](/tr/sessions/overview) açın ve denetimleri veya politikaları yapılandırmadan önce gerçek bir çalıştırmayı inceleyin. +İlk enstrümente edilmiş aracılarınızı dağıtıyorsanız, [hızlı başlangıç](/tr/start/quickstart) ile başlayın. Eğer veriler zaten geliyorsa, denetimler veya politikalar yapılandırmadan önce gerçek bir çalıştırmayı incelemek üzere [Oturumlar](/tr/sessions/overview)'ı açın. - Yakalama dan güvenli bir şekilde dağıtılan politikaya kadar uçtan uca iş akışını tamamlayın. + Yakalamadan güvenli bir şekilde dağıtılan bir politikaya kadar uçtan uca iş akışını tamamlayın. \ No newline at end of file diff --git a/docs/tr/reference/harnesses.mdx b/docs/tr/reference/harnesses.mdx index 86c60b19d..bc9a0e48f 100644 --- a/docs/tr/reference/harnesses.mdx +++ b/docs/tr/reference/harnesses.mdx @@ -1,65 +1,71 @@ --- ---- -title: "Agent harnesses" -description: "Desteklenen agent CLI'lerinde oturumları yakala ve politikaları uygula." +title: "Ajan donanımları" +description: "Oturumları yakala ve desteklenen 12 ajan donanımının tümü arasında politikaları uygula." icon: "plug-zap" --- -Failproof AI, Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI ve Goose'u destekler. +Donanım, ajanınızın gerçekte çalıştığı her şeydir. Failproof AI, bunlardan on ikisini destekler ve iki sınıfa ayrılırlar: + +- **Kodlama CLI'leri** (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) + +Bir ajan hangi donanımda çalışırsa çalışsın, aynı politikalar ve aynı oturum geçmişi geçerlidir. Bir adaptör katmanı, her donanımın yerel olay adlarını, araç adlarını ve araç giriş alanlarını herhangi bir politika çalıştırılmadan önce 29 kanonik olaya eşler. + +On ikisinden **hiçbirinde** çalışmayan bir ajan, [Python SDK](/tr/reference/python-sdk) ile doğrudan enstrümante edilir. Bu farklı bir sözleşmedir ve açıkça belirtilmeye değer: SDK izleme, oturumlar, değerlendirmeler ve denetimler sağlar — **kendi başına politikaları uygulamaz.** Güvensiz bir eylemi yürütülmeden önce engellemek, çalışma zamanınızın araç sınırında bir uygulama kancası gerekir; [bizimle iletişime geçin](mailto:support@befailproof.ai) ve bunu eşleştireceğiz. -| Harness | Desteklenen hook kapsamları | +| Donanım | Desteklenen kanca kapsamları | | --- | --- | -| Claude Code | User, project, local | -| Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | -| Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | -| Hermes, OpenClaw | User | +| 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 hook olay adlarını, araç adlarını ve araç giriş alanlarını normalleştirir. Bir politika yalnızca harness'in ortaya çıkardığı olaylara etki edebilir; dağıttığınız tam harness ve sürümde tur sonu ve talimat davranışını test edin. +Her entegrasyon, politikalar çalıştırılmadan önce yerel kanca olay adlarını, araç adlarını ve araç giriş alanlarını normalleştirir. Bir politika yalnızca donanımın açığa çıkardığı olaylara etki edebilir; tam olarak dağıtacağınız donanımda ve sürümde turun sonu ve talimat davranışını test edin. ## Uygulama yeteneği -"Block" (engelle), adlandırılmış harness tarafından tüketilen geçerli adaptörün döndürülen kararı anlamına gelir. Araçtan sonra engelleme, modele gösterilen sonucu değiştirebilir ancak zaten gerçekleşen bir araç yan etkisini geri alamaz. +"Engelle" anlamı, adlandırılan donanım tarafından tüketilen geçerli adaptörün dönüş kararıdır. Araç sonrası engelleme, modele gösterilen sonucu değiştirebilir ancak zaten gerçekleşen bir araç yan etkisini geri alamaz. -| Harness | Doğrulanan engelleme olayları | Gözlem amaçlı veya engellenemeyen uyarılar | +| Donanım | 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özlemcidir. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Araçtan sonra engelleme, yürütmeden sonra sonucu değiştirir; oturum başlangıcı ve kompakt olaylar mevcut adaptörde gözlemcidir. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Araçtan sonra engelleme, yürütmeden sonra sonucu değiştirir; oturum ve bildirim olayları gözlemcidir. | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` ve oturum olayları gözlemcidir. | -| OpenCode | `PreToolUse` | Araçtan sonra ve yaşam döngüsü olayları gözlemcidir; mevcut durma işleme, doğrulanmış bir kapı yerine daha sonraki bir tur için rehberlikdir. | -| Pi | `PreToolUse`, `UserPromptSubmit` | Araçtan sonra ve yaşam döngüsü olayları gözlemcidir; durma rehberliği daha sonraki bir tura uygulanır. | -| Hermes | `PreToolUse` | Araçtan sonra, oturum ve subagent-stop kararları kapı değildir. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Araçtan sonra, oturum, subagent-stop ve kompaksiyon olayları gözlemcidir. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Araçtan sonra ve subagent-stop kararları gözlemcidir. | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, koşullu `PermissionRequest` | İzin kancaları her izin modunda çalışmaz; araçtan sonra ve oturum olayları gözlemcidir. | -| Antigravity CLI | `PreToolUse`, `Stop` | Kullanıcı istemi ve araçtan sonra kararlar gözlemcidir; isteme talimatlar yine de enjekte edilebilir. | -| Goose | `PreToolUse` | Kullanıcı istemi, araçtan sonra ve oturum olayları gözlemcidir. Yerli bir engelleme durma kancası yukarı akışta mevcut ancak mevcut adaptör tarafından yüklenmez. | - -Yetenekler sürüme duyarlıdır. Bir agent CLI'yi yükselttikten sonra, özellikle bir politika genel ön araç kapısı yerine isteme, durma, izin veya araçtan sonra davranışına bağlı olduğunda yeniden test edin. - -## Yakalama ve politika kancalarını yükle +| 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 görev 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örde 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 durdurma işlemi doğrulanmış bir kapı yerine daha sonraki bir turun rehberidir. | +| Pi | `PreToolUse`, `UserPromptSubmit` | Araç sonrası ve yaşam döngüsü olayları gözlemseldir; durdurma rehberi daha sonraki bir turla ilgilidir. | +| Hermes | `PreToolUse` | Araç sonrası, oturum ve alt ajan durdurma kararları kapı değildir. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Araç sonrası, oturum, alt ajan durdurma ve sıkıştırma olayları gözlemseldir. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Araç sonrası ve alt ajan durdurma 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ı istemi ve araç sonrası kararları gözlemseldir; hızlı talimatlar yine de enjekte edilebilir. | +| Goose | `PreToolUse` | Kullanıcı istemi, araç sonrası ve oturum olayları gözlemseldir. Yukarıda yerleşik bir engelleme durdurma kancası vardır 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ından ziyade hızlı, durdurma, izin veya araç sonrası davranışına dayanıyorsa. + +## Yakalama ve politika kancalarını yükleyin - - 1. **Administration → Keys** öğesini açın ve `events:add` ve `policies:pull` izinleriyle makine veya ortam için adlandırılmış bir anahtar oluşturun. - 2. Hedef makinede, yerel CLI'yi görüntülenen anahtarla bağlayın ve harness kancalarını yükleyin. - 3. Yeni bir agent oturumu başlatın, ardından **Observe → Events** altında hook ve oturum olaylarını onaylayın. - 4. Aynı zaman penceresi için **Observe → policy** öğesini açın ve bir politika kararının makineye atandığını onaylayın. + + 1. **Yönetim → Anahtarlar**'ı açın ve `events:add` ve `policies:pull` ile makine veya ortam için adlandırılmış bir anahtar oluşturun. + 2. Hedef makinede, yerel CLI'yi gösterilen anahtarla bağlayın ve donanım kancalarını yükleyin. + 3. Yeni bir ajan oturumu başlatın, ardından **Gözlemle → Olaylar**'ın altında kanca ve oturum olaylarını onaylayın. + 4. Aynı zaman penceresi için **Gözlemle → politika**'yı açın ve politika kararının makineye atandığını onaylayın. Bağlantı bir makine anahtarıyla başlar. Sırrını kopyalamadan önce hem alım hem de politika teslimi izinlerini içerdiğini onaylayın. - ![Etkinlik alımı ve politika teslimi izinleri vermek için kullanılan yeni API anahtarı çekmeceси.](/images/dashboard/key-create.png) + ![Olay alımı ve politika teslimi izinleri vermek için kullanılan yeni API anahtar çekmeceği.](/images/dashboard/key-create.png) - Kancaları yükledikten sonra, Events akışı bağladığınız makineden ve ortamdan yeni olayları göstermelidir. + Kancaları yükledikten sonra, Olaylar akışı bağladığınız makine ve ortamdan yeni olayları göstermelidir. - ![Yeni yüklenen bir harness'in rapor ettiğini onaylamak için kullanılan canlı Events akışı.](/images/dashboard/events-stream.png) + ![Yeni yüklenen donanımın raporladığını onaylamak için kullanılan canlı Olaylar akışı.](/images/dashboard/events-stream.png) - Son olarak, politika kararlarının aynı makineye atandığını doğrulayın. Bu, harness'in izleme olaylarının yanı sıra politika etkinliğini de rapor ettiğini doğrular. + Son olarak, politika kararlarının aynı makineye atandığını doğrulayın. Bu, donanımın izleme olaylarının yanı sıra politika aktivitesini de rapor ettiğini doğrular. - ![Yeni bağlanmış bir harness'ten gelen politika kararlarını doğrulamak için kullanılan Policy sayfası.](/images/dashboard/policy-observe.png) + ![Yeni bağlanan donanımdan politika kararlarını doğrulamak için kullanılan Politika sayfası.](/images/dashboard/policy-observe.png) - Tespit edilen her harness için kancaları yükleyin: + Algılanan her donanım için kancaları yükleyin: ```bash failproofai config \ @@ -68,7 +74,7 @@ Yetenekler sürüme duyarlıdır. Bir agent CLI'yi yükselttikten sonra, özelli failproofai policies --install ``` - Veya adlandırılmış harnesses ve yapılandırma kapsamını hedefleyin: + Veya adlandırılmış donanımlar ve yapılandırma kapsamı hedefleyin: ```bash failproofai policies --install \ @@ -76,7 +82,7 @@ Yetenekler sürüme duyarlıdır. Bir agent CLI'yi yükselttikten sonra, özelli --scope user ``` - Proje kapsamı hook yapılandırmasını bir depo ile tutar. Kullanıcı kapsamı depolar arasında çalışmayı kapsar. Claude Code ayrıca yerel kapsamı destekler; destek harness'e göre değişir ve CLI desteklenmeyen kombinasyonları reddeder. + Proje kapsamı kanca yapılandırmasını depo ile birlikte tutar. Kullanıcı kapsamı depolar arasında çalışmayı kapsar. Claude Code aynı zamanda yerel kapsamı destekler; destek donanıma göre değişir ve CLI desteklenmeyen kombinasyonları reddeder. Makineyi ve olaylarını doğrulayın: @@ -88,16 +94,16 @@ Yetenekler sürüme duyarlıdır. Bir agent CLI'yi yükselttikten sonra, özelli -## Varsayılan olmayan oturum yolu ekle +## Varsayılan olmayan oturum yolu ekleyin - - Ek yollar makinede kaydedilir, Cloud'da değil. Bir tane ekledikten sonra, **Observe → Sessions** öğesini açın, ortamı makineye filtreleyin ve yeni yoldan oturumların göründüğünü onaylayın. Bir oturumu açın ve buna güvenmeden önce aracı, harness'i ve etkinlik zaman damgalarını kontrol edin. + + Ek yollar makinede kaydedilir, Bulutla değil. Birini ekledikten sonra, **Gözlemle → Oturumlar**'ı açın, ortamı makineye filtreleyin ve yeni yoldan oturumlar göründüğünü onaylayın. Bir oturumu açın ve bir denetimde buna güvenmeden önce ajan, donanım ve olay zaman damgalarını kontrol edin. - ![Ek yakalama yolundan veri alan ortama filtrelenen Sessions listesi.](/images/dashboard/sessions-list.png) + ![Ek yakalama yolundan veri alan ortama filtrelen Oturumlar listesi.](/images/dashboard/sessions-list.png) - İsteğe bağlı bir etiketle bir yol ekleyin, ardından yapılandırılan yolları inceleyin: + İsteğe bağlı bir etiketle yol ekleyin, ardından yapılandırılmış yolları inceleyin: ```bash failproofai harness add-path claude checkout=/srv/checkout/.claude @@ -111,5 +117,5 @@ Yetenekler sürüme duyarlıdır. Bir agent CLI'yi yükselttikten sonra, özelli - Yüklemeden sonra bir yeni oturum çalıştırın. Dağıtımı genişletmeden önce hem canlı etkinlik akışını hem de gerçek bir politika kararını doğrulayı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. \ No newline at end of file diff --git a/docs/tr/sessions/live-events.mdx b/docs/tr/sessions/live-events.mdx index f024ee6cf..b89e767a0 100644 --- a/docs/tr/sessions/live-events.mdx +++ b/docs/tr/sessions/live-events.mdx @@ -4,18 +4,18 @@ description: "Oturum çalışırken aracı etkinliğini gerçek zamanlı olarak icon: "radio" --- -Canlı etkinlikler, enstrümantasyonunuzu doğrulamanıza ve oturum bitene kadar beklemeden riskli bir çalıştırmayı izlemenize yardımcı olur. +Canlı etkinlikler, enstrümantasyonunuzu doğrulamanıza ve oturumun bitmesini beklemeden riskli bir çalışmayı izlemenize yardımcı olur. -## Etkinliği izleyin +## Etkinliği izle - - 1. **Gözlemle → Etkinlikler** bölümüne gidin. - 2. Verilerin geldiğini doğrulamak için mevcut zaman penceresinden başlayın ve hiçbir filtre kullanmayın. - 3. Ortam, etkinlik türü, aracı veya oturum ile filtreleyin. Yük metni için arama kullanın. - 4. Özet ve detaylarını incelemek için bir etkinliği seçin. Tam iz için oturum bağlantısını takip edin. + + 1. **Observe → Events** bölümüne gidin. + 2. Verilerin geldiğini doğrulamak için mevcut zaman penceresiyle başlayın ve filtre kullanmayın. + 3. Ortam, etkinlik türü, aracı veya oturum ile filtreleyin. Yük metni için aramayı kullanın. + 4. Bir etkinliği seçerek özet ve ayrıntılarını inceleyin. Tam trace için oturum bağlantısını izleyin. - ![Zaman, ortam, etkinlik türü, aracı, model, bağlam, oturum ve metin filtrelerine sahip canlı Etkinlikler akışı.](/images/dashboard/events-stream-current.png) + ![Hermes sohbet ağ geçidinden gelen trafik ile kodlama-CLI çalışmalarını gösteren canlı Events akışı, zaman, ortam, etkinlik türü, aracı, model, bağlam ve oturuma göre filtrelenmiş.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ Canlı etkinlikler, enstrümantasyonunuzu doğrulamanıza ve oturum bitene kadar fp --json events --full --session-id --all ``` - Varsayılan akış ham yükleri hariç tutar. `--full` seçeneğini yalnızca sınırlı bir oturum araştırması için kullanın. + Varsayılan akış ham yüklemleri hariç tutar. `--full` seçeneğini yalnızca sınırlı bir oturum araştırması için kullanın. -Üç temel soruya yanıt vermek için etkinlik akışını kullanın: +Etkinlik akışını üç acil soruyu cevaplamak için kullanın: -- Beklenen aracı doğru ortama rapor veriyor mu? -- Model çağrıları, araç çağrıları ve politika kararları sıra ile gelmekte midir? -- Oturum ilerlemeyi durdurdu mu yoksa bir eylemi tekrarlamaya mı başladı? +- Beklenen aracı doğru ortama raporlama yapıyor mu? +- Model çağrıları, araç çağrıları ve ilke kararları sırayla geliyorlar mı? +- Oturum ilerleme yapmayı durdurdu mu veya bir işlemi tekrar etmeye başladı mı? -Etkinlik türleri, aracı yaşam döngüsü etkinlikleri, model istekleri ve yanıtları, araç kullanımı ve sonuçları, kancı yürütme, insan beklemeleri ve kesintileri ile açık hataları içerir. Korelasyon kimlikleri, araç çağrısı ve sonucu gibi eşleştirilmiş etkinlikleri birleştirir. +Etkinlik türleri aracı yaşam döngüsü etkinlikleri, model istekleri ve yanıtları, araç kullanımı ve sonuçları, kancacık yürütme, insan bekletme ve kesintileri ve açık hatalar içerir. Korelasyon kimlikleri, araç çağrısı ve sonucu gibi eşleştirilmiş etkinlikleri birleştirir. - Yeni bir entegrasyon doğrularken canlı görünümü geniş tutun. Yalnızca ilk etkinliği gördükten sonra filtre ekleyin; hatalı bir filtre başarısız bir alımı andıran bir görünüm oluşturabilir. + Yeni bir entegrasyonu doğrularken canlı görünümü geniş tutun. İlk etkinliği gördükten sonra filtreleri ekleyin; hatalı bir filtre başarısız alım gibi görünebilir. -Hiçbir etkinlik görünmüyorsa `failproofai config --status` komutunu çalıştırın, ardından [alımı sorun gider](/tr/reference/troubleshooting) bölümünü okuyun. \ No newline at end of file +Hiçbir etkinlik görünmezse, `failproofai config --status` komutunu çalıştırın, ardından [alım sorunlarını giderin](/tr/reference/troubleshooting). + +Desteklenen 12 [harness](/tr/reference/harnesses) türünden birinde çalışmayan aracılar, insan-döngüde-etkinlikleri (`human_wait`, `human_input`, `human_interrupt`) dahil olmak üzere aynı etkinlik türlerini [Python SDK](/tr/reference/python-sdk) aracılığıyla raporlar. Bu etkinlikler, ağ geçidi ve üretim aracılarının bağlı olduğu etkinliklerdir. \ No newline at end of file diff --git a/docs/tr/sessions/overview.mdx b/docs/tr/sessions/overview.mdx index 3911f2f5f..2ea9bcd7f 100644 --- a/docs/tr/sessions/overview.mdx +++ b/docs/tr/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "Oturumlar" -description: "Bir aracı çalışmasının tam kaydıyla başlayın." +description: "Tek bir aracı çalışmasının tam kaydıyla başlayın." icon: "workflow" --- -Bir oturum, bir aracı beklenmedik şekilde davrandığında başlamanız gereken en iyi noktadır. Bir çalışmaya ait olan model isteklerini, yanıtlarını, araç çağrılarını, insan etkileşimlerini, hataları, değerlendirmeleri ve politika kararlarını bir araya getirir. +Bir oturum, bir aracı beklenmedik şekilde davrandığında başlamak için en iyi başlangıç noktasıdır. Model isteklerini, yanıtlarını, araç çağrılarını, insan etkileşimlerini, hataları, değerlendirmeleri ve tek bir çalışmaya ait politika kararlarını bir araya getirir. + +Oturumlar, onları hangi araç ortamı üretirse üretsin aynı görünür. Bir depoyu yeniden yazan Claude Code çalışması, Slack'te müşteriye yanıt veren bir Hermes aracısı ve SDK ile enstrüman edilen bir Python hizmeti, hepsi aynı trace formatında yer aldığından, bir görünüm tüm filo için yeterlidir.
-Bir aracı çalışmasını hedefinizden model çağrıları, araçlar ve nihai yanıta kadar takip edin. +Tek bir aracı çalışmasını hedefinden model çağrıları, araçlar ve son yanıt yoluyla takip edin. -## Bir oturumu bulun +## Oturum bulma - 1. Cloud kenar çubuğunda **Observe → Sessions** öğesine gidin. + 1. Cloud kenar çubuğunda **Observe → Sessions** bölümüne gidin. 2. Zaman penceresini ayarlayın, ardından ortam, durum, aracı veya oturum kimliğine göre filtreleyin. 3. Kalite, maliyet, token veya gecikme dilimi gerektiğinde puan veya metrik aralıkları ekleyin. - 4. İzini açmak için bir satırı seçin. Oturumu paylaşırken oturum kimliğinin yanındaki kopyalama denetimini kullanın. + 4. Trace'i açmak için bir satıra tıklayın. Oturum kimliğinin yanındaki kopyalama kontrolünü paylaşırken kullanın. - ![Ortam, aracı, durum ve değerlendirme puanı filtreleriyle her çalışma için bir satır gösteren Oturumlar listesi.](/images/dashboard/sessions-list.png) + ![Ortam, aracı, durum ve değerlendirme puanı filtrelerine sahip çalışma başına bir satır gösteren Oturumlar listesi.](/images/dashboard/sessions-list.png) ```bash @@ -30,26 +32,26 @@ Bir aracı çalışmasını hedefinizden model çağrıları, araçlar ve nihai fp --json sessions --session-id ``` - Çok aracılı çalışmaları genişletmek için `--agents` ekleyin, sayfalamak için `--all` ekleyin veya çıktı sütunlarını seçmek için `--fields` ekleyin. + Çok aracılı çalışmaları genişletmek için `--agents` ekleyin, sayfalandırmak için `--all` ekleyin veya çıkış sütunlarını seçmek için `--fields` ekleyin. -## Yapabilecekleriniz +## Yapabileceğiniz şeyler -- Bir çalışmayı aracı, ortam, zaman, model, olay türü veya hata durumuna göre bulun. -- Bir sonuç üreten tam sırayı takip edin. +- Aracı, ortam, zaman, model, olay türü veya hata durumuna göre bir çalışma bulun. +- Bir sonuca yol açan tam sırayı takip edin. - Başarılı ve başarısız çalışmaları karşılaştırın. -- Bir denetim bulgusu veya uyarı olayı tarafından kullanılan kanıtları açın. -- Çevrimdışı bir kayda ihtiyacınız olduğunda bir oturumu dışa aktarın. +- Bir denetim bulgusunun veya uyarı olayının kullandığı kanıtları açın. +- Çevrimdışı kayıt gerektiğinde bir oturum dışa aktarın. ## Güvenilir bir araştırma sırası 1. Oturum hedefini ve ortamını onaylayın. -2. İlk hatayı veya beklenmedik kararı bulun—yalnızca son başarısızlığı değil. -3. Model bağlamını ve araç girdisini hemen öncesinde inceleyin. -4. Yeniden denemeleri, gecikmeyi ve insan müdahalelerini kontrol edin. +2. İlk hatayı veya beklenmedik kararı bulun—yalnızca son hatayı değil. +3. Hemen öncesindeki model bağlamını ve araç girişini inceleyin. +4. Yeniden denemeleri, gecikmeyi ve insan müdahaleleri kontrol edin. 5. Değerlendirme puanlarını ve politika kararlarını gözden geçirin. - - Oturum özetinden sonucu ortaya çıkaran olaya nasıl geçileceğini öğrenin. + + Oturum özetinden sonucu etkileyen olaya nasıl geçileceğini öğrenin. \ No newline at end of file diff --git a/docs/tr/start/quickstart.mdx b/docs/tr/start/quickstart.mdx index 17dbb21e3..24b0c6b3c 100644 --- a/docs/tr/start/quickstart.mdx +++ b/docs/tr/start/quickstart.mdx @@ -1,41 +1,42 @@ --- ---- title: "Hızlı Başlangıç" -description: "Bir aracı oturumunu yakalayın, bir hatayı bulun ve onu engellemeye başlayın." +description: "Bir agent oturumunu yakalayın, bir hatayı bulun ve onu önlemeye başlayın." icon: "zap" --- -Bu hızlı başlangıç, bir makinenin oturum raporlaması sağlar, bir denetim çalıştırır ve bir politika dağıtır. Failproof AI'ı kurmak için beceriyi kullanın veya manuel adımları izleyin. Node.js 20.9 veya daha yeni bir sürüm gereklidir. +Bu hızlı başlangıç, bir makineyi oturum raporlamaya başlatır, bir denetim çalıştırır ve bir politika dağıtır. Failproof AI'ı ayarlamak için beceriyi kullanın veya manuel adımları izleyin. + +**Sizin yolunuz hangisi?** Agent'ınız 12 desteklenen [harness](/tr/reference/harnesses) türünden birinde çalışıyorsa — bir kodlama CLI'si, Hermes veya OpenClaw gibi bir ağ geçidi — aşağıdaki adımları izleyin; Node.js 20.9 veya üzeri sürüme ihtiyacınız vardır. Agent'ınızın harness'i yoksa, izleme ve denetim için [Python SDK](/tr/reference/python-sdk) ile enstrümente edin, ardından [İlk başarısızlık kontrolünü çalıştırın](/tr/start/first-audit) konusunda devam edin; o yoldaki uygulama, çalışma zamanınızda bir hook gerektirir. - + ```bash npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - Aracınız projeyi inceleyecek, ilgili entegrasyonu seçecek, kurulumu gerçekleştirecek ve doğrulayacaktır. Bireysel beceriler ve gelişmiş kurulum seçenekleri için [FailproofAI beceriler deposuna](https://github.com/FailproofAI/skills) bakın. + Agent'ınız projeyi inceler, ilgili entegrasyonu seçer, kurulumu gerçekleştirir ve doğrular. Bireysel beceriler ve ileri kurulum seçenekleri için [FailproofAI beceri deposu](https://github.com/FailproofAI/skills) bölümüne bakın. ## Başlamadan önce -1. [Failproof AI panosunu](https://app.befailproof.ai) açın ve bir hesap oluşturun veya iş e-postanızla oturum açın. -2. **Administration → Keys** bölümüne gidin ve `events:add` ve `policies:pull` izinleriyle bir anahtar oluşturun. -3. Tek seferlik sırrı kopyalayın ve hedef makinede saklayın: +1. [Failproof AI panosunu](https://app.befailproof.ai) açın ve hesap oluşturun veya iş e-postanızla oturum açın. +2. **Yönetim → Anahtarlar** konusuna gidin ve `events:add` ve `policies:pull` izinleriyle bir anahtar oluşturun. +3. Tek kullanımlık sırrı kopyalayın ve hedef makinede depolayın: ```bash export FAILPROOFAI_KEY="" ``` - ## Yükleme + ## Yükleyin @@ -44,9 +45,9 @@ export FAILPROOFAI_KEY="" failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY" ``` - Oturum transkriptleri varsayılan olarak gönderilir. Transkript içeriği olmadan kanca etkinliğini ve politika kararlarını raporlamak için `--no-transcripts` ekleyin. + Oturum transkriptleri varsayılan olarak gönderilir. Transkript içeriği olmadan hook aktivitesi ve politika kararlarını raporlamak için `--no-transcripts` ekleyin. - Bu makinede zaten bir aracı geçmişi varsa, son yedi günü önizleyin ve içe aktarın, ardından tesliminin bitmesini bekleyin. Yeni bir makinede bu adımı atlayın. + Bu makinede zaten agent geçmişi varsa, son yedi günü önizleyin ve içe aktarın, ardından teslimin bitmesini bekleyin. Yeni bir makinede bu adımı atlayın. ```bash failproofai backfill --since 7d --dry-run @@ -54,27 +55,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - Failproof AI'da **Sessions** bölümünü açın ve içe aktarılan bir oturumu seçin. + Failproof AI'da **Oturumlar**'ı açın ve içe aktarılan bir oturumu seçin. - - Bu, Failproof AI'ı aracı CLI'nize bağlar ve yerleşik politikaları yükler. Bunları yerel politika kararlarını görmek ve Failproof AI oturumlarınızı denetlemesi ve aracılarınız için politikalar yazması için uygulanmadan önce kullanın. + + Bu, Failproof AI'ı harness'inize bağlar ve 40 yerleşik politikayı yükler. Bunları, yerel politika kararlarını görmek ve Failproof AI oturumlarınızı denetlemeden ve agent'larınız için politikalar yazmadan önce uygulamayı denemek için kullanın. - Yükleyicinin aracı CLI'nizi algılamasına izin verin veya açıkça bir tane adlandırın. + Yükleyicinin harness'i algılamasına izin verin veya açıkça bir tane adlandırın. 12'nin her biri geçerli bir `--cli` değeridir — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # a coding CLI + failproofai policies --install --cli hermes --scope user # a Slack/Telegram gateway ``` + + Bir tool çağrısını çalışmadan önce bloke etmek 12'sinde de doğrulanır. Tur sonu geçitleri 8'inde doğrulanır — per-harness matrisi için [uygulama yeteneği](/tr/reference/harnesses#enforcement-capability) bölümüne bakın. - [İlk hata kontrolünüzü çalıştırın](/tr/start/first-audit) bölümünü izleyin. Somut bir hedef kullanın; örneğin "aracının başarısız bir aracı yaklaşımını değiştirmeden yeniden denediği oturumları bulun." + [İlk başarısızlık kontrolünüzü çalıştırın](/tr/start/first-audit) konusunu izleyin. "Agent'ın yaklaşımını değiştirmeden başarısız olan bir tool'u yeniden denediği oturumları bul" gibi somut bir hedef kullanın. - - [İlk hatayı bir politikayla önleyin](/tr/start/first-policy) bölümünü izleyin. Gözlem modunda başlayın, eşleşmeleri inceleyin, ardından gözden geçirilen sürümü uygulayın. + + [İlk başarısızlığınızı bir politikayla önleyin](/tr/start/first-policy) konusunu izleyin. Gözlem modunda başlayın, eşleşmeleri inceleyin, ardından incelenen sürümü uygulayın. - `failproofai config --status` komutunu çalıştırın. Sağlıklı bir kurulum bulut bağlantısını, daemon durumunu ve uygulamanın duraklatılıp duraklatılmadığını bildirir. + `failproofai config --status` komutunu çalıştırın. Sağlıklı bir kurulum, bulut bağlantısını, daemon durumunu ve uygulamanın duraklatılıp duraklatılmadığını raportar. \ No newline at end of file diff --git a/docs/vi/index.mdx b/docs/vi/index.mdx index 78c3f6ad7..5dbe3529b 100644 --- a/docs/vi/index.mdx +++ b/docs/vi/index.mdx @@ -1,40 +1,41 @@ --- ---- -title: "Làm cho agent của bạn không thể sai" -description: "Failproof AI theo dõi hành vi agent, kiểm toán các phiên để tìm lỗi, và triển khai các chính sách ngăn chặn những sự cố lặp lại." +title: "Làm cho agent của bạn chống lỗi" +description: "Quan sát và thực thi cho mọi harness mà agent của bạn chạy — coding CLI, chat gateway, trợ lý tự lưu trữ, và agent được cấu hình của bạn." icon: "shield-check" --- -Failproof AI giúp các nhóm hiểu agent đã làm gì, tìm ra nơi chúng thất bại, và triển khai các biện pháp bảo vệ trước khi cùng một hành vi xảy ra lại. +Failproof AI giúp các team hiểu agent đã làm gì, tìm ra nơi chúng thất bại, và triển khai các biện pháp bảo vệ trước khi hành động tương tự xảy ra lại. + +**Harness** là bất cứ thứ gì mà agent thực sự chạy bên trong. Failproof AI kết nối 12 harness — coding CLI như Claude Code và Codex, chat gateway như Hermes, trợ lý tự lưu trữ như OpenClaw — và các sự kiện, chính sách và lịch sử session giống nhau áp dụng cho từng cái. Agent không có harness báo cáo thông qua [Python SDK](/vi/reference/python-sdk), được truy vết và kiểm toán; thực thi chính sách ở đó cần một hook trong runtime của bạn. - Sử dụng skill để cấu trúc dự án của bạn, kết nối nó, và xác minh rằng các log agent đã được nhận. + Sử dụng công cụ để cấu hình dự án của bạn, kết nối nó, và xác minh rằng nhật ký agent tới. - Phân tích, truy vấn, xây dựng bảng điều khiển, và chạy kiểm toán bằng ngôn ngữ tự nhiên trên các log agent của bạn. + Phân tích, truy vấn, xây dựng dashboard, và chạy kiểm toán bằng ngôn ngữ tự nhiên trên nhật ký agent của bạn. - Theo dõi các lệnh gọi mô hình, công cụ, lỗi, đầu vào của con người, độ trễ, và quyết định chính sách trong một phiên. + Theo dõi model call, tool, lỗi, input từ con người, độ trễ, và quyết định chính sách trong một session. - - Kiểm toán một tập hợp các phiên được xác định, xem xét các phát hiện được hỗ trợ bằng bằng chứng, và theo dõi khắc phục sự cố như các vấn đề. + + Kiểm toán một tập hợp session được xác định, xem lại các phát hiện có bằng chứng, và theo dõi khắc phục như các vấn đề. - - Chuyển đổi một chế độ lỗi đã biết thành chính sách, quan sát tác động của nó, và triển khai nó trên toàn bộ đội của bạn. + + Chuyển một chế độ thất bại đã biết thành chính sách, quan sát tác động của nó, và triển khai nó trên toàn bộ fleet của bạn. -> **Phiên → Kiểm toán → Phát hiện → Vấn đề → Chính sách**
-> Theo dõi những gì đã xảy ra, tìm lỗi, quản lý phản ứng, sau đó ngăn chặn cùng một hành vi trong các lần chạy tiếp theo. +> **Session → Audit → Finding → Issue → Policy**
+> Truy vết điều gì đã xảy ra, tìm ra thất bại, quản lý phản ứng, rồi ngăn chặn hành động tương tự trong các lần chạy trong tương lai. -## Bắt đầu từ đây +## Bắt đầu ở đây -Nếu bạn đang triển khai agent được cấu trúc đầu tiên, hãy bắt đầu với [quickstart](/vi/start/quickstart). Nếu dữ liệu đã đến, hãy mở [Sessions](/vi/sessions/overview) và kiểm tra một lần chạy thực tế trước khi cấu hình kiểm toán hoặc chính sách. +Nếu bạn đang triển khai agent được cấu hình lần đầu tiên, hãy bắt đầu với [hướng dẫn nhanh](/vi/start/quickstart). Nếu dữ liệu đã tới, mở [Sessions](/vi/sessions/overview) và kiểm tra một lần chạy thực tế trước khi cấu hình kiểm toán hoặc chính sách. - - Hoàn thành quy trình làm việc từ đầu đến cuối từ bắt đầu đến triển khai chính sách một cách an toàn. + + Hoàn thành quy trình từ đầu đến cuối từ capture đến một chính sách được triển khai an toàn. \ No newline at end of file diff --git a/docs/vi/reference/harnesses.mdx b/docs/vi/reference/harnesses.mdx index 482b87e18..6c26db6f8 100644 --- a/docs/vi/reference/harnesses.mdx +++ b/docs/vi/reference/harnesses.mdx @@ -1,64 +1,72 @@ --- -title: "Tích hợp Agent" -description: "Ghi lại phiên làm việc và áp dụng chính sách trong các CLI agent được hỗ trợ." +--- +title: "Các harness của Agent" +description: "Ghi lại các phiên làm việc và thực thi các chính sách trên tất cả 12 harness được hỗ trợ." icon: "plug-zap" --- -Failproof AI hỗ trợ Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI, và Goose. +Harness là bất kỳ thứ gì mà agent thực sự chạy bên trong. Failproof AI hỗ trợ mười hai harness, được chia thành hai loại: + +- **Coding CLIs** (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose +- **Chat và assistant gateways** (2) — Hermes (Slack, Telegram, cron), OpenClaw (assistant tự lưu trữ) + +Các chính sách và lịch sử phiên làm việc tương tự áp dụng cho bất kỳ harness nào mà agent chạy trong đó. Một lớp bộ chuyển đổi ánh xạ tên sự kiện gốc, tên công cụ và các trường đầu vào công cụ của mỗi harness thành 29 sự kiện chuẩn trước khi bất kỳ chính sách nào chạy. + +Một agent chạy trong **không có** harness nào trong mười hai harness này được định hình trực tiếp bằng [Python SDK](/vi/reference/python-sdk). Đây là một hợp đồng khác, và cần được nêu rõ ràng: SDK cung cấp theo dõi, phiên làm việc, đánh giá và kiểm tra — **nó không thực thi các chính sách của riêng nó.** Chặn một hành động không an toàn trước khi nó thực thi cần một hook thực thi tại ranh giới công cụ của runtime của bạn; [liên hệ với chúng tôi](mailto:support@befailproof.ai) và chúng tôi sẽ ánh xạ nó. -| Tích hợp | Phạm vi hook được hỗ trợ | +| Harness | Phạm vi hook được hỗ trợ | | --- | --- | | Claude Code | User, project, local | | Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi | User, project | | Factory Droid, Devin CLI, Antigravity CLI, Goose | User, project | | Hermes, OpenClaw | User | -Mỗi tích hợp chuẩn hóa tên sự kiện hook gốc, tên công cụ và các trường đầu vào công cụ trước khi chính sách chạy. Chính sách chỉ có thể hoạt động trên các sự kiện mà tích hợp công khai; hãy kiểm tra hành vi cuối lượt và hướng dẫn trên tích hợp và phiên bản chính xác mà bạn triển khai. +Mỗi tích hợp chuẩn hóa tên sự kiện hook gốc, tên công cụ và các trường đầu vào công cụ trước khi các chính sách chạy. Một chính sách chỉ có thể hoạt động trên các sự kiện mà harness tiếp xúc; kiểm tra hành vi end-of-turn và instruction trên harness và phiên bản chính xác mà bạn triển khai. ## Khả năng thực thi -"Block" có nghĩa là phán quyết trả về của bộ điều hợp hiện tại được tiêu thụ bởi tích hợp được đặt tên. Việc chặn sau công cụ có thể thay thế kết quả hiển thị cho mô hình nhưng không thể hoàn tác hiệu ứng phụ của công cụ đã xảy ra. +"Block" có nghĩa là kết quả trả về của bộ chuyển đổi hiện tại được sử dụng bởi harness được đặt tên. Chặn sau công cụ có thể thay thế kết quả hiển thị cho mô hình nhưng không thể hoàn tác các tác dụng phụ của công cụ đã xảy ra. -| Tích hợp | Sự kiện chặn được xác minh | Các cảnh báo chỉ quan sát hoặc không chặn | +| Harness | Sự kiện chặn được xác minh | Các lưu ý chỉ quan sát hoặc không chặn | | --- | --- | --- | -| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, và một số sự kiện tác vụ/cấu hình | `PostToolUse`, vòng đời phiên, thông báo và các sự kiện sau lỗi chỉ là quan sát. | -| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Việc chặn sau công cụ thay thế kết quả sau khi thực thi; sự kiện bắt đầu phiên và compact là quan sát trong bộ điều hợp hiện tại. | -| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Việc chặn sau công cụ thay thế kết quả sau khi thực thi; sự kiện phiên và thông báo là quan sát. | -| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` và sự kiện phiên là quan sát. | -| OpenCode | `PreToolUse` | Sự kiện sau công cụ và vòng đời là quan sát; xử lý dừng hiện tại là hướng dẫn cho lượt sau chứ không phải là cánh cổng được xác minh. | -| Pi | `PreToolUse`, `UserPromptSubmit` | Sự kiện sau công cụ và vòng đời là quan sát; hướng dẫn dừng áp dụng cho lượt sau. | -| Hermes | `PreToolUse` | Phán quyết sau công cụ, phiên và dừng subagent không phải là cánh cổng. | -| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Sự kiện sau công cụ, phiên, dừng subagent và nén là quan sát. | -| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Phán quyết sau công cụ và dừng subagent là quan sát. | -| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` có điều kiện | Hook quyền không chạy trong mọi chế độ quyền; sự kiện sau công cụ và phiên là quan sát. | -| Antigravity CLI | `PreToolUse`, `Stop` | Phán quyết nhắc nhở người dùng và sau công cụ là quan sát; hướng dẫn nhắc nhở vẫn có thể được tiêm. | -| Goose | `PreToolUse` | Sự kiện nhắc nhở người dùng, sau công cụ và phiên là quan sát. Hook dừng chặn gốc tồn tại ở thượng nguồn nhưng không được cài đặt bởi bộ điều hợp hiện tại. | - -Khả năng phụ thuộc vào phiên bản. Hãy kiểm tra lại sau khi nâng cấp CLI agent, đặc biệt khi chính sách dựa vào hành vi nhắc nhở, dừng, quyền hoặc sau công cụ thay vì cánh cổng trước công cụ phổ biến. - -## Cài đặt hook ghi lại và chính sách +| Claude Code | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact` và một số sự kiện task/config | `PostToolUse`, vòng đời phiên làm việc, thông báo và các sự kiện sau lỗi chỉ quan sát. | +| Codex | `PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse` | Chặn sau công cụ thay thế kết quả sau khi thực thi; các sự kiện session-start và compact chỉ quan sát trong bộ chuyển đổi hiện tại. | +| GitHub Copilot CLI | `PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse` | Chặn sau công cụ thay thế kết quả sau khi thực thi; các sự kiện session và notification chỉ quan sát. | +| Cursor | `PreToolUse`, `UserPromptSubmit`, `Stop` | `PostToolUse` và các sự kiện session chỉ quan sát. | +| OpenCode | `PreToolUse` | Các sự kiện post-tool và vòng đời chỉ quan sát; xử lý stop hiện tại là hướng dẫn cho một lượt sau chứ không phải là cổng được xác minh. | +| Pi | `PreToolUse`, `UserPromptSubmit` | Các sự kiện post-tool và vòng đời chỉ quan sát; hướng dẫn stop áp dụng cho một lượt sau. | +| Hermes | `PreToolUse` | Các kết luận post-tool, session và subagent-stop không phải là cổng. | +| OpenClaw | `PreToolUse`, `UserPromptSubmit`, `Stop` | Các sự kiện post-tool, session, subagent-stop và compaction chỉ quan sát. | +| Factory Droid | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact` | Các kết luận post-tool và subagent-stop chỉ quan sát. | +| Devin CLI | `PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` có điều kiện | Hook permission không chạy trong mọi chế độ permission; các sự kiện post-tool và session chỉ quan sát. | +| Antigravity CLI | `PreToolUse`, `Stop` | Các kết luận user-prompt và post-tool chỉ quan sát; prompt instructions vẫn có thể được tiêm. | +| Goose | `PreToolUse` | Các sự kiện user-prompt, post-tool và session chỉ quan sát. Một hook stop blocking gốc tồn tại phía trên nhưng không được cài đặt bởi bộ chuyển đổi hiện tại. | + +Khả năng phụ thuộc vào phiên bản. Kiểm tra lại sau khi nâng cấp một agent CLI, đặc biệt khi một chính sách dựa vào hành vi prompt, stop, permission hoặc post-tool thay vì cổng pre-tool phổ biến. + +## Cài đặt capture và policy hooks - 1. Mở **Administration → Keys** và tạo khóa với `events:add` và `policies:pull`, đặt tên cho máy hoặc môi trường. - 2. Trên máy đích, kết nối CLI cục bộ với khóa được hiển thị và cài đặt hook tích hợp. - 3. Bắt đầu phiên agent mới, sau đó xác nhận sự kiện hook và phiên của nó trong **Observe → Events**. - 4. Mở **Observe → policy** cho cùng khoảng thời gian và xác nhận quyết định chính sách được gán cho máy. + 1. Mở **Administration → Keys** và tạo một key với `events:add` và `policies:pull`, được đặt tên cho máy hoặc môi trường. + 2. Trên máy đích, kết nối CLI cục bộ với key được hiển thị và cài đặt hooks harness. + 3. Bắt đầu một phiên agent mới, sau đó xác nhận các sự kiện hook và phiên làm việc của nó dưới **Observe → Events**. + 4. Mở **Observe → policy** cho cùng khoảng thời gian và xác nhận một quyết định chính sách được gán cho máy. - Kết nối bắt đầu bằng khóa máy. Xác nhận rằng nó bao gồm cả quyền nhập vào và phân phối chính sách trước khi sao chép bí mật của nó. + Kết nối bắt đầu với một machine key. Xác nhận rằng nó bao gồm cả quyền ingestion và policy-delivery trước khi sao chép secret của nó. - ![Ngăn tạo khóa API mới được sử dụng để cấp quyền nhập sự kiện và phân phối chính sách.](/images/dashboard/key-create.png) + ![Ngăn kéo API key mới được sử dụng để cấp quyền event ingestion và policy delivery.](/images/dashboard/key-create.png) - Sau khi cài đặt hook, luồng Events sẽ hiển thị các sự kiện mới từ máy và môi trường mà bạn đã kết nối. + Sau khi cài đặt hooks, luồng Events sẽ hiển thị các sự kiện mới từ máy và môi trường bạn kết nối. - ![Luồng Events trực tiếp được sử dụng để xác nhận tích hợp mới được cài đặt đang báo cáo.](/images/dashboard/events-stream.png) + ![Luồng Events trực tiếp được sử dụng để xác nhận một harness mới được cài đặt đang báo cáo.](/images/dashboard/events-stream.png) - Cuối cùng, xác minh rằng quyết định chính sách được gán cho cùng một máy. Điều này xác nhận tích hợp đang báo cáo hoạt động chính sách cũng như sự kiện trace. + Cuối cùng, xác minh rằng các quyết định chính sách được gán cho cùng một máy. Điều này xác nhận rằng harness đang báo cáo cả hoạt động chính sách và các sự kiện trace. - ![Trang Policy được sử dụng để xác minh quyết định chính sách từ tích hợp mới kết nối.](/images/dashboard/policy-observe.png) + ![Trang Policy được sử dụng để xác minh các quyết định chính sách từ một harness mới được kết nối.](/images/dashboard/policy-observe.png) - Cài đặt hook cho mỗi tích hợp được phát hiện: + Cài đặt hooks cho mọi harness được phát hiện: ```bash failproofai config \ @@ -67,7 +75,7 @@ Khả năng phụ thuộc vào phiên bản. Hãy kiểm tra lại sau khi nâng failproofai policies --install ``` - Hoặc nhắm mục tiêu các tích hợp được đặt tên và phạm vi cấu hình: + Hoặc nhắm mục tiêu các harness được đặt tên và phạm vi cấu hình: ```bash failproofai policies --install \ @@ -75,9 +83,9 @@ Khả năng phụ thuộc vào phiên bản. Hãy kiểm tra lại sau khi nâng --scope user ``` - Phạm vi project giữ cấu hình hook với một kho lưu trữ. Phạm vi user bao gồm công việc trên nhiều kho lưu trữ. Claude Code cũng hỗ trợ phạm vi local; hỗ trợ khác nhau tùy theo tích hợp và CLI từ chối các kết hợp không được hỗ trợ. + Phạm vi project giữ cấu hình hook với một repository. Phạm vi user bao quát công việc trong các repository. Claude Code cũng hỗ trợ phạm vi local; hỗ trợ thay đổi theo harness và CLI từ chối các kết hợp không được hỗ trợ. - Xác minh máy và sự kiện của nó: + Xác minh máy và các sự kiện của nó: ```bash failproofai config --status @@ -87,16 +95,16 @@ Khả năng phụ thuộc vào phiên bản. Hãy kiểm tra lại sau khi nâng -## Thêm đường dẫn phiên không mặc định +## Thêm một đường dẫn phiên làm việc không mặc định - Các đường dẫn bổ sung được đăng ký trên máy, không phải trên Cloud. Sau khi thêm một đường dẫn, mở **Observe → Sessions**, lọc theo môi trường của máy và xác nhận các phiên từ đường dẫn mới xuất hiện. Mở một phiên và kiểm tra agent, tích hợp và dấu thời gian sự kiện trước khi dựa vào nó trong một cuộc kiểm toán. + Các đường dẫn bổ sung được đăng ký trên máy, không phải trong Cloud. Sau khi thêm một đường dẫn, mở **Observe → Sessions**, lọc theo môi trường của máy và xác nhận các phiên từ đường dẫn mới xuất hiện. Mở một phiên và kiểm tra agent, harness và dấu thời gian sự kiện trước khi dựa vào nó trong một kiểm tra. - ![Danh sách Sessions được lọc theo môi trường nhận dữ liệu từ đường dẫn ghi lại bổ sung.](/images/dashboard/sessions-list.png) + ![Danh sách Sessions được lọc theo môi trường nhận dữ liệu từ đường dẫn capture bổ sung.](/images/dashboard/sessions-list.png) - Thêm đường dẫn với nhãn tùy chọn, sau đó kiểm tra các đường dẫn được cấu hình: + Thêm một đường dẫn với một nhãn tùy chọn, sau đó kiểm tra các đường dẫn được cấu hình: ```bash failproofai harness add-path claude checkout=/srv/checkout/.claude @@ -105,10 +113,10 @@ Khả năng phụ thuộc vào phiên bản. Hãy kiểm tra lại sau khi nâng failproofai backfill --since 7d ``` - Xóa đường dẫn bằng `failproofai harness remove-path claude checkout`. + Xóa một đường dẫn với `failproofai harness remove-path claude checkout`. - Chạy một phiên mới sau khi cài đặt. Xác minh cả luồng sự kiện trực tiếp và quyết định chính sách thực tế trước khi mở rộng triển khai. + Chạy một phiên mới sau khi cài đặt. Xác minh cả luồng sự kiện trực tiếp và một quyết định chính sách thực tế trước khi mở rộng triển khai. \ No newline at end of file diff --git a/docs/vi/sessions/live-events.mdx b/docs/vi/sessions/live-events.mdx index 218eea2a8..0e2a69f27 100644 --- a/docs/vi/sessions/live-events.mdx +++ b/docs/vi/sessions/live-events.mdx @@ -1,21 +1,22 @@ --- +--- title: "Sự kiện trực tiếp" description: "Theo dõi hoạt động của agent khi một phiên đang chạy." icon: "radio" --- -Sự kiện trực tiếp giúp bạn xác nhận khả năng đo lường và theo dõi một lần chạy có rủi ro mà không cần chờ phiên kết thúc. +Sự kiện trực tiếp giúp bạn xác nhận cơ chế đo lường và theo dõi một lần chạy có rủi ro mà không cần chờ phiên kết thúc. ## Theo dõi hoạt động - 1. Đi đến **Observe → Events**. - 2. Bắt đầu với cửa sổ thời gian hiện tại và không có bộ lọc để xác nhận dữ liệu đang đến. - 3. Lọc theo môi trường, loại sự kiện, agent hoặc phiên. Sử dụng tìm kiếm cho văn bản payload. - 4. Chọn một sự kiện để kiểm tra bản tóm tắt và chi tiết của nó. Theo dõi liên kết phiên để xem dấu vết đầy đủ. + 1. Đi tới **Observe → Events**. + 2. Bắt đầu với cửa sổ thời gian hiện tại và không có bộ lọc để xác nhận dữ liệu đang được nhận. + 3. Lọc theo môi trường, loại sự kiện, agent hoặc phiên. Sử dụng tìm kiếm để tìm văn bản trong tải trọng dữ liệu. + 4. Chọn một sự kiện để kiểm tra tóm tắt và chi tiết của nó. Theo liên kết phiên của nó để xem dấu vết đầy đủ. - ![Luồng Events trực tiếp với các bộ lọc thời gian, môi trường, loại sự kiện, agent, mô hình, ngữ cảnh, phiên và văn bản.](/images/dashboard/events-stream-current.png) + ![Dòng sự kiện trực tiếp hiển thị lưu lượng từ cổng trò chuyện Hermes cùng với các lần chạy coding-CLI, được lọc theo thời gian, môi trường, loại sự kiện, agent, mô hình, bối cảnh và phiên.](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +25,22 @@ Sự kiện trực tiếp giúp bạn xác nhận khả năng đo lường và t fp --json events --full --session-id --all ``` - Luồng mặc định bỏ qua các payload thô. Chỉ sử dụng `--full` cho việc điều tra phiên bị ràng buộc. + Luồng mặc định bỏ qua các tải trọng dữ liệu thô. Chỉ sử dụng `--full` cho việc điều tra phiên giới hạn. -Sử dụng luồng sự kiện để trả lời ba câu hỏi ngay lập tức: +Sử dụng dòng sự kiện để trả lời ba câu hỏi cấp bách: -- Agent mong đợi có báo cáo đến môi trường chính xác không? -- Các lệnh gọi mô hình, lệnh gọi công cụ và quyết định chính sách có đến theo thứ tự không? -- Phiên có ngừng tiến hành hay bắt đầu lặp lại một hành động không? +- Agent mong đợi có đang báo cáo tới môi trường chính xác không? +- Các lệnh gọi mô hình, lệnh gọi công cụ và quyết định chính sách có đến đúng thứ tự không? +- Phiên đã dừng tiến triển hay bắt đầu lặp lại một hành động? -Các loại sự kiện bao gồm sự kiện vòng đời agent, yêu cầu và phản hồi mô hình, sử dụng công cụ và kết quả, thực thi hook, chờ đợi con người và gián đoạn, và các lỗi rõ ràng. ID tương quan nối các sự kiện được ghép như một lệnh gọi công cụ và kết quả của nó. +Các loại sự kiện bao gồm sự kiện vòng đời agent, yêu cầu và phản hồi của mô hình, sử dụng công cụ và kết quả, thực thi hook, chờ đợi con người và ngắt, cũng như lỗi rõ ràng. ID tương quan kết hợp các sự kiện được ghép nối như một lệnh gọi công cụ và kết quả của nó. - Giữ chế độ xem trực tiếp rộng trong khi xác minh một tích hợp mới. Chỉ thêm bộ lọc sau khi bạn thấy sự kiện đầu tiên; một bộ lọc không chính xác có thể trông giống như việc nhập dữ liệu không thành công. + Giữ chế độ xem trực tiếp rộng trong khi xác minh một tích hợp mới. Chỉ thêm bộ lọc sau khi bạn thấy sự kiện đầu tiên; một bộ lọc không chính xác có thể trông giống như việc nhập không thành công. -Nếu không có sự kiện nào xuất hiện, hãy chạy `failproofai config --status`, sau đó [khắc phục sự cố nhập dữ liệu](/vi/reference/troubleshooting). \ No newline at end of file +Nếu không có sự kiện nào xuất hiện, chạy `failproofai config --status`, sau đó [khắc phục sự cố nhập liệu](/vi/reference/troubleshooting). + +Các agent không chạy trong một trong 12 [harnesses](/vi/reference/harnesses) được hỗ trợ sẽ báo cáo các loại sự kiện giống nhau thông qua [Python SDK](/vi/reference/python-sdk), bao gồm các sự kiện human-in-the-loop (`human_wait`, `human_input`, `human_interrupt`) mà các agent cổng và sản xuất phụ thuộc vào. \ No newline at end of file diff --git a/docs/vi/sessions/overview.mdx b/docs/vi/sessions/overview.mdx index d55a2b340..d43936bda 100644 --- a/docs/vi/sessions/overview.mdx +++ b/docs/vi/sessions/overview.mdx @@ -4,22 +4,24 @@ description: "Bắt đầu với bản ghi hoàn chỉnh của một lần chạ icon: "workflow" --- -Session là điểm khởi đầu tốt nhất khi một agent hoạt động không như mong đợi. Nó ghi lại các yêu cầu mô hình, phản hồi, lệnh gọi công cụ, tương tác con người, lỗi, đánh giá và quyết định chính sách thuộc về một lần chạy. +Một session là điểm khởi đầu tốt nhất khi một agent hoạt động không như mong đợi. Nó kết hợp các yêu cầu mô hình, phản hồi, lệnh gọi tool, tương tác con người, lỗi, đánh giá và quyết định chính sách thuộc về một lần chạy. + +Sessions trông giống nhau bất kể harness nào tạo ra chúng. Một lần chạy Claude Code viết lại một repository, một agent Hermes trả lời khách hàng trong Slack, và một dịch vụ Python được hỗ trợ bởi SDK đều được ghi vào cùng một định dạng trace, vì vậy một view bao phủ toàn bộ fleet.
-Theo dõi một lần chạy agent từ mục tiêu của nó qua các lệnh gọi mô hình, công cụ, và phản hồi cuối cùng. +Theo dõi một lần chạy agent từ mục tiêu của nó qua các lệnh gọi mô hình, tools, và phản hồi cuối cùng. ## Tìm một session - 1. Trong thanh bên Cloud, đi tới **Observe → Sessions**. - 2. Đặt cửa sổ thời gian, sau đó lọc theo môi trường, trạng thái, agent, hoặc ID session. - 3. Thêm phạm vi điểm số hoặc chỉ số khi bạn cần cắt lát chất lượng, chi phí, token, hoặc độ trễ. - 4. Chọn một hàng để mở trace của nó. Sử dụng công cụ sao chép bên cạnh ID session khi chia sẻ nó. + 1. Trong thanh bên Cloud, đi đến **Observe → Sessions**. + 2. Đặt cửa sổ thời gian, sau đó lọc theo môi trường, trạng thái, agent hoặc ID session. + 3. Thêm các khoảng điểm số hoặc metric khi bạn cần một slice về chất lượng, chi phí, token hoặc latency. + 4. Chọn một hàng để mở trace của nó. Sử dụng control copy bên cạnh ID session khi chia sẻ nó. ![Danh sách Sessions hiển thị một hàng cho mỗi lần chạy với các bộ lọc môi trường, agent, trạng thái và điểm đánh giá.](/images/dashboard/sessions-list.png) @@ -30,26 +32,26 @@ Theo dõi một lần chạy agent từ mục tiêu của nó qua các lệnh g fp --json sessions --session-id ``` - Thêm `--agents` để mở rộng các lần chạy multi-agent, `--all` để phân trang, hoặc `--fields` để chọn cột đầu ra. + Thêm `--agents` để mở rộng các lần chạy multi-agent, `--all` để phân trang, hoặc `--fields` để chọn các cột output. ## Những gì bạn có thể làm -- Tìm một lần chạy theo agent, môi trường, thời gian, mô hình, loại sự kiện, hoặc trạng thái lỗi. -- Theo dõi chuỗi chính xác đã tạo ra một kết quả. +- Tìm một lần chạy theo agent, môi trường, thời gian, mô hình, loại sự kiện hoặc trạng thái lỗi. +- Theo dõi chuỗi chính xác tạo ra một kết quả. - So sánh các lần chạy thành công và thất bại. -- Mở bằng chứng được sử dụng bởi một phát hiện kiểm toán hoặc sự cố cảnh báo. +- Mở bằng chứng được sử dụng bởi một phát hiện kiểm tra hoặc sự cố cảnh báo. - Xuất một session khi bạn cần một bản ghi ngoại tuyến. ## Một thứ tự điều tra đáng tin cậy -1. Xác nhận mục tiêu và môi trường của session. -2. Tìm lỗi đầu tiên hoặc quyết định bất ngờ—không chỉ là lỗi cuối cùng. -3. Kiểm tra ngữ cảnh mô hình và đầu vào công cụ ngay trước nó. -4. Kiểm tra các lần thử lại, độ trễ, và ngắt quãng của con người. -5. Xem lại điểm đánh giá và quyết định chính sách. +1. Xác nhận mục tiêu session và môi trường. +2. Tìm lỗi đầu tiên hoặc quyết định không mong đợi—không chỉ là lỗi cuối cùng. +3. Kiểm tra ngữ cảnh mô hình và input tool ngay trước nó. +4. Kiểm tra các lần thử lại, latency và can thiệp con người. +5. Xem xét các điểm đánh giá và quyết định chính sách. - Tìm hiểu cách chuyển từ tóm tắt session đến sự kiện đã gây ra kết quả. + Tìm hiểu cách chuyển từ tóm tắt session đến sự kiện tạo ra kết quả. \ No newline at end of file diff --git a/docs/vi/start/quickstart.mdx b/docs/vi/start/quickstart.mdx index 309c7d6cd..a4b11518a 100644 --- a/docs/vi/start/quickstart.mdx +++ b/docs/vi/start/quickstart.mdx @@ -1,15 +1,17 @@ --- title: "Bắt đầu nhanh" -description: "Capture một phiên làm việc của agent, tìm kiếm lỗi, và bắt đầu ngăn chặn nó." +description: "Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó." icon: "zap" --- -Hướng dẫn bắt đầu nhanh này sẽ giúp bạn đưa một máy tính vào báo cáo phiên làm việc, chạy kiểm toán, và triển khai một chính sách. Sử dụng kỹ năng để thiết lập Failproof AI, hoặc thực hiện các bước thủ công. Bạn cần Node.js 20.9 hoặc mới hơn. +Hướng dẫn bắt đầu nhanh này giúp một máy báo cáo phiên làm việc, chạy kiểm toán, và triển khai chính sách. Sử dụng skill để thiết lập Failproof AI, hoặc làm theo các bước thủ công. + +**Đường dẫn nào là của bạn?** Nếu agent của bạn chạy trong một trong 12 [harnesses](/vi/reference/harnesses) được hỗ trợ — một CLI mã hóa, hoặc một gateway như Hermes hay OpenClaw — hãy làm theo các bước dưới đây; bạn cần Node.js 20.9 hoặc mới hơn. Nếu agent của bạn không có harness, hãy sử dụng [Python SDK](/vi/reference/python-sdk) để tracing và kiểm toán, sau đó quay lại [Chạy kiểm tra lỗi đầu tiên của bạn](/vi/start/first-audit); việc áp dụng trên đường dẫn đó cần một hook trong runtime của bạn. - + - + ```bash npx skills add FailproofAI/skills ``` @@ -19,7 +21,7 @@ Hướng dẫn bắt đầu nhanh này sẽ giúp bạn đưa một máy tính v Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - Agent của bạn sẽ kiểm tra dự án, chọn tích hợp phù hợp, thực hiện thiết lập, và xác minh nó. Xem [kho lưu trữ kỹ năng FailproofAI](https://github.com/FailproofAI/skills) để biết các kỹ năng riêng lẻ và các tùy chọn cài đặt nâng cao. + Agent của bạn kiểm tra dự án, chọn tích hợp phù hợp, thực hiện thiết lập, và xác minh nó. Xem [kho FailproofAI skills](https://github.com/FailproofAI/skills) để xem các skill riêng lẻ và các tùy chọn cài đặt nâng cao. @@ -27,8 +29,8 @@ Hướng dẫn bắt đầu nhanh này sẽ giúp bạn đưa một máy tính v ## Trước khi bắt đầu 1. Mở [bảng điều khiển Failproof AI](https://app.befailproof.ai) và tạo tài khoản hoặc đăng nhập bằng email công việc của bạn. -2. Đi đến **Administration → Keys** và tạo một khóa với `events:add` và `policies:pull`. -3. Sao chép bí mật một lần và lưu trữ nó trên máy tính mục tiêu: +2. Đi tới **Administration → Keys** và tạo một khóa với `events:add` và `policies:pull`. +3. Sao chép mã bí mật một lần và lưu trữ nó trên máy đích: ```bash export FAILPROOFAI_KEY="" @@ -45,7 +47,7 @@ export FAILPROOFAI_KEY="" Các bản ghi phiên làm việc được gửi theo mặc định. Thêm `--no-transcripts` để báo cáo hoạt động hook và các quyết định chính sách mà không có nội dung bản ghi. - Nếu máy tính này đã có lịch sử agent, xem trước và nhập bảy ngày cuối cùng, sau đó chờ quá trình gửi hoàn tất. Bỏ qua bước này trên một máy tính mới. + Nếu máy này đã có lịch sử agent, hãy xem trước và nhập bảy ngày qua, sau đó chờ quá trình gửi hoàn tất. Bỏ qua bước này trên máy mới. ```bash failproofai backfill --since 7d --dry-run @@ -53,27 +55,30 @@ export FAILPROOFAI_KEY="" failproofai flush --wait ``` - Mở **Sessions** trong Failproof AI và chọn một phiên làm việc được nhập. + Mở **Sessions** trong Failproof AI và chọn một phiên làm việc đã nhập. - - Điều này sẽ gắn Failproof AI vào CLI agent của bạn và cài đặt các chính sách được tích hợp sẵn. Sử dụng chúng để xem các quyết định chính sách cục bộ và thử thực thi trước khi Failproof AI kiểm toán phiên làm việc của bạn và viết chính sách cho các agent của bạn. + + Cách này gắn Failproof AI vào harness của bạn và cài đặt 40 chính sách tích hợp. Sử dụng chúng để xem các quyết định chính sách cục bộ và thử áp dụng trước khi Failproof AI kiểm toán các phiên làm việc của bạn và viết chính sách cho agent của bạn. - Để trình cài đặt phát hiện CLI agent của bạn, hoặc chỉ định một CLI một cách rõ ràng. + Cho phép trình cài đặt phát hiện harness của bạn, hoặc chỉ định rõ ràng một. Mỗi một trong 12 cái là một giá trị `--cli` hợp lệ — `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity`, `goose`. ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # a coding CLI + failproofai policies --install --cli hermes --scope user # a Slack/Telegram gateway ``` + + Chặn một lệnh gọi công cụ trước khi nó chạy được xác minh trên tất cả 12. Các cổng ở cuối lượt được xác minh trên 8 — xem [khả năng áp dụng](/vi/reference/harnesses#enforcement-capability) để xem ma trận theo harness. - Làm theo [Chạy kiểm tra lỗi đầu tiên của bạn](/vi/start/first-audit). Sử dụng một mục tiêu cụ thể chẳng hạn như "tìm các phiên làm việc nơi agent thử lại một công cụ không thành công mà không thay đổi cách tiếp cận của nó." + Làm theo [Chạy kiểm tra lỗi đầu tiên của bạn](/vi/start/first-audit). Sử dụng một mục tiêu cụ thể chẳng hạn như "tìm các phiên làm việc nơi agent thử lại một công cụ đang thất bại mà không thay đổi cách tiếp cận của nó." - Làm theo [Ngăn chặn lỗi đầu tiên của bạn bằng một chính sách](/vi/start/first-policy). Bắt đầu ở chế độ quan sát, kiểm tra các kết quả khớp, sau đó thực thi phiên bản đã được xem xét. + Làm theo [Ngăn chặn lỗi đầu tiên của bạn bằng chính sách](/vi/start/first-policy). Bắt đầu ở chế độ quan sát, kiểm tra các kết quả trùng khớp, sau đó áp dụng phiên bản đã được xem xét. - Chạy `failproofai config --status`. Một thiết lập lành mạnh sẽ báo cáo kết nối đám mây, trạng thái daemon, và liệu thực thi có bị tạm dừng hay không. + Chạy `failproofai config --status`. Một thiết lập lành mạnh sẽ báo cáo kết nối đám mây, trạng thái daemon, và liệu áp dụng có bị tạm dừng hay không. \ No newline at end of file diff --git a/docs/zh/index.mdx b/docs/zh/index.mdx index 6167c788e..ce8675420 100644 --- a/docs/zh/index.mdx +++ b/docs/zh/index.mdx @@ -1,39 +1,41 @@ --- title: "让你的 agent 万无一失" -description: "Failproof AI 追踪 agent 行为、审计会话中的故障，并部署策略以阻止同类事件重复发生。" +description: "为 agent 运行的每种 harness 提供可观测性与执行保障——包括编码 CLI、聊天网关、自托管助手，以及你自己的插桩 agent。" icon: "shield-check" --- -Failproof AI 帮助团队了解 agent 的行为、找出故障发生的位置，并在相同行为再次出现之前部署防护措施。 +Failproof AI 帮助团队了解 agent 的行为、找出失败原因，并在同样的问题再次发生前部署防护措施。 + +**harness** 是 agent 实际运行的环境。Failproof AI 支持接入其中 12 种——包括 Claude Code 和 Codex 等编码 CLI、Hermes 等聊天网关、OpenClaw 等自托管助手——所有事件、策略和会话历史对每种环境一视同仁。没有 harness 的 agent 可通过 [Python SDK](/zh/reference/python-sdk) 上报，该 SDK 提供追踪与审计能力；在自有运行时中执行策略则需要在你的代码中添加 hook。 - 使用该技能对你的项目进行插桩、完成连接，并验证 agent 日志是否正常送达。 + 使用技能对你的项目进行插桩、连接并验证 agent 日志是否正常上报。 - - 用自然语言分析、查询 agent 日志，构建仪表板并运行审计。 + + 用自然语言分析、查询 agent 日志，构建仪表盘并执行审计。 - - 在单个会话中追踪模型调用、工具使用、错误、人工输入、延迟及策略决策。 + + 在单个会话中追踪模型调用、工具使用、错误、人工输入、延迟和策略决策。 - - 对指定的会话集合进行审计，审阅有证据支撑的发现，并将问题作为 issue 进行跟踪。 + + 对指定会话集合进行审计，查看有依据支撑的发现，并以 issue 的形式跟踪修复进度。 - - 将已知的故障模式转化为策略，观察其影响，并将其部署到整个服务集群。 + + 将已知的失败模式转化为策略，观察其影响，并在整个 fleet 中部署。 > **会话 → 审计 → 发现 → Issue → 策略**
-> 追踪发生了什么、找出故障、管理响应，然后防止相同行为在后续运行中再次出现。 +> 追踪发生了什么，找出故障，管理响应，然后防止同样的行为在未来的运行中重现。 ## 从这里开始 -如果你正在部署第一个经过插桩的 agent，请从[快速入门](/zh/start/quickstart)开始。如果数据已经在接收，请打开[会话](/zh/sessions/overview)，先检查一次真实运行记录，再配置审计或策略。 +如果你正在部署第一个插桩 agent，请从 [快速入门](/zh/start/quickstart) 开始。如果数据已经在上报，请打开 [Sessions](/zh/sessions/overview)，先检查一次真实运行，再配置审计或策略。 - - 完成从捕获到安全部署策略的端到端工作流。 + + 完成从数据采集到安全部署策略的端到端工作流。 \ No newline at end of file diff --git a/docs/zh/reference/harnesses.mdx b/docs/zh/reference/harnesses.mdx index 86cec1c6c..a10ee7f8c 100644 --- a/docs/zh/reference/harnesses.mdx +++ b/docs/zh/reference/harnesses.mdx @@ -1,64 +1,71 @@ --- title: "Agent harnesses" -description: "在支持的 Agent CLI 中捕获会话并执行策略。" +description: "捕获会话并在所有 12 个支持的 agent harness 中强制执行策略。" icon: "plug-zap" --- -Failproof AI 支持 Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi、Hermes、OpenClaw、Factory Droid、Devin CLI、Antigravity CLI 以及 Goose。 +harness 是你的 agent 实际运行的环境。Failproof AI 支持十二种，分为两类： -| Harness | 支持的 hook 范围 | +- **编程 CLI**（10 种）—— Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi、Factory Droid、Devin CLI、Antigravity CLI、Goose +- **聊天与助手网关**（2 种）—— Hermes（Slack、Telegram、cron）、OpenClaw（自托管助手） + +无论 agent 运行在哪种 harness 中，适用的策略和会话历史都是相同的。一个适配器层会将各 harness 的原生事件名称、工具名称和工具输入字段映射到 29 个规范事件，然后再执行任何策略。 + +如果 agent **不属于**上述十二种之一，则可直接使用 [Python SDK](/zh/reference/python-sdk) 进行插桩。这是一种不同的契约，有必要明确说明：SDK 提供追踪、会话、评估和审计功能 —— **它本身不强制执行策略。** 若要在不安全操作执行前将其阻断，需要在运行时的工具边界处设置执行钩子；请[联系我们](mailto:support@befailproof.ai)，我们将为你完成映射。 + +| Harness | 支持的钩子范围 | | --- | --- | | Claude Code | User、project、local | | Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi | User、project | | Factory Droid、Devin CLI、Antigravity CLI、Goose | User、project | | Hermes、OpenClaw | User | -每个集成在策略执行前，会将其原生 hook 事件名称、工具名称及工具输入字段进行规范化处理。策略只能对 harness 所暴露的事件产生作用；请在实际部署所用的 harness 和版本上测试轮次结束及指令行为。 +每个集成在策略运行之前会对其原生钩子事件名称、工具名称和工具输入字段进行规范化处理。策略只能对 harness 暴露的事件生效；请在你实际部署的 harness 版本上测试回合结束和指令行为。 ## 执行能力 -"阻断"指当前适配器返回的裁决结果会被指定 harness 所采用。工具后置阻断可能会替换呈现给模型的结果，但无法撤销已经发生的工具副作用。 +"阻断"是指当前适配器返回的裁决被指定 harness 所消费。后置工具阻断可能会替换模型看到的结果，但无法撤销已发生的工具副作用。 -| Harness | 已验证的阻断事件 | 仅观察或非阻断说明 | +| Harness | 已验证的阻断事件 | 仅观测或非阻断说明 | | --- | --- | --- | -| Claude Code | `PreToolUse`、`UserPromptSubmit`、`PermissionRequest`、`Stop`、`SubagentStop`、`PreCompact` 及若干任务/配置事件 | `PostToolUse`、会话生命周期、通知及后续失败事件仅供观察。 | -| Codex | `PreToolUse`、`PermissionRequest`、`UserPromptSubmit`、`Stop`、`SubagentStop`、`PostToolUse` | 工具后置阻断在执行后替换结果；会话启动和压缩事件在当前适配器中仅供观察。 | -| GitHub Copilot CLI | `PreToolUse`、`UserPromptSubmit`、`PermissionRequest`、`Stop`、`SubagentStop`、`PostToolUse` | 工具后置阻断在执行后替换结果；会话和通知事件仅供观察。 | -| Cursor | `PreToolUse`、`UserPromptSubmit`、`Stop` | `PostToolUse` 及会话事件仅供观察。 | -| OpenCode | `PreToolUse` | 工具后置和生命周期事件仅供观察；当前的停止处理是对后续轮次的指导，而非已验证的门控。 | -| Pi | `PreToolUse`、`UserPromptSubmit` | 工具后置和生命周期事件仅供观察；停止指导适用于后续轮次。 | -| Hermes | `PreToolUse` | 工具后置、会话和子代理停止裁决不作为门控。 | -| OpenClaw | `PreToolUse`、`UserPromptSubmit`、`Stop` | 工具后置、会话、子代理停止及压缩事件仅供观察。 | -| Factory Droid | `PreToolUse`、`UserPromptSubmit`、`Stop`、`PreCompact` | 工具后置和子代理停止裁决仅供观察。 | -| Devin CLI | `PreToolUse`、`UserPromptSubmit`、`Stop`、有条件的 `PermissionRequest` | 并非所有权限模式下都会触发权限 hook；工具后置和会话事件仅供观察。 | -| Antigravity CLI | `PreToolUse`、`Stop` | 用户提示和工具后置裁决仅供观察；提示指令仍可注入。 | -| Goose | `PreToolUse` | 用户提示、工具后置和会话事件仅供观察。上游存在原生的阻断停止 hook，但当前适配器未安装。 | - -各项能力对版本敏感。升级 Agent CLI 后请重新测试，尤其是当策略依赖提示、停止、权限或工具后置行为而非通用的工具前置门控时。 - -## 安装捕获与策略 hook +| Claude Code | `PreToolUse`、`UserPromptSubmit`、`PermissionRequest`、`Stop`、`SubagentStop`、`PreCompact` 及若干任务/配置事件 | `PostToolUse`、会话生命周期、通知和失败后事件仅供观测。 | +| Codex | `PreToolUse`、`PermissionRequest`、`UserPromptSubmit`、`Stop`、`SubagentStop`、`PostToolUse` | 后置工具阻断在执行后替换结果；当前适配器中会话启动和压缩事件仅供观测。 | +| GitHub Copilot CLI | `PreToolUse`、`UserPromptSubmit`、`PermissionRequest`、`Stop`、`SubagentStop`、`PostToolUse` | 后置工具阻断在执行后替换结果；会话和通知事件仅供观测。 | +| Cursor | `PreToolUse`、`UserPromptSubmit`、`Stop` | `PostToolUse` 和会话事件仅供观测。 | +| OpenCode | `PreToolUse` | 后置工具和生命周期事件仅供观测；当前的停止处理是对后续回合的指导，而非已验证的门控。 | +| Pi | `PreToolUse`、`UserPromptSubmit` | 后置工具和生命周期事件仅供观测；停止指导适用于后续回合。 | +| Hermes | `PreToolUse` | 后置工具、会话和子 agent 停止裁决不作为门控。 | +| OpenClaw | `PreToolUse`、`UserPromptSubmit`、`Stop` | 后置工具、会话、子 agent 停止和压缩事件仅供观测。 | +| Factory Droid | `PreToolUse`、`UserPromptSubmit`、`Stop`、`PreCompact` | 后置工具和子 agent 停止裁决仅供观测。 | +| Devin CLI | `PreToolUse`、`UserPromptSubmit`、`Stop`、条件性 `PermissionRequest` | 权限钩子并非在所有权限模式下都会运行；后置工具和会话事件仅供观测。 | +| Antigravity CLI | `PreToolUse`、`Stop` | 用户提示和后置工具裁决仅供观测；提示指令仍可注入。 | +| Goose | `PreToolUse` | 用户提示、后置工具和会话事件仅供观测。上游存在原生阻断停止钩子，但当前适配器未安装。 | + +能力与版本相关。升级 agent CLI 后请重新测试，尤其是当策略依赖提示、停止、权限或后置工具行为而非通用的前置工具门控时。 + +## 安装捕获和策略钩子 - + 1. 打开 **Administration → Keys**，创建一个具有 `events:add` 和 `policies:pull` 权限的密钥，并以机器或环境命名。 - 2. 在目标机器上，使用显示的密钥连接本地 CLI 并安装 harness hook。 - 3. 启动一个新的 Agent 会话，然后在 **Observe → Events** 下确认其 hook 和会话事件。 - 4. 打开同一时间窗口下的 **Observe → policy**，确认策略决策已归属到该机器。 + 2. 在目标机器上，使用显示的密钥连接本地 CLI 并安装 harness 钩子。 + 3. 启动一个新的 agent 会话，然后在 **Observe → Events** 下确认其钩子和会话事件。 + 4. 打开同一时间窗口的 **Observe → policy**，确认策略决策已归因到该机器。 - 连接从机器密钥开始。在复制其密钥前，请确认它同时包含摄取和策略下发权限。 + 连接从机器密钥开始。在复制其密钥前，请确认其包含摄取和策略分发权限。 - ![用于授予事件摄取和策略下发权限的新 API 密钥抽屉。](/images/dashboard/key-create.png) + ![用于授予事件摄取和策略分发权限的新 API 密钥抽屉。](/images/dashboard/key-create.png) - 安装 hook 后，事件流应显示来自所连接机器和环境的新事件。 + 安装钩子后，Events 流应显示来自已连接机器和环境的新事件。 - ![用于确认新安装 harness 正在上报的实时事件流。](/images/dashboard/events-stream.png) + ![用于确认新安装的 harness 正在上报数据的实时 Events 流。](/images/dashboard/events-stream.png) - 最后，验证策略决策已归属到同一台机器。这可以确认 harness 正在上报策略活动以及追踪事件。 + 最后，验证策略决策已归因到同一台机器。这确认 harness 正在上报策略活动以及追踪事件。 - ![用于验证新连接 harness 策略决策的 Policy 页面。](/images/dashboard/policy-observe.png) + ![用于验证新连接的 harness 策略决策的 Policy 页面。](/images/dashboard/policy-observe.png) - 为所有检测到的 harness 安装 hook： + 为所有检测到的 harness 安装钩子： ```bash failproofai config \ @@ -67,7 +74,7 @@ Failproof AI 支持 Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode failproofai policies --install ``` - 或者指定 harness 名称和配置范围： + 或指定 harness 名称和配置范围： ```bash failproofai policies --install \ @@ -75,7 +82,7 @@ Failproof AI 支持 Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode --scope user ``` - project 范围将 hook 配置保存在仓库中。user 范围覆盖跨仓库的工作。Claude Code 还支持 local 范围；支持情况因 harness 而异，CLI 会拒绝不支持的组合。 + project 范围将钩子配置保留在代码仓库中。user 范围覆盖跨仓库的工作。Claude Code 还支持 local 范围；支持情况因 harness 而异，CLI 会拒绝不支持的组合。 验证机器及其事件： @@ -90,10 +97,10 @@ Failproof AI 支持 Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode ## 添加非默认会话路径 - - 额外路径注册在机器本地，而非云端。添加后，打开 **Observe → Sessions**，按机器所属环境过滤，确认来自新路径的会话已出现。打开某个会话，在将其用于审计前，检查 Agent、harness 及事件时间戳。 + + 额外路径在机器上注册，而非在云端。添加路径后，打开 **Observe → Sessions**，按机器环境过滤，并确认来自新路径的会话出现。打开一个会话，在将其用于审计之前检查 agent、harness 和事件时间戳。 - ![过滤至接收额外捕获路径数据的环境的 Sessions 列表。](/images/dashboard/sessions-list.png) + ![过滤到接收额外捕获路径数据的环境的 Sessions 列表。](/images/dashboard/sessions-list.png) 添加带可选标签的路径，然后查看已配置的路径： @@ -105,10 +112,10 @@ Failproof AI 支持 Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode failproofai backfill --since 7d ``` - 使用 `failproofai harness remove-path claude checkout` 移除路径。 + 使用 `failproofai harness remove-path claude checkout` 删除路径。 - 安装后运行一次新会话。在扩大部署范围之前，请同时验证实时事件流和实际的策略决策。 + 安装后运行一个新会话。在扩大部署范围之前，同时验证实时事件流和实际的策略决策。 \ No newline at end of file diff --git a/docs/zh/sessions/live-events.mdx b/docs/zh/sessions/live-events.mdx index e9db65d11..0eacd52bb 100644 --- a/docs/zh/sessions/live-events.mdx +++ b/docs/zh/sessions/live-events.mdx @@ -1,21 +1,21 @@ --- title: "实时事件" -description: "在会话运行期间实时观察 agent 活动。" +description: "在会话运行时观察 agent 活动的实时推送。" icon: "radio" --- -实时事件帮助你确认埋点是否生效，并在不等待会话结束的情况下实时监控高风险运行。 +实时事件可帮助你确认埋点是否正常，并在不等待会话结束的情况下监控高风险的运行过程。 -## 观察活动 +## 监控活动 1. 前往 **Observe → Events**。 - 2. 以当前时间窗口且不设任何过滤器开始，确认数据正在到达。 - 3. 按环境、事件类型、agent 或会话进行过滤。使用搜索功能查找 payload 文本。 - 4. 选择某个事件以查看其摘要和详情。通过其会话链接查看完整追踪。 + 2. 先使用当前时间窗口且不设任何过滤条件，确认数据正在正常接入。 + 3. 按环境、事件类型、agent 或会话进行过滤，也可使用搜索功能查找 payload 文本。 + 4. 选择某个事件以查看其摘要和详情，点击会话链接可查看完整追踪记录。 - ![带有时间、环境、事件类型、agent、模型、上下文、会话和文本过滤器的实时 Events 流。](/images/dashboard/events-stream-current.png) + ![实时 Events 流，展示来自 Hermes 聊天网关及编程 CLI 运行的流量，可按时间、环境、事件类型、agent、模型、上下文和会话进行过滤。](/images/dashboard/events-stream-current.png) ```bash @@ -24,20 +24,22 @@ icon: "radio" fp --json events --full --session-id --all ``` - 默认数据流不包含原始 payload。仅在对有限范围的会话进行排查时使用 `--full`。 + 默认数据流不包含原始 payload。请仅在针对有限范围的会话进行排查时使用 `--full`。 -使用事件流来即时回答以下三个问题： +使用事件流可即时回答以下三个问题： -- 预期的 agent 是否在向正确的环境上报？ +- 预期的 agent 是否在向正确的环境上报数据？ - 模型调用、工具调用和策略决策是否按顺序到达？ -- 会话是否已停止推进，或开始重复执行某个操作？ +- 会话是否已停止推进，或开始重复某个操作？ -事件类型包括：agent 生命周期事件、模型请求与响应、工具使用及结果、hook 执行、人工等待与中断，以及显式错误。关联 ID 将成对的事件（如工具调用及其结果）关联在一起。 +事件类型包括：agent 生命周期事件、模型请求与响应、工具使用及结果、hook 执行、人工等待与中断，以及显式错误。关联 ID 会将成对事件（如工具调用与其结果）串联起来。 - 在验证新集成时，保持实时视图不设过滤条件。看到第一个事件后再添加过滤器——错误的过滤条件可能让你误以为是数据采集失败。 + 在验证新集成时，建议先保持实时视图的宽泛过滤。待看到第一个事件后再添加过滤条件——错误的过滤条件可能会让数据接入问题看起来像是采集失败。 -如果没有任何事件出现，请运行 `failproofai config --status`，然后参阅[排查数据采集问题](/zh/reference/troubleshooting)。 \ No newline at end of file +若没有事件出现，请运行 `failproofai config --status`，然后参阅[排查数据接入问题](/zh/reference/troubleshooting)。 + +未运行在 12 种受支持的 [harnesses](/zh/reference/harnesses) 之一中的 agent，可通过 [Python SDK](/zh/reference/python-sdk) 上报相同类型的事件，包括网关和生产环境 agent 所依赖的人机协作事件（`human_wait`、`human_input`、`human_interrupt`）。 \ No newline at end of file diff --git a/docs/zh/sessions/overview.mdx b/docs/zh/sessions/overview.mdx index 6a9526f48..75326f26b 100644 --- a/docs/zh/sessions/overview.mdx +++ b/docs/zh/sessions/overview.mdx @@ -1,27 +1,29 @@ --- title: "会话" -description: "从单次 Agent 运行的完整记录开始排查。" +description: "从一次 Agent 运行的完整记录开始。" icon: "workflow" --- 当 Agent 行为异常时，会话是最佳的排查起点。它将属于同一次运行的模型请求、响应、工具调用、人工交互、错误、评估以及策略决策汇聚在一起。 +无论由哪种运行框架产生，会话的格式都保持一致。在 Claude Code 中重写代码仓库的运行、在 Slack 中回复客户的 Hermes Agent，以及通过 SDK 埋点的 Python 服务，都会落入相同的追踪格式，因此一个视图即可覆盖整个 Agent 群。 +
-跟踪单次 Agent 运行的完整过程——从目标设定，到模型调用、工具使用，直至最终响应。 +跟踪一次 Agent 运行，从目标出发，经历模型调用、工具使用，直至最终响应。 ## 查找会话 - 1. 在云端侧边栏中，进入 **Observe → Sessions**。 + 1. 在 Cloud 侧边栏中，前往 **Observe → Sessions**。 2. 设置时间范围，然后按环境、状态、Agent 或会话 ID 进行筛选。 - 3. 如需按质量、成本、Token 或延迟进行切片，可添加评分或指标范围。 - 4. 点击某行即可打开其追踪详情。分享时可使用会话 ID 旁边的复制按钮。 + 3. 当需要按质量、成本、Token 或延迟切片时，添加分数或指标范围。 + 4. 选择某一行以打开其追踪。分享时可使用会话 ID 旁边的复制按钮。 - ![Sessions 列表，每行对应一次运行，支持按环境、Agent、状态和评估评分进行筛选。](/images/dashboard/sessions-list.png) + ![会话列表，每次运行显示一行，包含环境、Agent、状态和评估分数筛选器。](/images/dashboard/sessions-list.png) ```bash @@ -30,26 +32,26 @@ icon: "workflow" fp --json sessions --session-id ``` - 使用 `--agents` 展开多 Agent 运行，`--all` 分页获取所有结果，或使用 `--fields` 自定义输出列。 + 添加 `--agents` 可展开多 Agent 运行，`--all` 可翻页，`--fields` 可选择输出列。 ## 你可以做什么 - 按 Agent、环境、时间、模型、事件类型或错误状态查找运行记录。 -- 追踪产生某一结果的完整事件序列。 -- 对比成功与失败的运行记录。 -- 查看审计发现或告警事件所依据的证据。 -- 导出会话以获取离线记录。 +- 追踪产生某一结果的精确执行序列。 +- 对比成功与失败的运行。 +- 打开审计发现或告警事件所依据的原始证据。 +- 在需要离线记录时导出会话。 ## 可靠的排查顺序 1. 确认会话目标和运行环境。 -2. 找到第一个错误或非预期决策——而不仅仅是最终的失败点。 -3. 检查该时刻之前的模型上下文和工具输入。 -4. 检查重试次数、延迟情况和人工中断。 -5. 审查评估评分和策略决策。 +2. 找到第一个错误或意外决策——而不仅仅是最终的失败点。 +3. 检查错误发生之前的模型上下文和工具输入。 +4. 检查重试次数、延迟和人工中断情况。 +5. 查看评估分数和策略决策。 - - 了解如何从会话摘要追溯到导致该结果的具体事件。 + + 了解如何从会话摘要定位到导致结果的具体事件。 \ No newline at end of file diff --git a/docs/zh/start/quickstart.mdx b/docs/zh/start/quickstart.mdx index 7f237d62b..d77dae020 100644 --- a/docs/zh/start/quickstart.mdx +++ b/docs/zh/start/quickstart.mdx @@ -1,10 +1,12 @@ --- title: "快速入门" -description: "捕获智能体会话，发现故障，并开始防止故障发生。" +description: "捕获一次 Agent 会话，发现故障，并开始预防它。" icon: "zap" --- -本快速入门指南将帮助你完成：让一台机器上报会话、运行审计，并部署策略。你可以使用技能包来设置 Failproof AI，或按照手动步骤操作。需要 Node.js 20.9 或更高版本。 +本快速入门将帮助你完成以下操作：让一台机器上报会话、运行审计，并部署策略。你可以使用技能包来配置 Failproof AI，也可以按照手动步骤操作。 + +**选择你的路径：** 如果你的 Agent 运行在 12 个受支持的[运行环境](/zh/reference/harnesses)之一中——例如编码 CLI，或 Hermes、OpenClaw 等网关——请按照以下步骤操作；你需要 Node.js 20.9 或更高版本。如果你的 Agent 没有运行环境，可使用 [Python SDK](/zh/reference/python-sdk) 进行追踪和审计，然后从[运行首次故障检查](/zh/start/first-audit)处继续；此路径上的执行能力需要在你的运行时中添加 hook。 @@ -14,21 +16,21 @@ icon: "zap" npx skills add FailproofAI/skills ``` - + ```text Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives. ``` - 你的智能体会检查项目、选择相关集成、执行设置并验证结果。请查看 [FailproofAI skills 仓库](https://github.com/FailproofAI/skills) 了解各个技能和高级安装选项。 + 你的 Agent 会检查项目、选择相关集成、执行配置，并验证会话是否已到达。请参阅 [FailproofAI skills 仓库](https://github.com/FailproofAI/skills)了解各项技能及高级安装选项。 - + ## 开始之前 1. 打开 [Failproof AI 控制台](https://app.befailproof.ai)，创建账号或使用工作邮箱登录。 -2. 前往 **Administration → Keys**，创建一个拥有 `events:add` 和 `policies:pull` 权限的密钥。 -3. 复制一次性密钥，并将其存储到目标机器上： +2. 前往 **Administration → Keys**，创建一个具有 `events:add` 和 `policies:pull` 权限的密钥。 +3. 复制一次性密钥，并将其存储在目标机器上： ```bash export FAILPROOFAI_KEY="" @@ -45,7 +47,7 @@ export FAILPROOFAI_KEY="" 默认情况下会发送会话记录。添加 `--no-transcripts` 可在不包含记录内容的情况下上报 hook 活动和策略决策。 - 如果该机器上已有智能体历史记录，可预览并导入最近七天的数据，然后等待传输完成。新机器可跳过此步骤。 + 如果该机器上已有 Agent 历史记录，可预览并导入最近七天的数据，然后等待传输完成。在全新机器上可跳过此步骤。 ```bash failproofai backfill --since 7d --dry-run @@ -55,25 +57,28 @@ export FAILPROOFAI_KEY="" 在 Failproof AI 中打开 **Sessions**，选择一个已导入的会话。 - - 此步骤将 Failproof AI 附加到你的智能体 CLI，并安装内置策略。你可以通过它们在本地查看策略决策，并在 Failproof AI 审计会话、为你的智能体编写策略之前，先尝试策略执行效果。 + + 此步骤将 Failproof AI 挂载到你的运行环境，并安装 40 条内置策略。使用这些策略可以查看本地策略决策，并在 Failproof AI 审计你的会话并为 Agent 编写策略之前试用执行能力。 - 让安装程序自动检测你的智能体 CLI，或显式指定一个。 + 可让安装程序自动检测你的运行环境，也可以显式指定一个。12 个运行环境均为有效的 `--cli` 值——`claude`、`codex`、`copilot`、`cursor`、`opencode`、`pi`、`hermes`、`openclaw`、`factory`、`devin`、`antigravity`、`goose`。 ```bash - failproofai policies --install --cli claude --scope user + failproofai policies --install --cli claude --scope user # 编码 CLI + failproofai policies --install --cli hermes --scope user # Slack/Telegram 网关 ``` + + 在工具调用执行前拦截已在全部 12 个运行环境中验证。轮次结束门控在 8 个环境中验证——各运行环境的详细情况请参阅[执行能力](/zh/reference/harnesses#enforcement-capability)矩阵。 - 按照 [运行你的第一次故障检查](/zh/start/first-audit) 操作。使用具体的目标，例如"找出智能体在不改变方法的情况下重试失败工具的会话"。 + 按照[运行首次故障检查](/zh/start/first-audit)操作。使用具体目标，例如"查找 Agent 在未改变方案的情况下重试失败工具的会话"。 - - 按照 [使用策略防止第一次故障](/zh/start/first-policy) 操作。从观察模式开始，检查匹配项，然后对审核后的版本启用强制执行。 + + 按照[通过策略预防首次故障](/zh/start/first-policy)操作。先以观察模式启动，检查匹配项，然后对已审核的版本启用执行。 - 运行 `failproofai config --status`。健康的配置会报告云连接状态、守护进程状态，以及强制执行是否已暂停。 + 运行 `failproofai config --status`。配置正常时，将显示云连接状态、守护进程状态，以及执行是否已暂停。 \ No newline at end of file