وكلاء الذكاء الاصطناعي والأوتوميشن

1. الوكيل vs الشات — متى يكفي الرد ومتى تحتاج تنفيذاً؟

الهدف: تميّز بين مساعد دردشة يجيب نصاً وبين وكيل ينفّذ خطوات ويتخذ قرارات.

الشات (Chatbot): يستقبل سؤالاً ويردّ بنص — لا يغيّر العالم خارج المحادثة.

الوكيل (Agent): يحلّل الهدف، يخطّط خطوات، يستدعي أدوات (API، ملفات، متصفح، قاعدة بيانات)، يراقب النتائج، ويعيد المحاولة إن لزم.

الفرق الجوهري: **الوكيل له حلقة عمل** — Think → Act → Observe → Repeat.

متى تختار ماذا؟
• شرح مفهوم → شات كافٍ
• «أرسل تقريراً أسبوعياً من Google Sheets إلى Slack» → وكيل + أتمتة
• «راجع 50 ملفاً وحدّث حالاتها» → وكيل بأدوات

قاعدة Mesue: لا تسمِّ كل شات «وكيلاً». الوكيل الحقيقي **يفعل** لا يقترح فقط.

• الشات = إجابة؛ الوكيل = تنفيذ متعدد الخطوات
• الوكيل يحتاج أهدافاً واضحة ومعايير نجاح
• بدون أدوات، معظم «الوكلاء» مجرد شات متقدّم
• ابدأ بمهمة صغيرة قابلة للقياس

 [سؤال]
    |
 شات → نص واحد
    |
 وكيل → خطوات → أدوات → نتيجة

2. معمارية الوكيل — Planner، Tools، Memory

الهدف: تفهم المكوّنات الأساسية التي تجعل الوكيل يعمل بشكل منظم لا عشوائي.

معمارية وكيل كلاسيكية:

**1) Planner (المخطّط):** يحوّل الهدف إلى خطوات فرعية. «أرسل تقرير المبيعات» → [جلب البيانات → تنسيق → إرسال بريد].

**2) Tools (الأدوات):** دوال أو واجهات ينفّذها الوكيل — HTTP، SQL، قراءة ملف، إرسال رسالة.

**3) Memory (الذاكرة):** ما يتذكّره الوكيل بين الخطوات — سياق المحادثة، نتائج سابقة، تفضيلات المستخدم.

**4) Executor (المنفّذ):** يشغّل الأداة ويرجع النتيجة للمخطّط.

حلقة ReAct شائعة: Reason (فكّر) → Act (نفّذ) → Observe (راقب).

خطأ شائع: وكيل بلا مخطّط يكرّر نفس الأداة عشوائياً. خطأ آخر: أدوات كثيرة بلا وصف واضح تُربك النموذج.

• Planner يقسّم الهدف الكبير
• Tools = جسر الوكيل بالعالم الحقيقي
• Memory تمنع فقدان السياق بين الخطوات
• Observe قبل التكرار يقلّل الأخطاء

 هدف
  |
 Planner → خطوات
  |
 Tools ←→ Memory
  |
 نتيجة

3. Tool Calling — مخططات الدوال وJSON Schema

الهدف: تفهم كيف يختار النموذج أداة ويمرّر معاملات صحيحة عبر Function Schemas.

Tool Calling = النموذج **لا يشغّل** الكود بنفسه — يُخرج طلباً منظّماً: «استدعِ الدالة X بالمعاملات Y».

أنت (أو المنصة) تنفّذ الدالة وتعيد النتيجة للنموذج.

**JSON Schema** يصف كل أداة:
• name: اسم الدالة
• description: متى تُستخدم (مهم جداً!)
• parameters: الحقول المطلوبة وأنواعها

مثال: `search_products(query: string, max_results: int)`

أفضل الممارسات:
• أوصاف دقيقة — «ابحث في فهرس المنتجات» لا «search» فقط
• معاملات مطلوبة vs اختيارية
• أدوات قليلة متخصصة أفضل من أداة واحدة ضخمة
• تحقّق من المدخلات قبل التنفيذ (validation)

OpenAI، Anthropic، Gemini — كلهم يدعمون function/tool calling بصيغ متقاربة.

