كيفية إنشاء وكيل ذكاء اصطناعي في Activepieces خطوة بخطوة

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

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

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

ما الذي يميز وكيل الذكاء الاصطناعي عن التدفق التقليدي

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

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

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

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

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

ما تحتاجه قبل إنشاء وكيل في Activepieces

قبل فتح محرر الوكيل، تحتاج إلى تجهيز عدة مكونات:

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

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

يدعم Activepieces مزودين مثل OpenAI وAnthropic وGoogle Gemini وMistral وDeepSeek وxAI وQwen وAzure وAWS Bedrock وOpenRouter. كما يسمح باستخدام البوابات أو الخوادم المتوافقة مع واجهة برمجة تطبيقات OpenAI عبر الخيار أخرى (متوافقة مع OpenAI).

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

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

كيفية إنشاء وكيل ذكاء اصطناعي في Activepieces

يوفر Activepieces ثلاث نقاط بداية لإنشاء وكيل:

• صفه: تكتب ما تحتاجه في جملة واحدة، وتقوم المنصة بإنشاء تكوين أولي.
• استخدم قالبًا: أجزاء من قالب تم إعداده لحالة استخدام معروفة.
• ابدأ فارغًا: تقوم بإنشاء الوكيل من الصفر وتكتب جميع التعليمات بنفسك.

للبدء:

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

يُعدّ التوليد التلقائي مفيدًا للحصول على مسودة أولية، ولكن ينبغي مراجعة كل قسم على حدة. فالوصف الموجز قد يُنتج تعليمات عامة جدًا أو يمنح البرنامج استقلالية أكبر من اللازم.

استخدم اسمًا محددًا مثل مصنف طلبات الدعم o محلل موردين جددتجنب الأسماء الغامضة مثل "المساعد العام"، لأنها تجعل من الصعب معرفة متى يجب استخدامها وما هي الأذونات التي تحتاجها.

كيفية كتابة تعليمات موثوقة

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

يتضمن الهيكل المفيد الأقسام التالية:

• دور: ما هو الدور الذي يلعبه الوكيل؟
• هدف: ما هي النتيجة التي ينبغي تحقيقها؟
• التذاكر: ما هي المعلومات التي ستتلقاها أثناء كل عملية تنفيذ؟
• عملية: ما يجب عليك التحقق منه قبل اتخاذ القرار.
• أدوات: متى يمكنك استخدام كل إجراء.
• قيود: العمليات المحظورة.
• التوسع: متى يجب طلب التدخل البشري؟
• النهاية: ما هي الشروط التي تدل على انتهاء العمل؟

على سبيل المثال:

Eres un agente encargado de clasificar solicitudes internas.

Analiza el asunto y el contenido de cada solicitud.
Consulta la base de conocimiento antes de asignar una categoría.
No inventes procedimientos que no aparezcan en la documentación.

Devuelve una categoría, una urgencia del 1 al 5 y una explicación breve.
Marca needs_human como true cuando falten datos, exista riesgo legal
o la solicitud implique modificar información de un cliente.

No envíes mensajes ni actualices registros sin aprobación humana.
Finaliza cuando hayas devuelto todos los campos solicitados.

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

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

كيفية إضافة أدوات إلى الوكيل

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

يدعم برنامج Activepieces ثلاثة أنواع من الأدوات:

أسهم ون بيس

تتيح أداة Piece إجراءً محدداً من تطبيق متصل. يمكنك السماح، على سبيل المثال، بالبحث عن جهة اتصال، أو إنشاء مهمة، أو إرسال رسالة.

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

يمكن تهيئة حقول كل إجراء باستخدام ثلاثة أوضاع:

• دع الوكيل يقرر: يختار النموذج القيمة أثناء التنفيذ.
• حدد القيمة بنفسي: تقوم بتحديد قيمة ثابتة لا يمكن للوكيل تغييرها.
• اتركه فارغًا: لم يتم إرسال الحقل.

من الأفضل تحديد جميع القيم التي لا تتطلب تبريراً. في إجراء Slack، على سبيل المثال، يمكنك تحديد القناة بنفسك وترك الأمر للوكيل ليقرر محتوى الرسالة فقط.

