إذا كنت تطور وكيل AI – سواء كان chatbot لخدمة العملاء أو أداة أتمتة تقارير – فأنت تعلم أن الخطأ الأمني قد يكون مكلفاً. وكيل بدون حوكمة قد يشارك معلومات حساسة، أو ينفذ أوامر غير مرغوب فيها، أو يتصرف بطرق غير متوقعة. هنا يأتي دور Agent Governance Toolkit من Microsoft: أداة مفتوحة المصدر تتيح لك تطبيق سياسات أمان، وهوية zero-trust، وعزل تنفيذ (sandboxing)، وهندسة موثوقية لوكلاء AI. في هذا الدليل، سنأخذك خطوة بخطوة من التثبيت إلى التشغيل مع أمثلة عملية تناسب المطور العربي.

ما هو Agent Governance Toolkit؟

هو مجموعة أدوات مفتوحة المصدر من Microsoft تهدف إلى تطبيق الحوكمة والأمان على وكلاء AI. يغطي جميع بنود OWASP Agentic Top 10، بما في ذلك منع الحقن (prompt injection)، والتحكم في الوصول، وعزل التنفيذ. يدعم Python (عبر pip) وTypeScript (عبر npm)، ويمكن نشره على Azure أو AWS أو محلياً باستخدام Docker Compose.

من يحتاج هذه الأداة ومن لا؟

من يحتاجها: مطورو وكلاء AI في الشركات الناشئة أو المؤسسات، خاصة في القطاعات الحساسة مثل البنوك والرعاية الصحية في السعودية. أي شخص يريد تطبيق OWASP Top 10 دون عناء بناء حل من الصفر.

من لا يحتاجها: من يبني وكيلاً بسيطاً لا يتعامل مع بيانات حساسة، أو من يستخدم منصة مغلقة توفر الحوكمة مسبقاً (مثل Azure AI Agent Service).

المميزات الرئيسية

• Policy Enforcement: فرض سياسات مخصصة عبر YAML. مثال: منع الوكيل من تنفيذ أوامر shell.
• Zero-Trust Identity: التحقق من هوية الوكيل في كل طلب.
• Execution Sandboxing: عزل تنفيذ الوكيل في حاوية Docker منفصلة.
• Reliability Engineering: إعادة المحاولة التلقائية، ومراقبة الأداء.
• تغطية OWASP Agentic Top 10: الأداة تعالج جميع المخاطر المدرجة في القائمة.

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

• Python 3.9+ أو Node.js 18+ (حسب اللغة المختارة).
• Docker (للساندبوكسينغ، اختياري لكن موصى به).
• حساب Azure (اختياري، للنشر السحابي).
• مفاتيح API للوكيل (مثل OpenAI API key).

التركيب خطوة بخطوة

1. تثبيت الحزمة

للإصدار الكامل مع جميع المكونات:

pip install agent-governance-toolkit[full]

أو للإصدار الأساسي:

pip install agent-governance-toolkit

لمستخدمي TypeScript:

npm install @microsoft/agent-governance-sdk

2. إعداد ملف .env

أنشئ ملف .env في مجلد المشروع وأضف المتغيرات التالية (هذا قالب جاهز):

# Agent Governance Toolkit Configuration
GOVERNANCE_POLICY_FILE=policy.yaml
GOVERNANCE_LOG_LEVEL=info
# اختياري: إذا كنت تستخدم Azure
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
AZURE_OPENAI_KEY=your-key-here
# أو OpenAI مباشرة
OPENAI_API_KEY=sk-... 

3. إنشاء سياسة بسيطة (policy.yaml)

هذا مثال لسياسة تمنع الوكيل من الوصول إلى ملفات تحتوي على 'ID' أو 'هوية':

policies:
  - name: block-sensitive-data
    description: منع الوصول إلى البيانات الحساسة
    rules:
      - action: deny
        condition: contains(output, 'ID') or contains(output, 'هوية')
        severity: high

4. تشغيل الأداة مع وكيل تجريبي

استخدم Docker Compose للتشغيل المحلي مع sandboxing. أنشئ ملف docker-compose.yml:

version: '3.8'
services:
  governance:
    image: mcr.microsoft.com/agent-governance-toolkit:latest
    ports:
      - "8080:8080"
    environment:
      - GOVERNANCE_POLICY_FILE=/app/policy.yaml
    volumes:
      - ./policy.yaml:/app/policy.yaml
      - ./.env:/app/.env

ثم شغّل:

docker-compose up

الآن الأداة تعمل على http://localhost:8080. يمكنك إرسال طلب وكيل عبر API.

أخطاء شائعة وحلولها

استخدامات عملية في السوق السعودي

• خدمة عملاء ذكية لشركة اتصالات: وكيل يرد على استفسارات العملاء، لكنه ممنوع من مشاركة رقم الهوية أو كلمة المرور. تطبق السياسة block-sensitive-data.
• أتمتة تقارير المبيعات: وكيل يقرأ بيانات المبيعات من قاعدة بيانات، لكنه لا يستطيع تنفيذ أوامر DELETE أو UPDATE. سياسة: deny if action contains 'DELETE' or 'UPDATE'.
• مساعد قانوني: وكيل يساعد في صياغة عقود، لكنه لا يستطيع الوصول إلى ملفات خارج النطاق المحدد.

هل يستحق التجربة؟

مقارنة مع البدائل:

الخلاصة: إذا كنت تبحث عن حل مفتوح ومرن يطبق معايير OWASP، فهذه الأداة خيار ممتاز. أما إذا كنت تستخدم Azure بالفعل، فقد يكون الخدمة المدمجة أسهل.

الأسئلة الشائعة (FAQ)

هل أحتاج إلى حساب Microsoft Azure لاستخدام Agent Governance Toolkit؟

لا، يمكنك تشغيله محلياً باستخدام Docker. لكن بعض ميزات النشر السحابي تتطلب Azure.

ما الفرق بين Agent Governance Toolkit وأدوات أخرى مثل LangChain أو AutoGen؟

LangChain وAutoGen هي frameworks لبناء وكلاء AI، بينما Agent Governance Toolkit تركز على الحوكمة والأمان. يمكن استخدامها معاً.

هل تدعم الأداة اللغة العربية في السياسات؟

نعم، يمكن كتابة شروط السياسات بأي لغة، بما في ذلك العربية، طالما أن الترميز UTF-8.

كيف أدمج الأداة مع وكيل AI موجود مسبقاً؟

يمكنك استخدام SDK (Python أو TypeScript) لتغليف الوكيل الحالي. راجع دليل التكامل في الموقع الرسمي.

ما هي تكلفة استخدام الأداة؟

الأداة نفسها مجانية ومفتوحة المصدر. التكاليف تأتي من البنية التحتية (مثل Docker host أو Azure) ومفاتيح API للوكيل.

هل الأداة مناسبة للمشاريع الصغيرة؟

نعم، يمكن تشغيلها على جهاز واحد. مناسبة للمشاريع الصغيرة والمتوسطة.

كيف أتعامل مع أخطاء التوافق بين Python والإصدارات؟

استخدم بيئة افتراضية (virtualenv) وتأكد من Python 3.9+. راجع وثائق الأداة للإصدارات المدعومة.

الخاتمة: الخطوة التالية

الآن لديك أساس عملي لبدء استخدام Agent Governance Toolkit. ابدأ بتجربة السياسة البسيطة أعلاه على وكيل تجريبي، ثم طوّرها حسب احتياجاتك. تذكر أن الحوكمة ليست عقبة، بل استثمار في موثوقية وكيلك. شاركنا تجربتك في التعليقات.