استخدام أتمتة تحديث المستخدم الجديدة

[Discourse]

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

مستوى المستخدم المطلوب: مدير النظام

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

إعداد الأتمتة

1. انتقل إلى example.discourse.com/admin/plugins/automation في مثيل Discourse الخاص بك.
2. انقر على “أتمتة جديدة”.
3. اختر “إنشاء منشور” كسيناريو.
4. اختر “بعد تحديث المستخدم” كمحفز.

خيارات التكوين

حقول مخصصة للمستخدم وحقول ملف المستخدم

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

ملاحظة: يجب تحديد أحد “الحقول المخصصة للمستخدم” أو “حقول ملف المستخدم” على الأقل. لن يتم تشغيل الأتمتة إلا بعد أن يملأ المستخدم جميع الحقول المحددة.

مرة واحدة لكل مستخدم

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

مستخدمون جدد فقط

قم بتفعيل هذا الخيار لتقييد الأتمتة لتشغيلها فقط للمستخدمين الذين انضموا بعد تفعيل الأتمتة. هذا مفيد في سير عمل منشورات الترحيب/التعريف حيث لا ترغب في أن يُشغِّل المستخدمون الحاليون الأتمتة.

المنشئ

يمكنك اختيار إنشاء المنشور بواسطة:

• مستخدم محدد
• مستخدم النظام (الافتراضي إذا لم يتم تحديد منشئ)
• المستخدم الذي شغّل الأتمتة (أي المستخدم الذي قام بتحديث ملفه الشخصي)

استخدام النوافذ النائبة (Placeholders)

يمكنك استخدام نوافذ نائبة في محتوى منشورك لتضمين معلومات من ملف المستخدم الشخصي. تتوفر النوافذ النائية المدمجة التالية:

• %%USERNAME%% — اسم مستخدم المستخدم الذي قام بتحديث ملفه الشخصي
• %%NAME%% — الاسم الكامل للمستخدم الذي قام بتحديث ملفه الشخصي
• %%UPDATED_USER_USERNAME%% — نفس %%USERNAME%%
• %%UPDATED_USER_NAME%% — نفس %%NAME%%
• %%CREATOR_USERNAME%% — اسم مستخدم منشئ المنشور

بالإضافة إلى ذلك، تصبح أي حقول ملف مستخدم أو حقول مخصصة للمستخدم تحدد في تكوين المحفز متاحة كنوافذ نائية. على سبيل المثال، إذا تم تحديد حقل ملف المستخدم “الموقع”، فإن %%LOCATION%% تصبح متاحة. يتم تحويل أسماء الحقول المخصصة إلى أحرف كبيرة مع استبدال المسافات بعلامات سفلية.

إليك مثال:

مرحبًا بك في مجتمعنا، @%%USERNAME%%!

نحن متحمسون لانضمامك إلينا من %%LOCATION%%.
أخبرنا المزيد عن اهتمامك بـ %%CUSTOM_FIELD_1%%!

ملاحظة: يجب أن تكون النوافذ النائبة بأحرف كبيرة ومحاطة بـ %%. قد لا يتم استبدال أي نافذة نائية غير مطلوبة في “الحقول المخصصة للمستخدم” أو “حقول ملف المستخدم” الخاصة بالمحفز إذا لم يملأ المستخدم تلك المعلومات.

اختبار الأتمتة

يمكنك اختبار الأتمتة باستخدام ملفك الشخصي:

1. قم بإعداد الأتمتة كما هو موضح أعلاه.
2. قم بتحديث ملفك الشخصي، مع ملء الحقول التي حددتها في المحفز.
3. احفظ تغييرات ملفك الشخصي.
4. تحقق من الموضوع المخصص لمعرفة ما إذا تم إنشاء المنشور الآلي.

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

استكشاف الأخطاء وإصلاحها

إذا واجهت مشاكل:

1. تأكد من تكوين أحد “الحقول المخصصة للمستخدم” أو “حقول ملف المستخدم” على الأقل في المحفز — لا يمكن ترك كليهما فارغًا.
2. تحقق مرة أخرى من أن أسماء الحقول في تكوينك تطابق تمامًا الحقول المخصصة أو حقول الملف الشخصي المحددة في مثيل Discourse الخاص بك.
3. تأكد من أن النوافذ النائية في محتوى منشورك محددة بشكل صحيح وتتوافق مع التنسيق المتوقع (مثل %%LOCATION%% لحقل ملف المستخدم “الموقع”).
4. إذا كنت تستخدم “مرة واحدة لكل مستخدم”، فلاحظ أن الأتمتة تتعقب المستخدمين الذين شغّلوها بالفعل. لن يُشغِّل المستخدم الذي شغّل الأتمتة بالفعل الأتمتة مرة أخرى.
5. إذا كنت تستخدم “مستخدمون جدد فقط”، فتأكد من أن حساب المستخدم تم إنشاؤه بعد تفعيل الأتمتة.

