كيف تتعلم وكلاء الذكاء الاصطناعي من الصفر؟

المسار على ست مراحل

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

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

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

ما تحتاج إليه فعلياً قبل المرحلة 1

قائمة المتطلبات الفعلية قصيرة، وأقصر مما توحي به معظم صفحات الدورات.

• تستطيع قراءة وكتابة Python أو TypeScript بمستوى يسمح بكتابة script من خمسين سطراً.
• تستخدم Linux shell بثقة: تثبّت package، وتحرّر file، وتقرأ log.
• لديك API key لنموذج مستضاف، أو جهاز يستطيع تشغيل نموذج محلي.

هذه هي القائمة كاملة. لا تحتاج إلى نظرية machine learning، ولا تحتاج إلى أن تكون قد درّبت model. لا يتضمن عمل agent أي gradients أو training data. لا تصبح graphics card مهمة إلا إذا قررت تشغيل model بنفسك. وهذه مهارة منفصلة يمكنك تعلّمها لاحقاً من استضافة Ollama على VPS لتشغيل LLM ذاتياً.

ما يستهين به الناس هو جانب shell. تفشل agents بسبب الصلاحيات، والمسارات، ومتغيرات البيئة، والعمليات التي تتوقف بصمت. إذا كان stack trace يتعلق بـPATH أو file mode يجعلك تغلق الطرفية، فخصّص عطلة نهاية أسبوع لتعلّم أساسيات Linux أولاً. سيوفر عليك ذلك شهراً لاحقاً.

المرحلة 1: ما هو الوكيل وما ليس هو

ابدأ باستدعاء واحد لواجهة API ومن دون حلقة تكرار. أرسل مطالبة، واطبع الرد، واطّلع على أعداد الرموز المميزة في الاستجابة. أصبحت الآن تفهم وحدة التكلفة ووحدة زمن الاستجابة.

ثم تعلّم استخدام الأدوات، وهي الفكرة الجديدة الوحيدة فعلاً في هذا المجال بأكمله. تصف دالةً للنموذج من خلال اسمها ووصفها ومخطط JSON (صيغة ترميز كائنات JavaScript) لمدخلاتها. لا يشغّل النموذج أي شيء. بل يردّ بطلب منظّم: استدعِ run_command بهذه الوسائط. يشغّل كودك الدالة، ويرسل ناتجها مرة أخرى في رسالة، ثم يطلب من النموذج المحاولة مجدداً. النموذج مخطِّط يقرأ النص ويكتب النص. أما كودك فهو الجزء الذي يملك وسائل التنفيذ. للكود الموجود في جانبك من هذا التبادل اسم عندما تبدأ بمقارنة التصاميم: إنّه غلاف الوكيل، أي الحلقة والأدوات والصلاحيات المحيطة بنموذج لا يملك أياً منها.

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

المرحلة 2: اكتب الحلقة بنفسك، مرة واحدة

لا تبدأ بإطار عمل. اكتب نحو ثلاثين سطراً من Python حتى يكون تصميم البرنامج نابعاً منك.

sudo apt update && sudo apt install -y python3-venv
python3 -m venv ~/agent
source ~/agent/bin/activate
pip install anthropic
export ANTHROPIC_API_KEY=your-key-here

import subprocess
import anthropic

client = anthropic.Anthropic()

tools = [{
    "name": "run_command",
    "description": "Run a read only shell command and return its output.",
    "input_schema": {
        "type": "object",
        "properties": {"command": {"type": "string"}},
        "required": ["command"],
    },
}]

messages = [{"role": "user", "content": "How much disk space is free here?"}]

while True:
    response = client.messages.create(
        model="claude-opus-5",
        max_tokens=4096,
        tools=tools,
        messages=messages,
    )
    if response.stop_reason != "tool_use":
        break
    messages.append({"role": "assistant", "content": response.content})
    results = []
    for block in response.content:
        if block.type == "tool_use":
            done = subprocess.run(
                block.input["command"], shell=True,
                capture_output=True, text=True, timeout=10,
            )
            results.append({
                "type": "tool_result",
                "tool_use_id": block.id,
                "content": done.stdout or done.stderr,
            })
    messages.append({"role": "user", "content": results})