• النموذج يختار الأداة؛ أنت تنفّذها
• description يوجّه اختيار الأداة
• Schema صارم يقلّل أخطاء المعاملات
• تحقّق من المخرجات قبل إعادتها للنموذج

 LLM → {tool, args}
         |
    [تنفيذك]
         |
    نتيجة → LLM

4. MCP — Model Context Protocol

الهدف: تفهم كيف يربط MCP الوكيل بمصادر بيانات وأدوات خارجية بمعيار موحّد.

MCP (Model Context Protocol) = بروتوكول مفتوح يربط نماذج الذكاء الاصطناعي بـ **Resources** (بيانات للقراءة) و **Tools** (إجراءات للتنفيذ).

بدل كتابة تكامل مخصّص لكل خدمة، MCP يوفّر:
• **Servers** — خدمات (GitHub، Postgres، Slack، filesystem…)
• **Clients** — Cursor، Claude Desktop، وكلاء مخصّصون
• واجهة موحّدة للاكتشاف والاستدعاء

مثال في Cursor: MCP server لقاعدة بيانات → الوكيل يقرأ الجداول ويشغّل استعلامات بأمان نسبي.

متى تستخدم MCP؟
• بيانات داخلية متكررة الاستخدام
• أدوات فريق موحّدة
• تقليل «نسخ-لصق» السياق يدوياً

احتياط: صلاحيات MCP = صلاحيات الوكيل. قيّد ما يمكن قراءته وتعديله.

• MCP = طبقة توحيد بين LLM والأنظمة
• Resources للقراءة، Tools للتنفيذ
• Cursor وClaude يدعمان MCP servers
• الأمان يبدأ من صلاحيات السيرفر

 [Cursor/Agent]
       |
   MCP Client
       |
 GitHub | DB | Files
 (MCP Servers)

5. ذاكرة الوكيل — قصيرة المدى وطويلة المدى

الهدف: تفرّق بين سياق المحادثة والذاكرة الدائمة ومتى تستخدم كل نوع.

**ذاكرة قصيرة المدى (Short-term):**
• نافذة المحادثة الحالية
• نتائج الخطوات الأخيرة في حلقة ReAct
• تُفقد عند إغلاق الجلسة (إلا إذا حفظت)

**ذاكرة طويلة المدى (Long-term):**
• تفضيلات المستخدم («أفضّل التقارير بالعربية»)
• حقائق مستقرة («عميل X في قطاع Y»)
• ملخصات جلسات سابقة
• Vector store للبحث الدلالي

تقنيات شائعة:
• **Summarization** — ضغط المحادثة الطويلة
• **Entity memory** — حفظ كيانات (أسماء، مشاريع)
• **RAG** — استرجاع مقاطع من قاعدة معرفة (درس 10)

قاعدة: لا تخزّن أسراراً في ذاكرة طويلة بلا تشفير. نظّف الذاكرة دورياً من معلومات قديمة.

• قصيرة = جلسة؛ طويلة = عبر الزمن
• Summarization توفّر tokens
• Vector memory للبحث بالمعنى
• لا تخزّن PII أو secrets بلا حماية

 جلسة → short-term
        |
   summarize / embed
        |
   long-term store

6. أنظمة Multi-Agent — تخصص وتنسيق

الهدف: تفهم متى تقسّم العمل على وكلاء متعدّدين وكيف ينسّقون.

وكيل واحد قد يكفي للمهام البسيطة. Multi-agent مفيد عندما:
• المهمة متعددة التخصصات (بحث + كتابة + مراجعة كود)
• تحتاج **تحققاً متقاطعاً** (وكيل ينتقد وكيلاً)
• الحجم يتجاوز سياق نموذج واحد

أنماط شائعة:
• **Supervisor:** وكيل رئيسي يوزّع على sub-agents
• **Pipeline:** Researcher → Writer → Editor
• **Debate:** وكيلان يختلفان ثم قرار
• **Parallel:** عدة وكلاء يعملون ثم دمج

مخاطر:
• تكلفة tokens مضاعفة
• حلقات لا نهائية بين الوكلاء
• غموض «من المسؤول؟»