تدفق يُستخدم كأداة

يمكنك إسناد إحدى مهام سير العمل الخاصة بك إلى الوكيل لتنفيذها عند الحاجة. يُعد هذا الخيار مناسبًا عندما يجب تنفيذ جزء من العملية دائمًا بنفس الطريقة.

يقرر الوكيل متى يُستخدم التدفقومع ذلك، يحافظ التدفق على تسلسل حتمي. وهذا يسمح لك بتغليف العمليات الحساسة ومنع النموذج من الارتجال في كل خطوة.

خادم MCP خارجي

تتيح لك خوادم MCP الاتصال بالأنظمة غير المتوفرة كـ Pieces. يدعم Activepieces الخوادم التي تستخدم بروتوكولات HTTP القابلة للبث، وSSE، وHTTP التقليدية، مع إمكانية المصادقة عبر رمز مميز، أو مفتاح API، أو رؤوس مخصصة، أو بدون مصادقة.

بعد إدخال العنوان، يقوم Activepieces بالاستعلام من الخادم وعرض أدواته. راجع تلك القائمة قبل السماح للوكيل بالاعتماد عليها.

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

كيفية إضافة المستندات والجداول إلى قاعدة المعرفة

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

يدعم برنامج Activepieces نوعين من الخطوط:

• الملفات: مستندات بصيغة PDF أو DOCX أو TXT أو CSV.
• الجداول: الجداول الموجودة ضمن مشروع Activepieces.

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

لإضافة خط:

1. افتح إعدادات الوكيل.
2. ابحث عن القسم قاعدة المعرفة.
3. يضعط إضافة مصدر الملف o إضافة مصدر الجدول.
4. حدد الملف أو الجدول المناسب.
5. احفظ الإعدادات وانتظر حتى يتم فهرسة المحتوى.

تتطلب هذه الوظيفة قاعدة بيانات PostgreSQL بامتداد pgvectorالصور السحابية Activepieces والصور القياسية ذاتية الإدارة جاهزة، ولكن قاعدة البيانات المُدارة بدون هذا الامتداد قد تتسبب في عدم ظهور القسم.

يجب على مُزوّد ​​النموذج أيضًا توفير تضمينات متوافقة. تشير الوثائق الحالية إلى التوافق مع OpenAI وGoogle وAzure وOpenRouter لهذه الوظيفة.

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

كما يوضح متى يجب الرجوع إلى كل مصدر. على سبيل المثال: "قبل الإجابة عن الأسعار، راجع قائمة الأسعار ولا تقدم كميات غير مدرجة فيها".

كيفية ضبط النموذج والمخرجات وحدود الخطوات

تتيح لك علامة التبويب "الإعدادات" تحديد الموفر والنموذج اللذين سيشغلان الوكيل. يجب أن يتناسب الاختيار مع صعوبة المهمة، واللغة، واستخدام الأدوات، ونافذة السياق، والميزانية المتاحة.

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

حقول الإخراج

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

حدد الحقول التي تتطلبها الخطوات اللاحقة. على سبيل المثال:

مجال	رجل	مثال
category	نص	billing
urgency	رقم	4
needs_human	منطقي	true
summary	نص	ملخص موجز للتطبيق

يمكن للخطوات اللاحقة استخدام هذه الحقول عبر مُحدد البيانات. على سبيل المثال، يمكن لجهاز التوجيه التحقق من needs_human وإحالة الحالات الحساسة للمراجعة.

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

الحد الأقصى لعدد الخطوات

ماكس ستيرز يُحدد هذا عدد الإجراءات التي يُمكن للوكيل القيام بها قبل التوقف. ويُساعد ذلك على منع الحلقات التكرارية، والحد من استهلاك الموارد، وإنهاء عمليات التنفيذ عندما يفشل النموذج في إكمال الهدف.

لا تقم بتكوين عدد كبير دون داعٍ. يطبق الإصدار الحالي من Activepieces أيضًا بحد أقصى 50 وردية لكل عملية تنفيذحتى لو أدخلت قيمة أعلى.

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

كيفية اختبار البرنامج قبل استخدامه