print(next(b.text for b in response.content if b.type == "text"))

شغّل البرنامج باستخدام python3 agent.py. تعرض النتيجة السليمة فقرة واحدة تذكر أنظمة الملفات ومساحتها الحرة، لأن النموذج طلب df -h، ونفّذ برنامجك هذا الطلب، ثم حوّلت الجولة الثانية ذلك الجدول إلى جملة. إذا لم يطبع البرنامج شيئاً، فقد انتهت الحلقة قبل وصول كتلة نصية. أضف print(response.stop_reason) داخل الحلقة، وراقب تغيّر القيم.

اكسر البرنامج عمداً الآن. احذف سطر tool_use_id واقرأ الخطأ، لأن نتيجة أداة لا تحتوي على معرّف مطابق ترفضها API، وهذا أكثر أخطاء المبتدئين شيوعاً. اطرح سؤالاً يحتاج إلى أمرين، وراقب الحلقة وهي تعمل مرتين. اطرح سؤالاً مستحيلاً، وراقب البرنامج إما وهو يتوقف أو يدور إلى ما لا نهاية.

تحذير واحد بشأن هذا المثال. فهو يمرّر مخرجات النموذج مباشرةً إلى shell باستخدام shell=True، وهذا مقبول على جهاز تجريبي يمكنك إعادة بنائه، لكنه غير صحيح في أي مكان آخر. تعالج المرحلة 6 هذا الأمر. تشرح بناء وكيل AI خاص بك على VPS المفاهيم الموجودة خلف الحلقة بمزيد من التفصيل.

المرحلة 3: الأدوات التي لم تكن متاحة للوكيل مسبقاً

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

يُعد Model Context Protocol (MCP) الحل الذي استقر عليه المجال. يوفّر خادم MCP مجموعة من الأدوات عبر وسيلة نقل قياسية، ويمكن لأي وكيل يدعم MCP استخدامها من دون طبقة ربط مخصصة. خادم نظام الملفات المرجعي هو أمر واحد:

npx -y @modelcontextprotocol/server-filesystem /home/you/projects

يتطلب ذلك تثبيت Node، وتكون وسيطة الدليل هي المسار الوحيد الذي سيتعامل معه الخادم. هذا هو نموذج الأمان في أبسط صورة: يحدد الخادم النطاق، وليس النموذج. وجّه عميلاً إليه، وسيحصل وكيلك على إمكانات قراءة الملفات وكتابتها من دون أن تكتبها بنفسك. يشرح تشغيل خوادم MCP على VPS لوكلاء البرمجة بالذكاء الاصطناعي طريقة تشغيل هذه الخوادم بصورة صحيحة، ضمن حساب خدمة ومع توضيح خيارات وسيلة النقل. وللحصول على خادم ثانٍ يتصل ببيانات فعلية بدلاً من دليل مؤقت، يوفّر الاستضافة الذاتية لـ openGym، متتبع التمارين خادماً للقراءة فقط، حتى تتمكن من التدرب على طرح أسئلة حول سجل تمارينك من دون منح الوكيل أي صلاحية يمكنه استخدامها لإتلاف شيء.

خلاصة هذه المرحلة هي أن تصميم الأدوات هو العمل الحقيقي. الوصف الغامض يجعل النموذج يخمّن. والأداة التي تعيد 40000 حرف تفسد نافذة السياق. والأداة التي تستطيع حذف الأشياء ستحذف الأشياء في النهاية.

المرحلة 4: الذاكرة، وهي في معظمها مجرد ملفات

يلجأ المبتدئون هنا إلى قاعدة بيانات متجهات. لا تفعل ذلك، على الأقل ليس بعد.

