استخدام n8n Assistant

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

صف ما تريد أتمتته. يستطيع n8n Assistant التخطيط لسير العمل، وبناءه في المشروع الذي اخترته، واختباره، ومساعدتك في إصلاح الأخطاء.

والنتيجة سير عمل عادي في n8n. يمكنك فتحه وفحصه وتعديله واختباره ونشره كأي سير عمل آخر.

فيمَ يستطيع n8n Assistant مساعدتك

تتفاعل مع n8n Assistant عبر محادثة. ويمكنه استخدام أدوات داخل n8n لمساعدتك في إنشاء سير العمل وتصحيح أخطائه.

يمكنك أن تطلب من n8n Assistant أن:

• ينشئ سير عمل: صف الأتمتة التي تريدها، ويمكن لـ n8n Assistant توليد سير عمل لها.
• يبني agents: صف الـ agent الذي تريده، ويمكن لـ n8n Assistant اقتراح تعليمات وأدوات ومهارات (skills) لإضافتها. تعمل الـ Agents أيضًا في الاستضافة الذاتية مع الوحدة agents. راجع بناء الـ Agents وإدارتها وتفعيل الـ Agents.
• يربط سيرفرات MCP: اربط سيرفرًا من سجل سيرفرات MCP مباشرة بالمساعد، لتنفيذ المهام ولجمع السياق أثناء بنائه سير العمل لك.
• يعدّل سير العمل: اطلب منه تغيير سير عمل، أو إضافة نودات، أو تحديث المنطق، أو تعديل الإعدادات.
• يختبر سير العمل ويصلح أخطاءه: اطلب منه إجراء فحوصات، وفحص الأخطاء ذات الصلة، واقتراح إصلاحات.
• يساعد في الـ Credentials: يطلب منك اختيار credential موجودة أو إنشاء واحدة جديدة، دون أن تلصق الأسرار في المحادثة.
• يستخدم موارد n8n: ينشئ أو يحدّث موارد داعمة مثل جداول البيانات (Data Tables) عند الحاجة.
• يبحث في مواقع معتمدة: عند تفعيل الوصول إلى الويب، يطلب n8n Assistant إذنك قبل الوصول إلى أي نطاق (domain).

قبل أن تبدأ

لاستخدام n8n Assistant، تحتاج إلى الوصول إلى نسخة n8n مفعّلة فيها الميزة.

تأكد من أن:

• لديك صلاحية الوصول إلى المشروع الذي تريد أن يعمل فيه n8n Assistant.
• لديك صلاحية استخدام سير العمل والـ credentials والموارد اللازمة للمهمة.
• تعرف ما الذي تريد أن يفعله سير العمل.

يستخدم n8n Assistant صلاحيات مستخدم n8n الخاص بك. ولا يمكنه الوصول إلا إلى سير العمل والـ credentials والموارد التي يمكنك الوصول إليها في المشروع المحدد.

كتابة طلبات (Prompts) فعّالة

تساعد الطلبات المحددة n8n Assistant على إنتاج نتائج أفضل بتكرارات أقل.

عند كتابة الطلب، اذكر:

• ما الذي يجب أن يشغّل سير العمل،
• أي تطبيقات أو خدمات يجب أن يستخدمها سير العمل،
• أي بيانات يجب أن يقرأها سير العمل أو يرسلها أو يحدّثها،
• ما الذي يجب أن يحدث عند نجاح سير العمل،
• ما الذي يجب أن يحدث عند فشل سير العمل،
• هل يجب أن يسألك n8n Assistant قبل نشر سير العمل.

أمثلة على الطلبات

إنشاء سير عمل

Create a workflow that checks Gmail every morning for invoices,
saves PDF attachments to Google Drive, and adds a row to a Data Table.
Ask me before publishing the workflow.

تصحيح تنفيذ فاشل

Debug the latest failed execution of this workflow.
Explain what failed, then suggest a fix before changing anything.

تحديث سير عمل موجود

Update this workflow so failed orders are sent to Slack,
then retry the API request after 10 minutes.

مراجعة التغييرات المُنشأة بالذكاء الاصطناعي

يستطيع n8n Assistant تنفيذ إجراءات داخل نسخة n8n لديك، لكنك تبقى أنت المتحكم.

قبل استخدام سير عمل أنشأه الذكاء الاصطناعي في الإنتاج:

• راجع منطق سير العمل.
• افحص إعدادات النودات والـ credentials.
• اختبر سير العمل ببيانات الإدخال المتوقعة.
• افحص نتائج التنفيذ ومعالجة الأخطاء.
• تأكد من أن سير العمل لا ينفّذ إجراءات غير مقصودة.

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

التعامل مع الـ Credentials

أسرار الـ credentials لديك لا تُرسل أبدًا إلى الذكاء الاصطناعي، ولا يراها إطلاقًا.