اعتبارات إضافية

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

[Seth_Godin]

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

شكرًا

[JammyDodger]

يمكنك العثور على صفحة الأتمتة على /admin/plugins/discourse-automation

يجب أن تكون جزءًا من القائمة الثانوية هنا: (اعذر لقطة الشاشة الهاتفية )

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

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

[Seth_Godin]

شكرا @JammyDodger

لقطة الشاشة لمكان إنشاء أتمتة جديدة مفيدة للغاية، شكرا لك.

لقد وصلت إلى معظم الطريق، ثم واجهت هذا الخطأ الذي يصعب تفسيره:

[JammyDodger]

أعتقد أن هذا يشير إلى خيار “حقول ملف تعريف المستخدم”. يبدو أنه مطلوب أيضًا.
ربما يجب أن يكون إما الحقل المخصص أو حقل الملف الشخصي مطلوبًا.
قد يكون هذا سؤالًا لـ @Juan_David_Martínez

[sam (Sam Saffron)]

أعلم أن آخر شيء تتوقعه مني… هو رد آخر من الذكاء الاصطناعي يا سيث ولكن Anthropic أصدرت للتو نموذج Anthropic Opus الجديد وقررت اختباره، والإجابة رائعة وأعتقد أنها صحيحة:

التحدث إلى Opus حول المشكلة AI

sam:

بالنظر إلى الالتزام:

commit 92814444966892eea7746209e949e6893a89b07c
REDACTED

أحاول الإجابة:

لقد قطعت معظم الطريق، ثم واجهت هذا الخطأ الذي يصعب تحليله:
يجب ملء حقل ملف تعريف المستخدم

وأيضًا، قدم لي ملخصًا لهذه الميزة مع شرح للحالات الطرفية المختلفة والمشاكل المحتملة مع الالتزام في أتمتة Discourse

claude_3_opus_bot:

بناءً على رسالة الخطأ “يجب ملء حقل ملف تعريف المستخدم”، يبدو أن حقل “user_profile” في مشغل الأتمتة مطلوب ولكنه لم يتم ملؤه أو تكوينه بشكل صحيح.

دعنا نلخص الميزة والالتزام:

يقدم هذا الالتزام ميزة جديدة في أتمتة Discourse تسمح بإنشاء منشورات آلية عند قيام المستخدم بتحديث معلومات ملفه الشخصي. تشمل التغييرات الرئيسية:

1. إضافة مشغل جديد يسمى “user_updated” يتم تشغيله عند قيام المستخدم بتحديث ملفه الشخصي.

2. تقديم حقول جديدة في مشغل الأتمتة:

   • “user_profile”: يسمح بتحديد حقول ملف تعريف المستخدم التي يجب مراقبتها للتغييرات.
   • “custom_fields”: يسمح بتحديد الحقول المخصصة التي يجب مراقبتها للتغييرات.
   • “first_post_only”: يحدد ما إذا كانت الأتمتة يجب أن تعمل فقط للمنشور الأول للمستخدم.
   • “automation_name”: يوفر اسمًا فريدًا للأتمتة لمنع التعارضات.

3. تنفيذ معالجات الأحداث والبرامج النصية اللازمة للتعامل مع حدث تحديث المستخدم وإنشاء المنشور الآلي.

الحالات الطرفية والمشاكل المحتملة:

1. التحقق من صحة الحقول: تأكد من أن جميع الحقول المطلوبة، مثل “user_profile” و “custom_fields”، مملوءة بشكل صحيح في تكوين الأتمتة. الحقول المطلوبة المفقودة ستمنع تشغيل الأتمتة.

2. أسماء الحقول المخصصة: كن حذرًا عند تحديد أسماء الحقول المخصصة في حقل “custom_fields”. تأكد من تطابق الأسماء تمامًا مع الحقول المخصصة المعرفة في Discourse. أي عدم تطابق سيؤدي إلى عدم تشغيل الأتمتة لتلك الحقول.