لا يملك الوكيل ذاكرة بين الاستدعاءات. أنت تعيد إرسال المحادثة كاملة في كل مرة، ولذلك تكلّف الجلسة الطويلة أكثر في كل دور من الجلسة القصيرة. لذلك تنقسم الذاكرة إلى مشكلتين. الأولى هي ما يتسع له context window الآن. تدير ذلك من خلال التلخيص، وحذف مخرجات الأدوات القديمة، وتخزين البادئة المستقرة من prompt مؤقتاً، بحيث تدفع جزءاً من التكلفة فقط مقابلها. والثانية هي ما يبقى بعد إعادة التشغيل، وهذا هو التخزين.

بالنسبة إلى المشكلة الثانية، يتفوق ملف Markdown عادي يستطيع الوكيل قراءته وكتابته على قاعدة بيانات متجهات في كل مشروع أول تقريباً. امنحه ملفاً واحداً، وحدد له التنسيق، واطلب منه قراءة الملف قبل البدء وتحديثه عندما يتعلم شيئاً جديداً. ستحصل على معظم الفائدة، ويمكنك فتح الملف ومعرفة ما يعتقده وكيلك. استخدم embeddings وعمليات retrieval عندما تتوقف الملاحظات عن التوافق مع context window، وليس قبل ذلك.

المرحلة 5: الحلقة هي المنتج

يمكنك الآن إنشاء وكيل يعمل أثناء مراقبتك له. تتمثل المرحلة 5 في جعله يعمل عندما لا تكون موجوداً.

تحدد أربعة أسئلة ما إذا كان من الآمن ترك وكيل غير مُراقَب يعمل بمفرده. ما الذي يشغّله، حتى لا يعمل دون سبب؟ ما الحدود التي يعمل داخلها، حتى يظل أثر الخطأ محدوداً؟ كيف تتحقق من النتيجة، لأن الوكيل الذي يصحح واجبه بنفسه ينجح دائماً؟ وما الميزانية التي توقفه، سواء بعدد الرموز أو بمدة زمنية فعلية؟ إن تصميم هذه العناصر الأربعة عمداً هو المنهج الموصوف في هندسة الحلقات وما يشمله هذا التعريف.

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

المرحلة 6: السلامة والأسرار والتكلفة

هذه المرحلة ليست اختيارية، وهي الأخيرة فقط لأنك لا تستطيع تقدير الخطر قبل أن تبني شيئاً يعمل.

شغّل الوكيل باستخدام مستخدم غير مميّز خاص به، وليس باستخدام root أو حسابك الشخصي، حتى يقتصر نطاق الضرر على دليل بدلاً من الجهاز بأكمله. أبقِ بيانات الاعتماد خارج متناول النموذج، لأن أي شيء موجود في نافذة السياق يمكن إخراجه حرفياً عبر استدعاء أداة. والحل هو استخدام رموز قصيرة العمر ومحدودة النطاق خلف أداة مساعدة، كما هو موضح في إبعاد الأسرار عن وكلاء AI لديك. ضع حداً أقصى صارماً للإنفاق، لأن الحلقة التي تعمل دون مراقبة تحاسبك على كل تكرار، بينما توضّح التحكم في تكلفة وكيل AI على VPS يعمل دائماً الحدود والتجميع اللذين يحافظان على استقرار التكلفة.

إذا كان وكيلك يعمل داخل harness بدلاً من script كتبته بنفسك، فبعض هذه المرحلة يكون إعداداً لا code. وتغطي إضافات DeepSeek Harness التي تستحق التثبيت جزءاً كبيراً من المتطلبات نفسها، مثل حدود الميزانية، وقواعد صلاحيات الأدوات، وفحص الحقن.

تستحق التكلفة رقماً محدداً. اعتباراً من July 2026، يفرض Claude Opus 5 مبلغ $5 لكل مليون token للإدخال و$25 لكل مليون token للإخراج. ويمكن لوكيل كثير الرسائل يعيد إرسال محادثة متزايدة أن يمرر بضع مئات الآلاف من token خلال مهمة واحدة. ويغيّر التخزين المؤقت للمطالبات، إلى جانب استخدام نموذج أصغر للخطوات الروتينية، هذه الحسابات بدرجة أكبر بكثير من أي تعديل على prompt.