قاعدة Mesue: ابدأ بوكيل واحد جيد. أضف وكيلاً ثانياً فقط عند bottleneck واضح.

• Multi-agent = تخصص + تنسيق
• Supervisor يناسب مهام معقدة
• راقب التكلفة والحلقات
• ابدأ بسيطاً ثم قسّم

 Supervisor
  /   |   \
 R    W    C
  \   |   /
   مخرج نهائي

7. Human-in-the-Loop — متى يتوقف الوكيل؟

الهدف: تبني نقاط موافقة بشرية قبل الإجراءات الحساسة.

Human-in-the-loop (HITL) = إيقاف الوكيل عند قرارات حرجة لموافقة بشرية.

متى تفرض HITL؟
• إرسال بريد/رسالة جماعية
• دفع أو تحويل مالي
• حذف أو تعديل بيانات إنتاج
• نشر محتوى باسم الشركة
• قرارات قانونية أو طبية

أنماط التنفيذ:
• **Approval gate** — «هل أرسل؟ نعم/لا»
• **Draft mode** — الوكيل يجهّز مسودة؛ أنت ترسل
• **Confidence threshold** — إذا ثقة النموذج < X% → بشر
• **Audit log** — سجل كل إجراء للمراجعة

الوكيل «الم autonomous» الكامل نادراً آمناً في الإنتاج. HITL ليس ضعفاً — بل ضمان جودة ومسؤولية.

• HITL عند الإجراءات غير القابلة للتراجع
• Draft mode آمن للبداية
• سجّل كل قرار للتدقيق
• السرعة ≠ تجاهل الإنسان

 وكيل → مسودة
         |
    [موافقة بشر]
         |
      تنفيذ

8. أتمتة سير العمل — n8n، Zapier، Make

الهدف: تربط الوكيل بمشغّلات وأحداث حقيقية دون برمجة كل شيء من الصفر.

ليس كل «وكيل» يحتاج كوداً مخصّصاً. منصات الأتمتة تربط تطبيقات بـ triggers وactions:

**Zapier:** سهل، آلاف التكاملات، مناسب للمبتدئين.
**Make (Integromat):** مرئي معقد، فروع وloops.
**n8n:** مفتوح المصدر، self-host، مرن للفرق التقنية.

أين يدخل AI؟
• عقدة «OpenAI/Claude» داخل الـ workflow
• n8n AI Agent node
• Webhook يستدعي وكيلك المخصّص

مثال Mesue:
Trigger: نموذج تواصل جديد → AI يلخّص الطلب → Slack → إنشاء مهمة Notion.

قاعدة: **Automate the boring, agent the fuzzy.** الأتمتة للقواعد الثابتة؛ الوكيل للنصوص والقرارات الغامضة.

• Zapier/Make/n8n = glue بين التطبيقات
• AI node داخل workflow وليس بديلاً عنه
• Webhook يربط وكيلك المخصّص
• ابدأ بـ trigger → action واحد

 Trigger → [Filter] → AI → Action
   |                      |
 form                  Slack/email

9. وكلاء المتصفح — Computer Use

الهدف: تفهم كيف يتفاعل الوكيل مع الويب والواجهات كإنسان — مع حدود الأمان.

Browser / Computer Use agents يتحكمون في:
• نقر، كتابة، تمرير في المتصفح
• ملء نماذج، استخراج جداول
• أحياناً سطح المكتب (فتح تطبيقات)

أمثلة: Claude Computer Use، OpenAI Operator، Playwright + LLM، Cursor browser tools.

حالات استخدام:
• اختبار واجهة بعد deploy
• جمع بيانات عامة من مواقع بلا API
• أتمتة مهام إدارية متكررة

**مخاطر:**
• تسجيل دخول بكلمات مرور في جلسة الوكيل
• CAPTCHA وحظر IP
• النقر على زر خاطئ (حذف، دفع)

احتياط Mesue: جلسات معزولة، حسابات test، HITL قبل submit نهائي، لا credentials في prompts.

