قم بعملية التشغيل للكود المخصص باستخدام Workers (إصدار تجريبي)

في مستند المساعدة هذا

تعرف على ماهية Workers وما تُستخدم لأجله.

الانتقال إلى الأسئلة الشائعة

تعد Notion Workers جزءًا من منصة المطوّرين الخاصة بنا. وهي تقوم بعملية التشغيل للكود المخصص على البنية التحتية لـ Notion لتشغيل:

  • مزامنة قاعدة البيانات

  • أدوات للوكلاء المخصَّصين

  • مشغلات خطاف الويب

للإعداد التقني، راجع وثائق المطورين.

لمزيد من المعلومات حول التسعير، راجع هذه المقالة.

  • Workers متاح فقط في خطة الأعمال والخطة المؤسسية.

  • بشكل افتراضي، يتم تشغيل Workers لمساحة العمل (للمالكين فقط).

  • يمكن لمالكي مساحة العمل:

    • قصر إنشاء Worker على المالكين فقط.

    • السماح لبعض أعضاء مساحة العمل أو مجموعات محددة بإنشاء Workers.

    • إيقاف تشغيل Workers لمساحة العمل.

  • إذا كنت تحاول نشر أو إدارة Worker، فستتبع عادةً وثائق المطورين الخاصة بنا وتستخدم Notion CLI.

  • يمكنك تشغيل "وضع المطور" لعرض Workers في Notion، وقراءة السجِل، وإيقاف تشغيل Workers أو حذفها. لنشر Worker أو تغيير الكود أو الإعداد الخاص به، استخدم Notion CLI أو أداة البرمجة الخاصة بفريقك. تعرف على المزيد حول وضع المطور →

لمعرفة المزيد حول أسعار Workers، راجع هذه المقالة.

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

بعض الأمثلة الشائعة:

  • مزامنة تذاكر دعم Zendesk في قاعدة بيانات الفرز.

  • مزامنة حسابات Salesforce في متتبع خطوط الأنابيب.

  • مزامنة البيانات من أداة أو قاعدة بيانات داخلية.

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

تعمل أدوات الوكيل (المدعومة بواسطة Workers) على توسيع نطاق ما يمكن لوكلاءك المخصَّصين القيام به بما يتجاوز إجراءات Notion المدمجة وMCP، مع إمكانات مصممة خصيصًا لطريقة عمل فريقك.

بعض الأمثلة الشائعة:

  • الاستعلام عن مستودع بيانات.

  • إنشاء أصول من مستند Notion.

  • اتخاذ إجراء في تطبيق آخر غير مدعوم أصلاً أو غير متاح عبر MCP.

تسمح مشغلات خطاف الويب (المدعومة بواسطة Workers) لحدث في أداة أخرى ببدء سير عمل في Notion أو أي نظام آخر متصل.

بعض الأمثلة الشائعة:

  • إغلاق مهمة عند دمج طلب سحب (pull request).

  • تحديث سجل CRM عند تغيير اشتراك.

  • إنشاء مستند تأهيل عند توقيع عرض.

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

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

  • رؤية جميع Workers في قائمة واحدة.

  • فتح Worker وعرض النظرة العامة، والسجِل، ومتغيرات البيئة، والإعدادات.

  • قراءة سجِل Worker.

  • إيقاف تشغيل Worker أو حذفه.

لنشر Worker أو تغيير الكود الخاص به أو إعداده، استخدم Notion CLI أو أداة البرمجة الخاصة بفريقك.

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

جرِّب هذه الخطوات بالترتيب:

  1. تأكد من أن مساحة العمل الخاصة بك مؤهلة، وأن مالك مساحة العمل قد فعَّل Workers. تتوفر Workers على خطة الأعمال والخطة المؤسسية، وتتطلب التمكين من قِبل مسؤول مساحة العمل.

  2. تأكد من أنك تستخدم مسار الإعداد المقصود. بالنسبة لمعظم عمليات الإعداد، ستستخدم Notion CLI بالإضافة إلى وثائق المطور.

  3. إذا فشل نشر العامل (Worker) الخاص بك، فتحقق من الأذونات بعد ذلك. قد لا يكون لديك حق الوصول للنشر في مساحة العمل تلك، حتى لو كان بإمكانك عرض الصفحات فيها.

  4. إذا كان العامل (Worker) الخاص بك يعمل ولكنه لا يغير أي شيء في Notion، فاختبر الإجراء يدويًا أولاً. إذا لم تتمكن من إجراء التغيير نفسه في Notion، فعادةً ما تكون المشكلة متعلقة بالأذونات أو إعدادات مساحة العمل.

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

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


الأسئلة الشائعة

ما الفرق بين Workers وCustom Agents؟

تحل Workers وCustom Agents مشكلات مختلفة، ولكن يمكنهما العمل معاً.

  • Workers: تشغيل كود مخصص على البنية التحتية لـ Notion. يستخدم المطورون Workers لأغراض مثل الأتمتة، والمزامنة المجدولة، وعمليات التكامل المخصصة.

  • Custom Agents: تتولى Custom Agents المهام المتكررة لفريقك تلقائياً. أنت تضبط المشغلات، وهي تعمل في الخلفية مع اعتبار مساحة عملك كسياق لها.

في بعض الإعدادات، يمكن لـ Worker تشغيل أداة فريدة يمكن لـ Custom Agent استخدامها. على سبيل المثال، قد يقوم Worker بجلب بيانات من نظام آخر، ويمكن لـ Custom Agent استخدامها للرد أو اتخاذ إجراء.

هل Workers هي نفس الشيء مثل الأتمتة؟

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

هل تعمل Workers على خوادمي؟

لا. Workers تعمل على خوادم Notion، لذا لا تحتاج إلى إعداد أو إدارة أي بنية تحتية.

هل أحتاج إلى واجهة سطر الأوامر (CLI) لاستخدام Workers؟

ليس دائماً. يمكنك عرض Workers، وقراءة السجِل، وإيقاف تشغيل Workers، وحذف Workers في Notion باستخدام وضع المطور. ستحتاج عادةً إلى واجهة سطر الأوامر (CLI) أو أداة البرمجة الخاصة بفريقك لإعداد Worker أو نشره أو تغييره.


تقديم تعليق

هل كان هذا المورد مفيداً؟


Powered by Fruition