يندرج حقن prompt هنا أيضاً. إذا كان وكيلك يقرأ صفحة ويب، أو متعقب مشكلات، أو صندوق وارد، فإن كاتب ذلك النص يكتب أيضاً تعليمات إلى وكيلك. يكون بحث الويب عادةً الأداة التي تفتح هذا الباب أولاً، وتوضح توجيه وكيل إلى مثيل SearXNG الخاص بك طريقة الربط وسطح الحقن الذي ينشئه كل منهما جنباً إلى جنب. لا يتمثل الدفاع في كتابة system prompt أكثر تعقيداً. بل يتمثل في الحدود، لأن الوكيل الذي لا يستطيع حذف مستودع لا يمكن إقناعه بحذفه.

ما المسار الذي ينبغي أن تتبعه؟

اختر منهجاً واحداً وأكمله بدلاً من تصفح ستة مناهج. يُعد مستودع Microsoft ai-agents-for-beginners الأكثر اكتمالاً من بين المناهج المجانية؛ فهو دورة مؤلفة من ثمانية عشر درساً وقد تجاوزت 70,000 نجمة حتى July 2026، كما أنه يتوافق بوضوح مع المراحل المذكورة أعلاه. تفيد قوائم مستودعات الوكلاء الرائجة في معرفة المشاريع المتاحة، لكنها أقل فائدة بكثير بوصفها منهجاً دراسياً، لأن القائمة المرتبة حسب عدد النجوم تكون مرتبة حسب الشعبية لا حسب ترتيب التعليم.

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

كم يستغرق ذلك؟

بالنسبة إلى من يبرمج مسبقاً، يستغرق المرحلتان 1 و2 أمسية واحدة. وتستغرق المرحلة 3 عطلة نهاية أسبوع، يُخصَّص معظمها لوصف الأدوات لا للبروتوكول. أما المرحلتان 4 و5 فتستغرقان بضعة أسابيع من الاستخدام الفعلي، لأنك لا تعرف ما ينساه وكيلك إلا بمراقبته وهو ينسى. ولا تنتهي المرحلة 6 تماماً، لأن كل قدرة جديدة تمنحها للوكيل تعيد فتحها.

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

FAQ

هل أحتاج إلى معرفة تعلّم الآلة لبناء وكيل ذكاء اصطناعي؟

لا. يعني بناء وكيل استدعاء نموذج عبر API وربط طلباته إلى الأدوات بدوال فعلية، وهذا من برمجة التطبيقات المعتادة. لن تتعامل مع التدريب أو المشتقات أو مجموعات البيانات. المهارات التي تحدد نجاح وكيلك هي تصميم مخططات الأدوات، ومعالجة الأخطاء، وصلاحيات Linux. تصبح نظرية تعلّم الآلة مهمة فقط إذا تابعت لتخصيص نموذج بالتدريب، وهي مهمة مختلفة تتطلب متطلبات مختلفة.

هل أبدأ باستخدام إطار عمل مثل LangChain أو CrewAI؟

اكتب حلقة خام واحدة أولاً، ثم استخدم إطار عمل. يستبدل إطار العمل الأسطر الثلاثين في المرحلة 2 بكائن إعدادات، وهذا مريح عندما تعرف ما الذي استُبدل، لكنه مربك قبل ذلك. عندما يتصرف وكيلك بطريقة غير صحيحة، يجب أن تحلل قائمة الرسائل ونتائج الأدوات مباشرة، ويصبح ذلك أصعب بكثير إذا لم ترها من قبل. بعد كتابة حلقة واحدة بنفسك، سيوفر لك إطار العمل الوقت بدلاً من إخفاء الآلية.

كم تبلغ تكلفة تعلّم وكلاء الذكاء الاصطناعي؟

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

ما الفرق بين وكيل ذكاء اصطناعي وروبوت محادثة؟

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