agentic-radar

فهرس المحتويات

1. الوصف
2. Agentic Visualizer
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

يمكنك تثبيت 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"

انظر المزيد حول هذه الميزة هنا.

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

تقوية المطالبات الوكيلة

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

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

استخدامها بسيط للغاية:

1. عيّن متغير البيئة OPENAI_API_KEY بتشغيل export OPENAI_API_KEY=<api_key>.

2. شغّل Agentic Radar باستخدام الخيار --harden-prompts، على سبيل المثال:

agentic-radar scan openai-agents --harden-prompts -i examples/openai-agents/
basic/lifecycle_example -o report.html