يستطيع n8n Assistant قراءة أوصاف الـ credentials بدءًا من n8n 2.41.0. وبدءًا من n8n 2.42.0، لا يقرأ n8n Assistant الأوصاف إلا إذا فعّلت نسختك أوصاف الـ credentials.

يستخدم n8n Assistant أوصاف الـ credentials المتاحة لمساعدته على الاختيار بين credentials من النوع نفسه. فمثلًا، قد يحدد الوصف حسابًا للإنتاج أو حسابًا للاختبار. وإذا ظل الاختيار غير واضح، يسألك n8n Assistant أي credential يستخدم.

يمكن للذكاء الاصطناعي استلام أوصاف الـ credentials. لا تضع فيها مفاتيح API أو كلمات مرور أو رموز (tokens).

عندما يحتاج سير العمل إلى credentials، يعرض لك n8n Assistant بطاقة credential في المحادثة. ومن هذه البطاقة يمكنك:

• اختيار credential موجودة لديك صلاحية الوصول إليها في المشروع.
• إنشاء credential جديدة.

إذا أنشأت credential جديدة، فتُدخل السر في شاشة الـ credentials المعتادة في n8n، لا في المحادثة. لا تلصق مفاتيح API أو كلمات المرور أو الرموز في المحادثة.

الوصول إلى الويب

عند تفعيل الوصول إلى الويب، يطلب n8n Assistant إذنك قبل الوصول إلى أي نطاق خارجي.

راجع النطاق المطلوب قبل أن توافق على الوصول.

قيود النسخة التجريبية (Preview)

n8n Assistant ميزة في مرحلة Preview. قد يتغيّر توافرها والإجراءات المدعومة وسلوكها.

أثناء مرحلة Preview:

• قد لا يدعم n8n Assistant بعض الإجراءات بعد.
• قد تُطرح بعض الإمكانيات تدريجيًا.
• قد يطلب n8n Assistant توضيحات أكثر من المتوقع.
• قد يحتاج سير العمل المُنشأ إلى مراجعة وتصحيح يدويين.
• قد تتغير الواجهة واستهلاك الأرصدة والموارد المدعومة.

البيانات والخصوصية

يعالج n8n Assistant المعلومات التي يحتاجها لمساعدتك في بناء سير العمل وإصلاح أخطائه.

بحسب المهمة، قد يشمل ذلك:

• طلباتك ورسائل المحادثة،
• بنية سير العمل وإعدادات النودات،
• تفاصيل مختارة عن التنفيذ والأخطاء تُستخدم في إصلاح الأخطاء،
• أسماء الـ credentials وأنواعها وأوصافها أو حالة الاتصال،
• صفحات أو نطاقات ويب معتمدة، عند تفعيل الوصول إلى الويب.

لا يتطلب n8n Assistant أن تلصق الأسرار في المحادثة. أدخل مفاتيح API وكلمات المرور والرموز عبر شاشات الـ credentials المعتادة في n8n.

استهلاك الأرصدة

في n8n Cloud، يستخدم n8n Assistant رصيد Assistant، بحسب الـ tokens التي يعالجها نموذج الذكاء الاصطناعي الأساسي. تتضمن خطتك حصة شهرية من رصيد Assistant تُعاد في أول يوم من كل شهر. وإذا استهلكتها، يستطيع مالك النسخة شراء رصيد إضافي لمواصلة استخدام n8n Assistant حتى موعد إعادة التعيين التالي. ويشترك جميع من على النسخة في رصيد واحد.

رصيد Assistant ورصيد Gateway منفصلان. يغطي رصيد Assistant محادثاتك مع n8n Assistant، لا نماذج الذكاء الاصطناعي التي تستدعيها سير العمل أو الـ agents أثناء تشغيلها. أما رصيد Gateway فيغطي استدعاءات النماذج هذه، لا n8n Assistant. وشحن أحدهما لا يزيد الآخر.

المحادثات الأطول وسير العمل الأكبر وجلسات التصحيح والتكرارات المتعاقبة تستهلك رصيدًا أكثر.

لتقليل الاستهلاك غير الضروري:

• كن محددًا بشأن هدف سير العمل وقيوده.
• ابدأ محادثة جديدة للمهام غير المرتبطة.
• راجع خطة n8n Assistant قبل أن تطلب منه البناء.
• تجنّب طلب إعادة توليد سير العمل نفسه دون إضافة توجيهات جديدة.

لمعرفة رصيدك، افتح قائمة الرصيد في لوحة n8n Assistant. ولمعرفة الحصة الشهرية لخطتك، راجع خطط n8n وأسعارها.

لا تستخدم n8n المستضافة ذاتيًا رصيد Assistant. في النسخة المستضافة ذاتيًا، يعمل n8n Assistant على حساب مزوّد الذكاء الاصطناعي الخاص بك. راجع إعداد n8n Assistant.

مصادر ذات صلة

• طرق بناء سير العمل
• استخدام سيرفر MCP الخاص بـ n8n
• استخدام القوالب (Templates)
• استخدام Ask n8n AI
• استخدام Chat Hub