كيف تبدأ ببناء وكيل ذكاء اصطناعي؟
أفضل بداية لفهم AI Agents هي بناء مثال صغير وتجربته بنفسك.
في هذا الدرس سننشئ وكيل ذكاء اصطناعي باستخدام n8n يستقبل رسالتك، ويستخدم أداة الآلة الحاسبة عندما يحتاج إلى إجراء عملية حسابية، ثم يعرض النتيجة بوضوح.
مثلًا، تسأله:
عندي 8 منتجات، سعر الواحد 15 دينارًا، وتكلفة التوصيل 5 دنانير. كم المجموع؟
المطلوب أن يستخدم أداة الحساب، ثم يخبرك أن المجموع 125 دينارًا.
المشروع بسيط، لكنه يوضح فكرة مهمة: كيف يفهم الوكيل طلبًا ويستعين بأداة لإنجازه.
ما هو وكيل الذكاء الاصطناعي؟
وكيل الذكاء الاصطناعي، أو AI Agent، يستخدم نموذجًا لفهم الطلب، ويمكنه اختيار أدوات متاحة وتنفيذها للمساعدة في الوصول إلى النتيجة.
في مشروعنا، تتوزع الأدوار كالتالي:
المحادثة: تستقبل سؤالك.
نموذج الذكاء الاصطناعي: يفهم المطلوب.
أداة Calculator: تنفذ الحساب.
الوكيل: ينظم استخدام الأداة ويصيغ الإجابة.
توفر n8n أداة Calculator مخصصة لتمكين الوكيل من إجراء العمليات الحسابية. docs.n8n.io
الخطوة الأولى: جهّز ما تحتاجه
ستحتاج إلى بيئة n8n جاهزة، وحساب لدى مزوّد نموذج ذكاء اصطناعي مع بيانات الاتصال اللازمة.
سنستخدم في هذا المثال OpenAI Chat Model عبر مفتاح API. راجع تكلفة استخدام الخدمة قبل التجربة، واحفظ المفتاح داخل Credentials، وليس في نص التعليمات أو صور المشروع.
لا تحتاج إلى كتابة كود لهذا المثال. وقد تختلف أسماء بعض الخيارات قليلًا بحسب إصدار n8n.
الخطوة الثانية: أنشئ المحادثة
افتح Workflow جديدًا، وسمّه مثلًا My First AI Agent.
ثم:
أضف عقدة Chat Trigger.
أضف عقدة AI Agent.
صِل مخرج Chat Trigger بمدخل AI Agent.
داخل AI Agent، اجعل Source for Prompt (User Message) على Connected Chat Trigger Node.
بهذا تصل الرسالة المكتوبة في المحادثة إلى الوكيل. هذا الربط موضح أيضًا في دليل n8n لبناء أول AI Agent. n8n Blog
الخطوة الثالثة: اربط نموذج الذكاء الاصطناعي
من موصل Chat Model أسفل AI Agent:
اضغط علامة الإضافة.
اختر OpenAI Chat Model.
في خانة بيانات الاتصال، اختر إنشاء Credential جديد.
ضع مفتاح API واحفظ بيانات الاتصال.
اختر نموذجًا متاحًا لحسابك ويدعم استخدام الأدوات.
لإنشاء المفتاح، افتح صفحة API Keys، واختر Create new secret key، ثم انسخه إلى حقل API Key في n8n. docs.n8n.io
تُحمّل n8n قائمة النماذج المتاحة لحسابك؛ لذلك قد تختلف الخيارات الظاهرة من حساب إلى آخر. docs.n8n.io
الخطوة الرابعة: أضف أداة Calculator
من موصل Tool أسفل AI Agent:
اضغط علامة الإضافة.
ابحث عن Calculator.
أضف الأداة وتأكد من اتصالها بالوكيل.
أصبحت لديك الآن أربعة مكونات:
Chat Trigger لاستقبال الرسالة.
AI Agent لإدارة الطلب.
Chat Model لفهمه وصياغة الرد.
Calculator لتنفيذ الحساب.
اتصال النموذج يكون بموصل Chat Model، واتصال الآلة الحاسبة بموصل Tool.
الخطوة الخامسة: اكتب تعليمات الوكيل
داخل AI Agent، افتح Options وأضف System Message إذا لم يكن ظاهرًا.
انسخ التعليمات التالية:
أنت مساعد يجيب باللغة العربية بطريقة واضحة ومختصرة.
عند وجود أي عملية حسابية في طلب المستخدم، استخدم أداة Calculator، ثم اشرح النتيجة بجملة بسيطة.
إذا كانت المعلومات اللازمة للحساب ناقصة، اطلب توضيحها ولا تفترض أرقامًا من عندك.
إذا كان السؤال لا يحتاج إلى حساب، أجب مباشرة دون استخدام الآلة الحاسبة.
لا تدّعِ استخدام الأداة إذا لم تُستخدم، وإذا فشلت فأخبر المستخدم بتعذر إكمال الحساب.
هذه التعليمات تحدد متى يستخدم الوكيل الأداة، وكيف يتعامل مع الطلبات غير المكتملة.
الخطوة السادسة: جرّب وكيلك
احفظ Workflow، ثم افتح نافذة الاختبار عبر Open Chat.
ابدأ بهذه الرسالة:
عندي 8 منتجات، سعر الواحد 15 دينارًا، وتكلفة التوصيل 5 دنانير. استخدم الآلة الحاسبة واحسب المجموع.
النتيجة المتوقعة:
تكلفة المنتجات 120 دينارًا، ومع التوصيل يصبح المجموع 125 دينارًا.
بعد ظهور الرد، افتح تفاصيل التنفيذ وافحص أداة Calculator. تأكد من أنها استُدعيت، وراجع العملية الحسابية والنتيجة.
الإجابة الصحيحة وحدها لا تثبت أن الأداة استُخدمت. هدف التجربة هو مشاهدة استدعائها فعلًا.
جرّب سؤالًا آخر
أدرس 45 دقيقة يوميًا لمدة 6 أيام. كم مجموع دقائق الدراسة؟
النتيجة المتوقعة: 270 دقيقة.
جرّب طلبًا ناقصًا
بدي أشتري 4 دفاتر. كم المجموع؟
يجب أن يسأل الوكيل عن سعر الدفتر بدل اختيار سعر من عنده.
في هذه النسخة لم نضف ذاكرة للمحادثة؛ لذلك عند إعادة المحاولة، اكتب الطلب كاملًا، مثل:
بدي أشتري 4 دفاتر، سعر الدفتر ديناران. كم المجموع؟
النتيجة المتوقعة: 8 دنانير.
إذا لم تعمل التجربة، ماذا تراجع؟
ظهرت مشكلة في الاتصال بالنموذج
راجع بيانات الاتصال، وصلاحية المفتاح، وإمكانية استخدام النموذج من حسابك.
الوكيل لا يستقبل رسالتك
تأكد من توصيل Chat Trigger بالوكيل، واختيار Connected Chat Trigger Node كمصدر للرسالة.
الوكيل يجيب دون استخدام Calculator
راجع اتصال الأداة بموصل Tool، وتعليمات استخدامها، ثم أعد الاختبار بطلب حسابي واضح.
الوكيل لا يتذكر الرسالة السابقة
هذا متوقع في نسختنا البسيطة. اكتب كل طلب بمعلوماته كاملة؛ يمكنك إضافة الذاكرة لاحقًا.
مصادر تساعدك على التطبيق
شرح فيديو
شرح Chat Trigger والذاكرة وتعليمات AI Agent على YouTube
شاهد الأجزاء الخاصة بالمحادثة والتعليمات. الذاكرة توسّع إضافي لا نحتاجه في هذا المثال.
دليل عملي
مرجع يساعدك على فهم ربط مكونات الوكيل وإعداد مصدر الرسالة. n8n Blog
مرجع أداة الحساب
يوضح دور الأداة في تنفيذ الحسابات داخل الوكيل. docs.n8n.io
تحدٍّ صغير قبل أن تنهي المشروع
جرّب ثلاثة طلبات من عندك:
حساب مجموع مشتريات.
حساب ساعات تدريب خلال أسبوع.
سؤال تنقصه معلومة ضرورية.
راجع في كل تجربة: هل فهم الوكيل المطلوب؟ هل استخدم الأداة عند الحاجة؟ وهل طلب توضيحًا عندما نقصت المعلومات؟
نصيحة من Qafza Library
ابدأ بوكيل يؤدي مهمة واحدة وتستطيع التحقق من نتيجتها. عندما تنجح في ربط الطلب بالأداة والنتيجة، تصبح لديك قاعدة عملية لتجربة أدوات ومشاريع أكبر.