agentic-radar

جدول المحتويات

1. الوصف
2. المُصوِّر الوكيلي
3. البدء
   • المتطلبات الأساسية
   • التثبيت
4. التثبيت المتقدم
   • تثبيت CrewAI
   • تثبيت OpenAI Agents
5. الاستخدام
6. الميزات المتقدمة
   • تقوية المطالبات الوكيلية
   • اختبار الثغرات الأمنية في سير العمل الوكيلية
   • سير عمل CI/CD
7. خارطة الطريق
8. المدونات والدروس التعليمية
9. المجتمع
10. الأسئلة الشائعة
11. المساهمة
12. مدونة قواعد السلوك
13. الترخيص

الوصف 📝

صُمم Agentic Radar لتحليل الأنظمة الوكيلية وتقييمها للحصول على رؤى أمنية وتشغيلية. وهو يساعد المطورين والباحثين ومتخصصي الأمن على فهم كيفية عمل الأنظمة الوكيلية وتحديد الثغرات الأمنية المحتملة.

يتيح للمستخدمين إنشاء تقرير أمني للأنظمة الوكيلية، بما في ذلك:

1. تصوّر سير العمل - رسم بياني لسير عمل النظام الوكيلي✅
2. تحديد الأدوات - قائمة بجميع الأدوات الخارجية والمخصصة التي يستخدمها النظام✅
3. كشف خوادم MCP - قائمة بجميع خوادم MCP التي يستخدمها وكلاء النظام✅
4. ربط الثغرات - جدول يربط الأدوات المحددة بالثغرات المعروفة، مما يوفر نظرة عامة أمنية✅

يلخّص تقرير HTML الشامل جميع النتائج ويتيح سهولة المراجعة والمشاركة.

عرض مثال التقرير الكامل هنا

يتضمن Agentic Radar ربط الثغرات المكتشفة بأطر أمنية معروفة 🛡️.

• OWASP Top 10 LLM Applications

• OWASP Agentic AI – Threats and Mitigations

Agentic Visualizer 🎆

إذا كنت مهتمًا بالتصوّر فقط، جرّب Agentic Visualizer.

إنها أداة قائمة على الويب تتيح لك تصوّر سير العمل الوكيلي بطريقة سهلة الاستخدام.

البدء 🚀

المتطلبات الأساسية

لا توجد أي متطلبات! فقط تأكد من تثبيت Python (pip) على جهازك.

التثبيت

pip install agentic-radar

# Check that it is installed
agentic-radar --version

تتطلب بعض الميزات عمليات تثبيت إضافية، اعتمادًا على إطار العمل الوكيلي المستهدف. اطّلع على المزيد أدناه.

التثبيت المتقدم

تثبيت CrewAI

تكون إضافات CrewAI مطلوبة عند استخدام إحدى الميزات التالية بالاقتران مع CrewAI:

• اختبار Agentic Radar
• أوصاف الأدوات المعرّفة مسبقًا

يمكنك تثبيت Agentic Radar مع تبعيات CrewAI الإضافية عن طريق تشغيل:

pip install "agentic-radar[crewai]"

[!WARNING] سيؤدي هذا إلى تثبيت حزمة crewai-tools التي لا تدعمها إلا إصدارات Python >= 3.10 و < 3.13. إذا كنت تستخدم إصدارًا مختلفًا من Python، فستكون أوصاف الأدوات أقل تفصيلًا أو غائبة تمامًا.

تثبيت OpenAI Agents

تكون إضافات OpenAI Agents مطلوبة عند استخدام إحدى الميزات التالية بالاشتراك مع OpenAI Agents:

• Agentic Radar Test

يمكنك تثبيت Agentic Radar مع تبعيات OpenAI Agents الإضافية عن طريق تشغيل:

pip install "agentic-radar[openai-agents]"

الاستخدام

يدعم Agentic Radar الآن أمرين رئيسيين:

1. scan

فحص الشيفرة بحثًا عن سير العمل الوكيلي وإنشاء تقرير.

agentic-radar scan [OPTIONS] FRAMEWORK:{langgraph|crewai|n8n|openai-agents|autogen}

مثال:

agentic-radar scan langgraph -i path/to/langgraph/example/folder -o report.html

2. test

اختبار الوكلاء في سير عمل وكيلي بحثًا عن ثغرات أمنية متنوعة. يتطلب تعيين OPENAI_API_KEY كمتغير بيئة.

agentic-radar test [OPTIONS] FRAMEWORK:{openai-agents} ENTRYPOINT_SCRIPT_WITH_ARGS

مثال:

agentic-radar test openai-agents "path/to/openai-agents/example.py"

اطّلع على المزيد حول هذه الميزة هنا.

الميزات المتقدمة ✨

تقوية الموجّهات الوكيلية

تعمل ميزة تقوية الموجّهات الوكيلية (Agentic Prompt Hardening) تلقائيًا على تحسين موجّهات النظام المكتشفة في سير عملك الوكيلي وتعرضها في التقرير. فهي تحوّل تعليمات الوكيل البسيطة إلى موجّهات نظام مُهيكلة عالية الجودة تتبع أفضل ممارسات هندسة الموجّهات.

[!NOTE]
الأُطُر المدعومة حاليًا (مع المزيد قريبًا): OpenAI Agents، CrewAI، Autogen

استخدامها مباشر جدًا:

1. عيّن متغير البيئة OPENAI_API_KEY الخاص بك عبر تنفيذ export OPENAI_API_KEY=<api_key>. بدلًا من ذلك، مرّر ملف .env صراحةً باستخدام --env-file path/to/.env (لا يقوم Agentic Radar بتحميل ملف .env تلقائيًا أبدًا).