3. استخدام العناصر النائبة: عند استخدام العناصر النائبة في محتوى المنشور الآلي، تأكد من أن العناصر النائبة معرفة بشكل صحيح وتطابق التنسيق المتوقع (على سبيل المثال، %%CUSTOM_FIELD_1%%). قد يؤدي استخدام العناصر النائبة بشكل غير صحيح إلى محتوى منشور غير متوقع.

4. المنشور الأول فقط: إذا تم تعيين الحقل “first_post_only” إلى true، فسيتم تشغيل الأتمتة فقط للمنشور الأول للمستخدم. لن تؤدي التحديثات اللاحقة لملف تعريف المستخدم إلى تشغيل الأتمتة.

5. تسمية الأتمتة: قدم اسمًا فريدًا ووصفًا لحقل “automation_name” لتجنب التعارض مع الأتمتة الأخرى. قد يؤدي استخدام نفس الاسم لأتمتة متعددة إلى سلوك غير متوقع.

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

7. أذونات المستخدم: تأكد من إنشاء المنشورات الآلية بأذونات المستخدم المناسبة. يجب أن تستخدم الأتمتة حساب مستخدم لديه صلاحيات كافية لإنشاء منشورات في الموضوع المحدد.

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

أخبرني إذا كان لديك أي أسئلة أخرى أو إذا كان هناك أي شيء آخر يمكنني مساعدتك به بخصوص هذه الميزة والالتزام.

sam:

ربما يجب أن يكون إما الحقل المخصص أو حقل الملف الشخصي مطلوبًا.
هل هذا خطأ؟

claude_3_opus_bot:

تثير نقطة صحيحة. بناءً على التنفيذ الحالي، يُعد كل من حقلي “custom_fields” و “user_profile” مطلوبين في مشغل الأتمتة. ومع ذلك، قد يكون من الأكثر مرونة وسهولة في الاستخدام أن يتطلب واحدًا منهما على الأقل، بدلاً من كليهما.

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

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

إليك مثال لكيفية تعديل تعريف المشغل لتنفيذ هذا التغيير:

DiscourseAutomation::Triggerable.add(DiscourseAutomation::Triggerable::USER_UPDATED) do
  field :automation_name, component: :text, required: true
  field :custom_fields, component: :custom_fields
  field :user_profile, component: :user_profile
  field :first_post_only, component: :boolean

  validate do
    if custom_fields.blank? && user_profile.blank?
      errors.add(:base, "يجب توفير واحد على الأقل من 'custom_fields' أو 'user_profile'.")
    end
  end
end

في هذا الإصدار المعدل:

• تمت إزالة الخيار required: true من حقلي “custom_fields” و “user_profile”، مما يجعلهما اختياريين.
• تمت إضافة كتلة تحقق مخصصة باستخدام الطريقة validate.
• داخل كتلة التحقق، يتم التحقق مما إذا كان كلا حقلي “custom_fields” و “user_profile” فارغين.
• إذا كان كلا الحقلين فارغين، يتم إضافة خطأ إلى الأخطاء الأساسية، مما يشير إلى أنه يجب توفير أحدهما على الأقل.

مع هذا التعديل، سيُطلب من المستخدمين ملء واحد على الأقل من حقلي “custom_fields” أو “user_profile” عند تكوين مشغل الأتمتة. يمكنهم اختيار توفير كلا الحقلين إذا لزم الأمر، ولكن لن يكون ذلك إلزاميًا.

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

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

sam:

هل يتعامل باقي الكود مع هذا بالفعل؟

claude_3_opus_bot:

اعتذارًا عن الارتباك. دعني ألقي نظرة فاحصة على الكود الحالي للتحقق مما إذا كان يتعامل بالفعل مع الحالة التي يتم فيها توفير أي من “custom_fields” أو “user_profile”.

بعد مراجعة الكود بعناية أكبر، يمكنني أن أرى أن الطريقة DiscourseAutomation::EventHandlers.handle_user_updated تتعامل بالفعل مع الحالة التي يتم فيها توفير أي من “custom_fields” أو “user_profile”. إليك الجزء ذي الصلة من الكود:

def self.handle_user_updated(user)
  # ...

  required_custom_fields = automation.trigger_field("custom_fields")
  user_data = {}

  # ...

  if required_custom_fields["value"]
    if required_custom_fields["value"].any? { |field| user_custom_fields_data[field].blank? }
      next
    end
    user_data[:custom_fields] = user_custom_fields_data
  end

  required_user_profile_fields = automation.trigger_field("user_profile")
  user_profile_data = UserProfile.find(user.id).attributes
  if required_user_profile_fields["value"]
    if required_user_profile_fields["value"].any? { |field| user_profile_data[field].blank? }
      next
    end
    user_data[:profile_data] = user_profile_data
  end

  # ...