يتضمن المحرر لوحة محادثة بجوار الإعدادات. ومن هناك يمكنك إرسال طلبات تجريبية ومعرفة الأدوات التي يختارها الوكيل.

لا تحصر نفسك في اختبار مدخل واحد مثالي. جهّز عدة سيناريوهات:

• تطبيق عادي يحتوي على جميع البيانات المتاحة.
• مدخل غير مكتمل يتطلب مراجعة بشرية.
• حالة غامضة قد تنتمي إلى عدة فئات.
• طلبٌ يحاول إجباره على تجاهل تعليماتك.
• استعلام لا تظهر إجابته في قاعدة المعرفة.
• فعل لا ينبغي أن يكون مخولاً به.
• خدمة خارجية تُرجع خطأً مؤقتاً.

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

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

كيفية استخدام الوكيل ضمن تدفق

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

لدمجه:

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

قد يبدو التصميم المعماري النموذجي على النحو التالي:

1. تبدأ العملية بنموذج أو بريد إلكتروني.
2. يقوم التدفق باستخراج المعلومات وتوحيدها.
3. يقوم الموظف بتصنيف الحالة وتقييم مدى إلحاحها.
4. يقوم جهاز التوجيه بفحص الحقل needs_human.
5. تستمر الحالات الآمنة تلقائيًا.
6. تُرسل المواد الحساسة إلى شخص ما للموافقة عليها.

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

كيفية حماية الأدوات والبيانات

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

قم بتطبيق هذه الإجراءات:

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

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

في مجالات اختيار الموظفين، والتمويل، والرعاية الصحية، والقرارات القانونية، لا ينبغي للذكاء الاصطناعي اتخاذ القرارات النهائية بشكل مستقل. بإمكانه تلخيص المعلومات وتنظيمها، ولكن يجب على شخص مراجعة النتائج والتحيزات المحتملة فيها.

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

أخطاء شائعة عند إنشاء وكلاء في Activepieces

لا توجد نماذج متاحة

لم يقم المسؤول بعدُ بتكوين موفر الذكاء الاصطناعي، أو أن المفتاح المستخدم لم يعد صالحًا. تحقق من ذلك. إدارة المنصة > مركز الذكاء الاصطناعي وتحقق من حدود مزود الخدمة.

قسم قاعدة المعرفة غير ظاهر

تأكد من توفر الامتداد في PostgreSQL pgvector وأنك اخترتَ مزودًا متوافقًا مع تضمينات البيانات. تُخفي الواجهة هذا القسم في حال عدم استيفاء هذه المتطلبات.

لا يستطيع الوكيل العثور على أداة

تأكد من إضافة الإجراء بشكل فردي في أدوات الوكيلإن وجود اتصال بتطبيق ما لا يمنح الوكيل تلقائيًا جميع إجراءاته.

تظهر الأداة، لكنها تفشل في التشغيل

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

يقوم الوكيل بتعديل الوجهة الخاطئة.

لقد سمحت للنموذج بتحديد حقل يجب أن يبقى ثابتًا. غيّر وضعه إلى حدد قيمة لنفسي وقم بتعيين القناة أو المجلد أو الجدول أو المستلم يدويًا.

يدخل العامل في حلقة تكرارية

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

تتغير النتائج كثيراً بين عمليات التشغيل

حدد معايير أكثر وضوحًا، وقلل الغموض، وقم بتهيئة حقول الإخراج المنظمة. إذا كان من المفترض أن تُنتج المهمة دائمًا نفس المسار، فاستبدلها بسير عمل تقليدي.

يتجاهل الوكيل قاعدة المعرفة

أضف إلى التعليمات إشارة واضحة إلى وقت الاستعلام عن كل ملف أو جدول. وتأكد أيضاً من اكتمال فهرسة المحتوى.

لا يظهر الناتج في الخطوات اللاحقة.

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

يستهلك التنفيذ عددًا كبيرًا جدًا من الرموز المميزة

قلل عدد الخطوات، وتخلص من الأدوات غير الضرورية، ولا تلصق مستندات مطولة في التعليمات. استخدم قاعدة المعرفة لاسترجاع المعلومات ذات الصلة فقط.

يقوم الوكيل بأداء مهام دون إشراف كافٍ.

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

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

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