• Browser agent = أتمتة واجهات بلا API
• Playwright + LLM نمط شائع للمطورين
• عزل الجلسة وتقليل الصلاحيات
• HITL قبل إرسال نماذج حساسة

 LLM → click/type
         |
    [Browser]
         |
    صفحة ويب

10. RAG للوكلاء — معرفة خارج نموذجك

الهدف: تربط الوكيل بمستنداتك باسترجاع دلالي بدل الاعتماد على ذاكرة النموذج فقط.

RAG (Retrieval-Augmented Generation):
1) **Index** — تقسيم مستندات → embeddings → vector DB
2) **Retrieve** — عند السؤال، ابحث عن المقاطع الأقرب
3) **Generate** — مرّر المقاطع للنموذج مع السؤال

لماذا للوكلاء؟
• سياسات الشركة، توثيق API، دروس Mesue
• بيانات تتغيّر — لا تعيد ت train
• تقليل الهلوسة في إجابات «من docsنا»

مع Agent loop:
• الوكيل يقرر **متى** يستretrieve
• أداة `search_knowledge_base(query)`
• دمج النتائج في الخطة

أفضل الممارسات:
• chunks 500–1000 token مع overlap
• metadata (مصدر، تاريخ)
• cite المصادر في المخرجات
• حدّث الفهرس عند تغيّر المستندات

• RAG = استرجاع + توليد
• Vector DB للبحث بالمعنى
• الوكيل يستدعي RAG كأداة
• اذكر المصادر للمستخدم

 سؤال → embed → search
              |
         chunks → LLM → جواب

11. الأمان — Guardrails وحدود الوكيل

الهدف: تضع حدوداً تقنية وسلوكية قبل تشغيل الوكيل في بيئة حقيقية.

Guardrails = طبقات تمنع أو تصحّح سلوك الوكيل:

**1) Input filters:** رفض prompts ضارة، PII غير مصرّح
**2) Tool allowlist:** الوكيل يستدعي فقط أدوات مُعرّفة
**3) Output validation:** JSON schema، طول أقصى، كلمات ممنوعة
**4) Rate limits:** حد استدعاءات API وتكلفة يومية
**5) Sandboxing:** تنفيذ كود/Shell في بيئة معزولة

حدود صريحة في system prompt:
«لا تحذف ملفات. لا ترسل بريداً بلا موافقة. لا تخمّن API keys.»

مراقبة:
• Logging كل tool call
• تنبيه عند فشل متكرر
• Kill switch لإيقاف الوكيل

للمؤسسات: OWASP LLM Top 10، مراجعة أمن قبل الإنتاج.

• Allowlist أفضل من denylist للأدوات
• Sandbox للكود والـ Shell
• Rate limit يحمي الميزانية
• Kill switch ضروري

 input → [filter]
           |
        agent → [output check]
           |
        tools (allowlist)

12. مشروع Capstone — وكيل أتمتة شخصي

الهدف: تسلّم وكيلاً أو workflow أتمتة حقيقي يحلّ مشكلة من اختيارك.

المشروع النهائي — اختر **واحداً** ونفّذه خلال أسبوع:

**أ) وكيل تلخيص:** بريد/Slack → AI يلخّص → يرسل لك يومياً (n8n + OpenAI).

**ب) وكيل معرفة:** RAG على 10 مستندات + chat يستشهد بالمصادر.

**ج) وكيل Cursor:** Skill + Rules لمهمة متكررة في مشروعك (نشر، دروس Learn).

**د) Multi-step agent:** Planner + 2 tools + memory file + HITL قبل الإرسال.

معايير التسليم Mesue:
1) وصف المشكلة والهدف
2) مخطّط معمارية (Planner/Tools/Memory)
3) Guardrails مكتوبة
4) دليل اختبار (3 خطوات)
5) ما تعلّمته — نجاح وفشل

لا تبالغ في النطاق. **أتمتة واحدة تعمل > خمسة demos فارغة.**

• مشكلة حقيقية من حياتك/عملك
• HITL + guardrails مدمجة
• وثّق Architecture والاختبار
• شارك ما فشل — جزء من التعلّم

 مشكلتك
    |
 Planner + Tools + Memory
    |
 HITL + Guardrails
    |
 أتمتة تعمل ✓