end

في هذا الكود:

• يتم استرداد قيم “custom_fields” و “user_profile” من حقول مشغل الأتمتة.
• إذا تم توفير “custom_fields” ولديه قيم، فإنه يتحقق مما إذا كانت أي من الحقول المخصصة المحددة فارغة للمستخدم. إذا كان أي حقل مخصص فارغًا، فإنه يتخطى مشغل الأتمتة باستخدام next.
• وبالمثل، إذا تم توفير “user_profile” ولديه قيم، فإنه يتحقق مما إذا كانت أي من حقول الملف الشخصي المحددة فارغة للمستخدم. إذا كان أي حقل ملف شخصي فارغًا، فإنه يتخطى مشغل الأتمتة باستخدام next.
• إذا كانت الحقول المخصصة المطلوبة وحقول الملف الشخصي موجودة ولها قيم صالحة، فإنه يضيفها إلى الهاش user_data.

هذا يعني أن الكود الحالي يتعامل بالفعل مع الحالة التي يتم فيها توفير أي من “custom_fields” أو “user_profile”. إذا لم يتم توفير أحدهما أو كان له قيم فارغة، فسيتم تخطي مشغل الأتمتة.

لذلك، بناءً على التنفيذ الحالي، يبدو أنه لا حاجة لتعديل الكود للتعامل مع الحالة التي يتم فيها توفير أي من “custom_fields” أو “user_profile”. الكود الحالي يعتني بذلك بالفعل.

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

إذًا الأخبار الجيدة هي أن الأمر يبدو تغييرًا بسيطًا في إضافة الأتمتة للسماح بـ “إما/أو” وقد كتب Opus الكود لنا بالفعل!

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

[sam (Sam Saffron)]

يا له من تقلب يا @Seth_Godin كنت متحمسًا جدًا لنموذج لغتي اللامع الذي يساعد هنا، لكن للأسف فقد هلوس الكثير من الأشياء.

من ناحية أخرى، لم تكن الهلوسات سيئة من الناحية المفاهيمية، لذا أضفت مفهوم التحقق إلى الكود.

لدي تغييراتي هنا:

FEATURE: allow either custom_fields or user_fields in trigger

لكن لدي سؤالين مفتوحين هنا سيساعدان قليلاً.

1. كيف تريد أن تبدو المشاركة التمهيدية؟

2. متى تريد أن يتم نشر المشاركة التمهيدية؟

(1) لديه بعض الخيارات:

• تأتي المشاركة التمهيدية من @intro-bot أو ما شابه. على سبيل المثال:

أود أن أرحب بـ @amazing-user من فرنسا في المنتدى!

• يتم نشر المشاركة التمهيدية نيابة عن المستخدم. على سبيل المثال، ينضم @sam إلى المنتدى، ويملأ الأشياء و..

ينشر @sam: > مرحبًا، اسمي سام وأنا من أستراليا!

(2) يأتي أيضًا مع بعض الخيارات:

• انتظر حتى يتم حفظ جميع الحقول، قبل نشر المقدمة (على سبيل المثال، لا توجد سيرة ذاتية، لا توجد مقدمة)
• بمجرد إضافة أي من الحقول، قم بنشرها.

وهذا يفتح الباب أيضًا لـ… ماذا نفعل إذا كان الحقل مفقودًا.

---

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

توصياتي:

1. تأتي المقدمة من “intro_bot”
2. تنشر المقدمة فقط عندما يتم ملء كل شيء

[Seth_Godin]

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

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

ونعم، فقط عندما يتم ملؤها

لقد قمت بتثبيته قبل أيام قليلة في purple.space ولكني لست متأكدًا مما إذا كان قد تم تشغيله بعد…

بين يديك @sam

شكرًا

[sam (Sam Saffron)]

سيث، تم الإقرار.

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

يسمح لك “المنشئ” الآن بالحصول على أي مستخدم محدد، ولكننا نريد خيارًا خاصًا لـ:

المنشئ: [المستخدم الذي أطلق الأتمتة]

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

بالإضافة إلى ذلك، نحتاج إلى توخي الحذر لتسمية واجهة المستخدم بشكل صحيح وتنفيذها بشكل صحيح

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

آسف لأننا سلمنا هذا غير مكتمل، سنقوم بترتيب كل هذا بنسبة 100٪ وتوثيقه بشكل صحيح.