
أداة توجيه ومرجع حتمي لوكلاء الذكاء الاصطناعي الهجوميين المستقلين، تفرض بوابات التفويض والنطاق والأدلة لضمان اختبار اختراق قابل للتكرار وصادق.
📖 اقرأ الدليل عبر الإنترنت: اتبع الدروس من أول تشغيل تجريبي لك وصولًا إلى وكيل ذي حدود واضحة.

الأمن المستقل / دليل الميدان للمطوّر
اقرأ الموقع · ابدأ الدورة · شغّل المختبر · اربط نموذجك · تسلسل البناء
دليل عملي لبناء وكلاء أمن مستقلين بحدود صريحة لما يجوز للنموذج أن يقرره. تعلّم كيف تحوّل الملاحظات إلى خطة، وتقبل الإجراءات المسموح بها فقط، وتربط النتائج بالأدلة، وتحاسب على العمل الذي تعذّر إنجازه.
يظل النموذج احتماليًا. أما تطبيق المضيف فيملك التفويض والإجراءات المسموح بها وسجلات الأدلة والقبول. إن إعادة تشغيل المدخلات المجمّدة والسياسة يمكن أن تعيد إنتاج قرارات التحكم تلك؛ لكنها لا تجعل هدفًا حيًا أو استجابة نموذج قابلة للتكرار.
ينبغي أن تكون مرتاحًا في قراءة أساسيات Python وJSON وHTTP. اتبع المسار الأساسي من أول تشغيل وصولًا إلى التطبيق المجمّع. يوجّهك درس الإرسال إلى عقد قصير لاختيار خط الأساس؛ أما وحدات التحكم التكيفية فهي اختيارية بعد البناء الأساسي. على طول الطريق، ستعدّل ملفات البداية وتشغّل فحوصات تفشل حتى يعمل كودك. تعمل الدورة دون اتصال بالإنترنت دون مفتاح API أو اتصال بهدف.
يعرض موقع القراءة الدروس بالترتيب، مع التنقل والرسوم البيانية والبحث. استخدم دليل الموقع لبنائه أو معاينته محليًا.
من نسخة محلية من هذا المستودع:
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txt
python3 -m harness.demo --out /tmp/harness-report.json
diff -u harness/report.json /tmp/harness-report.json
python3 -m pytest tests/test_harness.py
تم التحقق من هذا الإصدار على CPython 3.14. إصدارات Python الأقدم ليست جزءًا من أدلة الإصدار؛ وإذا استخدمت أحدها، فشغّل تسلسل البوابات الكامل أدناه قبل الاعتماد على النتيجة.
عندما يتطابق التقرير مع المثال المُودَع، لا يطبع diff شيئًا. افتح التقرير وتتبّع نتيجة الترويسة من شدتها المقترحة إلى شدتها الخاضعة للحوكمة. ثم افحص الرفع المرفوض والرفع المسموح به للعلامة الاصطناعية. لا تزال كلتا النتيجتين تتطلبان مراجعة بشرية.
اقرأ بيان المدخلات، والتنفيذ، والاختبارات العدائية إلى جانب التقرير النموذجي. تكون قد أكملت هذا التمهيد عندما تستطيع تفسير سبب السماح بإجراء ما، وسبب رفض رفع ما، وما الذي تقيسه أعداد التغطية في التقرير فعليًا.
لا يُجري مختبر الأداة الافتراضي أي طلب شبكي ولا يستدعي أي نموذج. مسند إثباته اصطناعي، ومضيفه ومهايئاته موثوقة، وكل نتيجة موسومة بأنها تتطلب مراجعة بشرية. لا ينفّذ المختبر سير عمل قبول الشخص أو توقيع التقرير. الاقتباس الحرفي يثبت سلامة الاستشهاد، لا قابلية الاستغلال. إن استدعاءات النموذج الأقل وإعادة العمل الأقل هما هدفان تصميميان، وليسا وفورات مقيسة بواسطة المجموعة.
يوفّر نموذجك المقترحات. يحتفظ التطبيق بالسياسة والحالة، ويفحص كل مقترح، وينفّذ إجراءات التركيبات المسموح بها ويسجّل النتيجة. يمنحك هذا المستودع التطبيق والتمارين؛ وأنت توفّر اتصال النموذج.
your model -> JSON proposal -> application checks -> fixture tool -> evidence + report
|
reject or stop
شغّل التطبيق المُجمَّع مع ناقل النموذج الوهمي أولاً:
python3 -m examples.app_agent --out /tmp/agent-report.json --store /tmp/agent-memory.db
python3 -m pytest tests/test_app_agent_example.py -q
افحص حالات المقترحات والأدلة في /tmp/agent-report.json. ثم اتبع وصّل نموذجك الخاص لاستخدام نموذج محلي أو كتابة غلاف نقل. يبقى جسر النموذج الأقدم تمرين اتصال أصغر بصيغة مقترحات مختلفة. يُبقي كلا المثالين إجراءات الأدوات على تركيبات ثابتة، بما في ذلك عندما يقدّم نموذج حقيقي الرد.
يُسمّي الدليل ما يجب استبداله، وJSON المطلوب إرجاعه، والفحوصات التي يجب الإبقاء عليها، والتقرير المتوقع، والعمل المتبقي قبل إضافة أدوات حية.
يجمع المخطط بين ضوابط المختبر واتصال المقترحات. يدرّب جسر النموذج على قبول الإجراءات والتقاط الأدلة؛ ويعرض المختبر الافتراضي بشكل منفصل حوكمة النتائج. ولا يُعد أي منهما وكيل أمان حيًا مكتملًا.
يُفتح أي مخطط بالحجم الكامل عند النقر عليه؛ وعلى شاشة ضيقة يمكنك أيضًا تمريره جانبيًا.
هذا هو ترتيب التعلم. في وقت التشغيل، يسبق التفويض والبوابة الإرسال. يجب أن يتركك كل درس بمكوّن صغير، واختبار عدائي، وأثر يمكنك فحصه.