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

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

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

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

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

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

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

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

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

ما يستهين به الناس هو جانب shell. تفشل الوكلاء بسبب الصلاحيات، والمسارات، ومتغيرات البيئة، والعمليات التي تتوقف بصمت. إذا كان تتبع مكدس يتعلق بـ PATH أو بوضع ملف يجعلك تغلق الطرفية، فاقضِ عطلة نهاية أسبوع في تعلّم أساسيات Linux أولاً. سيوفّر عليك ذلك شهراً كاملاً لاحقاً.

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

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

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

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

المرحلة 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 لوكلاء برمجة الذكاء الاصطناعي كيفية تشغيل هذه الخوادم بطريقة صحيحة، باستخدام حساب خدمة ومع توضيح خيارات النقل.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FAQ

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

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

هل ينبغي أن أبدأ بإطار عمل مثل LangChain أو CrewAI؟

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

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

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

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

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