Routines: الأتمتة المجدولة والمُشغَّلة بالأحداث (بما في ذلك Webhook)
في الدرس السابق حفظنا الطريقة كـ Skills والتعليم، وفي هذا الدرس نضيف لها مؤقتًا: routine يخبر الـ Bot متى يعمل تلقائيًا — بجدولة زمنية (الساعة 8 من كل يوم عمل، أو كل 2 ساعة)، أو بتشغيل عبر الأحداث (رسائل Slack، وأحداث GitHub / Linear / Sentry / PagerDuty، وبريد جديد في صندوق بريد الـ Bot، واستدعاء webhook). إذا كنت قد بحثت عن «مهام Grok Bot المجدولة»، فالأرجح أن هذه هي القدرة التي تريدها. لا حاجة لبناء workflow في لوحة الإعدادات: طريقة إنشاء الـ routine هي ببساطة أن تقول جملة للـ Bot.
هنا يكتمل الخط الأخير من دليل سير العمل: أنجح المهمة مرة واحدة ← احفظها كـ skill ← ثم سلّمها للـ routine لتعمل تلقائيًا. تؤكد الوثائق الرسمية مرارًا على عدم تخطي الخطوات — اجعل المهمة لمرة واحدة موثوقة أولًا، ثم أتمِتها.
نقطتان تذكّرهما أولًا: يعمل الـ routine على حاسوب سحابي، ولا يتوقف حتى لو أغلقت حاسوبك المحمول؛ كل run يستهلك من رصيد الاستخدام الأسبوعي، فصمّم نطاق التشغيل وتكراره بعناية، فالأكثر ليس دائمًا أفضل.
المدة الإجمالية نحو 14 دقيقة. يمكن إنجاز الإنشاء والتعديل في المحادثة؛ أما Test وعرض حقول webhook الثلاثة فيتطلبان نسخة سطح المكتب.
ما الذي ستستطيع فعله بعد التعلم
- إنشاء routine مجدول للـ Bot بمحادثة واحدة، والتحقق من جميع عناصر التأكيد الـ 6 التي تتطلبها الوثائق الرسمية: الـ Bot المسؤول، والجدولة والمنطقة الزمنية، ومصدر المدخلات، والنتيجة المتوقعة، وحدود الموافقة، واستراتيجية غياب المصدر
- جعل الـ routine يعمل تلقائيًا عند وقوع حدث: رسائل Slack، وأحداث GitHub / Linear / Sentry / PagerDuty، وبريد جديد في صندوق بريد الـ Bot، واستدعاء webhook
- إعداد webhook للـ routine: الحصول على المجموعة الثلاثية POST to / key / header، والتشغيل بأمر curl واحد، ومعرفة أن الإجابة 200 تعني فقط «تم الاستقبال»
- التحقق الفوري من الـ routine الجديد عبر Test دون انتظار الموعد التالي (الاختبار يتطلب نسخة سطح المكتب، وهو ينفّذ عملًا حقيقيًا)
- الإدارة واستكشاف الأخطاء: الإيقاف المؤقت والتعديل والحذف وعرض Run history، مع استحضار حساب الحدود: ≤50 لكل Bot، وبفاصل ≥5 دقيقة، و300 / 200 مرة في الساعة
مشكلتك الحالية
- «كل صباح عليّ أن أرسل يدويًا جملة مثل: لخّص لي تذاكر الأمس، وإذا نسيت لا يوجد تقرير» — المهمة صحيحة، لكن التشغيل ما زال يدويًا كل يوم
- «أريد أن يبدأ الـ Bot العمل تلقائيًا عندما يذكر أحدهم needs repro في Slack، ولا أعرف من أين أبدأ الإعداد» — شرط التشغيل في رأسك، ولم يتحول إلى جدولة للـ Bot
- «أنشأت routine يعمل كل ساعة، فنفد رصيد الاستخدام الأسبوعي في يومين، وأصطدم دائمًا بحدود المعدل» — الأتمتة تعمل، لكن دون حساب الاستخدام والحدود
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- تكليف الـ Bot بتنفيذ مهمة جاهزة (ويُفضَّل أن تكون محفوظة كـ skill) تلقائيًا وفق جدولة أو أحداث
- تمكين الأنظمة الخارجية (CI، وتنبيهات المراقبة، وخدمات النماذج، وسكربتاتك الخاصة) من إيقاظ الـ Bot باستدعاء HTTP واحد
- استمرار المهمة بعد إغلاق حاسوبك المحمول — يعمل الـ routine على حاسوب سحابي ولا يعتمد على تشغيل حاسوبك
ولا تريد أن:
- ترسل يدويًا التعليم نفسه كل يوم
- تبني بنفسك نظام جدولة من أدوات خارجية وسكربتات
- تترك سير عمل غير مُتحقق منه يعمل تلقائيًا
🎒 التحضير قبل البدء
- أن تكون قد أكملت Skills والتعليم: حفظ المهمة الناجحة كمهارة قابلة لإعادة الاستخدام — الترتيب الرسمي هو إتقان المهمة لمرة واحدة أولًا وحفظها كـ skill، ثم الأتمتة أخيرًا؛ وهذا الدرس يستهلك تلك النتيجة مباشرة
- لديك مهمة تريد أتمتتها، وقد نجحت في تشغيلها يدويًا مرة واحدة على الأقل (لم تنجح بعد؟ عد إلى الدرس السابق)
- التطبيقات التي تحتاجها المهمة متصلة بالفعل (Slack وGmail والتقويم وغيرها) — تكاملات التشغيل بالأحداث موصولة على حساب Cursor الذي يملك هذا الـ Bot
- نسخة سطح المكتب متاحة لديك — Test وحقول webhook الثلاثة تُعرض في تطبيق سطح المكتب؛ يمكن للهاتف عرض Run history والإيقاف المؤقت والحذف، لكن الاختبار يتطلب نسخة سطح المكتب
- تعرف كيفية الاطلاع على رصيد الاستخدام الأسبوعي الخاص بك (الاشتراكات والأسعار) — كل run يستهلك من الرصيد
الفكرة الجوهرية
يجيب الـ routine على سؤال واحد فقط: متى يعمل هذا الـ Bot تلقائيًا. أما ما الذي يُشغَّل فيأتي من الـ Instruction الخاص به — وهو عادة الـ skill المحفوظ في الدرس السابق، أو سير عمل مكتوب بوضوح.
| ما الذي يجيب عنه | مثال | |
|---|---|---|
| skill | كيف يُنفَّذ | خطوات «الفحص الأسبوعي لصحة العملاء» وحدودها |
| routine | متى يتم التنفيذ | «كل يوم عمل 8:00 مرة واحدة» |
للتذكر بجملة واحدة: skill هو الوصفة، وroutine هو المنبّه.
خمس طرق للتشغيل (كلها تُكتب في When to run الخاص بـ routine):
| طريقة التشغيل | متى يعمل |
|---|---|
| مجدول schedule | وفق الجدول الذي تحدده: every weekday at 8:00 AM، وevery 2 hours |
| رسالة Slack | إشارة إلى البوت، أو ظهور كلمة أو عبارة معينة، أو ردّك بتفاعل، أو أي رسالة؛ يمكن مراقبة قناة واحدة أو Slack بأكمله |
| حدث أداة | أحداث GitHub وLinear وSentry وPagerDuty، مثل When a Linear issue is created |
| بريد إلكتروني | رسائل جديدة تصل إلى صندوق البريد المخصص للبوت؛ يمكن التصفية حسب المُرسل أو النطاق بأكمله، وليس حسب الموضوع |
| Webhook | أي نظام يرسل HTTP POST إلى عنوان URL الخاص بـ routine |
ثلاثة مبادئ تصميم، سيتم استخدامها في كل خطوة لاحقة:
- الضيّق قبل الواسع: كلما كان نطاق التشغيل أضيق كان أفضل — تقول الوثائق الرسمية صراحةً إن المراقبة الواسعة (مثل «كل رسالة جديدة») تُصدر ضوضاء، وتستهلك الاستخدام، ويمكن أن تتخذ إجراءات تجاه مدخلات غير ذات صلة.
- التحضير قبل التنفيذ: اجعل البوت يصوّر ويتحقق ويقترح أولاً؛ أما الإجراءات ذات العواقب مثل الإرسال والشراء والحذف والنشر وتعديل أنظمة الإنتاج فتُترك خلف الموافقة.
- فكّر مسبقًا في ماذا يحدث عند الفشل: ما الاستراتيجية عند غياب البيانات المصدرية (الإبلاغ عن خطأ بدلاً من الحساب بالبيانات القديمة) — وهذا أحد 6 عناصر تطلب الوثائق الرسمية تأكيدها عند الإنشاء.
💡 التشغيل بالأحداث يتم عبر تكاملات حساب Cursor
الأحداث مثل Slack والبريد الإلكتروني تبدأ عبر Cursor account integrations، وهي منفصلة عن التطبيقات المتصلة بـ Slack وGitHub، وقد تحتاج إلى ربط كل منها على حدة. قبل الاعتماد على تشغيل Slack، اربط Slack أولًا على حساب Cursor الذي يملك هذا البوت.
تابع خطواتي
الخطوة 1: إنشاء routine بمحادثة واحدة (مهمة مجدولة للبوت Grok)
لماذا: فلسفة إعداد البوت Grok هي «الإعداد رسالة واحدة، وليس workflow builder» — وroutine كذلك، يكفي أن تشرح بوضوح في المحادثة للبوت المسؤول عن ذلك.
قلها للبوت الذي يملك هذا العمل. المثال الرسمي:
Every weekday at 8:00 AM, run the Daily customer-risk skill against the current account list. Post a linked watch list in this conversation. Do not contact customers. If the source data is unavailable, report the failure instead of using old data.
(كل صباح من أيام العمل 8:00، شغّل skill المسمى "Daily customer-risk" على قائمة العملاء الحالية، وانشر قائمة المراقبة مع الروابط في هذه المحادثة. لا تتواصل مع العملاء. إذا كانت البيانات المصدرية غير متاحة، أبلغ عن الفشل بدلاً من استخدام البيانات القديمة.)
كثافة هذا المثال تستحق النقل الحرفي: الوقت (أيام العمل 8:00)، ماذا يشغّل (ذكر skill بالاسم)، المدخلات (قائمة العملاء الحالية)، إلى أين تذهب النتيجة (هذه المحادثة)، حدود الموافقة (عدم التواصل مع العملاء)، استراتيجية الفشل (الإبلاغ عن خطأ بدلاً من استخدام بيانات قديمة) — ستة أمور مغطاة في جملة واحدة.
بعد إنشاء البوت، تحقق بندًا بندًا من 6 عناصر التأكيد التي تطلبها الوثائق الرسمية:
| # | عنصر التأكيد | التحقق الذاتي |
|---|---|---|
| 1 | البوت المسؤول | هل هو نفس البوت الذي تتحدث معه الآن |
| 2 | الجدول والمنطقة الزمنية | هل الوقت صحيح؛ المنطقة الزمنية تُتحقق في الخطوة التالية |
| 3 | مصدر المدخلات | من أين تأتي البيانات |
| 4 | النتيجة المتوقعة | كيف يبدو الناتج وإلى أين يُرسل |
| 5 | حدود الموافقة | أي الإجراءات يجب أن تتوقف وتنتظرك |
| 6 | ماذا عند غياب المصدر | الإبلاغ عن خطأ أم التخطي — لا تدعه يحسب بالبيانات القديمة |
يمكن الإنشاء أيضًا على الهاتف: افتح ملف البوت الشخصي، وضمن Routines اضغط Add routine — سيبدأ البوت Grok رسالة تبدأ بـ "Set up a routine to"، ويكفي أن تُكمل هذه الجملة وترسلها.
يفترض أن ترى: البوت يؤكد الإنشاء، ويظهر routine في قائمة routines الخاصة بهذا البوت (نسخة سطح المكتب: اضغط على اسم البوت أعلى المحادثة → تبويب Details).
- 6 عناصر التأكيد كلها مطابقة، خصوصًا حدود الموافقة واستراتيجية الفشل
الخطوة 2: التحقق من When to run: الوقت والمنطقة الزمنية وشروط التشغيل
لماذا: الجدولة باللغة الطبيعية سهلة الكتابة وسهلة الخطأ — «كل يوم الساعة 8» هل تعني 8 عندك أم 8 في منطقة زمنية أخرى؟ إذا كُتبت خطأً، سيعمل routine في وقت خاطئ لأسبوع كامل.
اكتب الجدولة بلغة عادية، مثل every weekday at 8:00 AM أو every 2 hours. ثم افتح routine وتحقق من When to run — يعرض الجدول المحفوظ نصًا، وإذا لم يطابق قصدك فاختر Edit وأخبر البوت بما ينبغي تعديله.
تُضبط المنطقة الزمنية هنا: Settings → Bot → Timezone.
| الخيار | السلوك | متى يُستخدم |
|---|---|---|
| Auto-detect | يتبع هذا الحاسوب | أينما كنت، يعمل routine بتوقيت ذلك المكان |
| أو اختر منطقة زمنية يدويًا | لتثبيتها | عندما يكون عملك تابعًا لمكتب في منطقة زمنية أخرى |
أكثر فخ زمني سهل الوقوع فيه: الـ routine الجديد لا يعمل فورًا. فهو ينتظر نقطة الجدولة التالية — 8:05 إذا أنشأت routine «كل يوم 8:00»، فستكون أول تشغيلة غدًا 8:00. للتحقق فورًا، استخدم Test في الخطوة التالية.
يجب أن ترى: نص الجدولة المعروض في When to run يطابق نيتك، والمنطقة الزمنية صحيحة.
- نص الجدولة في When to run يطابق نيتك
الخطوة 3: تحقق فورًا باستخدام Test دون انتظار النقطة الزمنية التالية
لماذا: اكتشاف أن الـ routine عمل بشكل خاطئ عند الساعة 8 غدًا يعني إهدار يوم كامل؛ Test يتيح لك رؤية النتيجة الآن.
افتح الـ routine في نسخة سطح المكتب واختر Test (اختبار الـ routine يتطلب تطبيق سطح المكتب، وهو غير متوفر على الهاتف).
يجب أن ترى:
- الزر يعرض Running… حتى انتهاء التشغيل، وتظهر النتيجة في محادثة الـ Bot
- عندما يتعذر بدء الاختبار، سترى Couldn't start a test run، أو رسالة تشرح السبب
بعض الـ routines لا تعرض Test — وهي مع ذلك تعمل حسب الجدولة أو المشغّل؛ لهذا النوع اطلب من الـ Bot أن يؤدي نفس العمل مرة واحدة في المحادثة باستخدام مدخل آمن.
⚠️ Test يؤدي عملًا حقيقيًا
التشغيلة التجريبية ستتصفح مواقع فعلاً، وتعدّل ملفات، وتستدعي أدوات متصلة. استخدم مدخلًا آمنًا، وأبقِ عمليات الكتابة خلف الموافقة.
بعد انتهاء التشغيل، تحقق من 5 أمور وفق القائمة الرسمية:
- المدخل المختار هو الحالي وليس بيانات قديمة
- المخرجات تطابق التنسيق المطلوب
- لكل إجراء مصدر أو أثر تدقيق
- توقف عند نقطة الموافقة المحددة
- حالة الفشل واضحة — عند الفشل يُعلَم عنه بدل الصمت
الخطوة 4: إضافة مشغّلات الأحداث: رسائل Slack وأحداث الأدوات والبريد
لماذا: كثير من المهام لا تعمل حسب مواعيد محددة — بل يحتاج الـ Bot للتدخل فقط عندما يصعّد أحدهم مشكلة. مشغّلات الأحداث تجعل «حدوث X» نفسه هو المفتاح.
قل للـ Bot أيضًا المشغّل الذي تريده، وسيعرضه When to run نصًا، مثل When a Linear issue is created. مصادر الأحداث المدعومة: رسائل Slack، وأحداث GitHub / Linear / Sentry / PagerDuty، والرسائل الجديدة المرسلة إلى بريد الـ Bot المخصص، بالإضافة إلى webhook (الخطوة التالية).
تذكّر أولًا قاعدة عامة: النشاط الجديد فقط هو الذي يُحتسب — الأحداث السابقة لإنشاء المشغّل لن تبدأ run. ثم ضيّق قواعد المطابقة، بالكثافة التي تعرضها الأمثلة الرسمية:
When a message in
#customer-escalationscontains a support ticket link and the phrase "needs repro," open the ticket, reproduce the issue in staging, and post a repro pack in this conversation. Never post back to Slack without approval.(عندما تحتوي رسالة في قناة #customer-escalations على رابط تذكرة وعلى عبارة "needs repro": افتح التذكرة، وأعد إنتاج المشكلة في staging، وانشر حزمة إعادة الإنتاج في هذه المحادثة. لا تنشر مطلقًا إلى Slack دون موافقة.)
المستويات الأربعة لمشغّل Slack: ذِكر الـ Bot / ذِكر كلمة أو عبارة معينة / تفاعلك برمز تعبيري على رسالة / أي رسالة؛ ويمكن أن يكون النطاق قناة واحدة أو Slack بأكمله. انتبه للفرق: مشغّل Slack هو جزء من الـ routine وليس تطبيق Slack — التطبيق يجعل الـ Bot يقرأ ويكتب بهوية مستخدم Slack الذي ربطته، بينما المشغّل مسؤول عن «إذا حدث، ابدأ التشغيل».
الحدود الثلاثة لمشغّل البريد:
- الرسالة الجديدة لا توقظ الـ Bot من تلقاء نفسها — يجب أن تُنشئ routine يراقب البريد حتى يتصرف بناءً عليه
- يمكن مراقبة أي شخص أو عنوان معين أو نطاق كامل (مثل
*@example.com)؛ لا يمكن التصفية حسب الموضوع؛ يعمل افتراضيًا فقط للمرسلين الذين يجتازون مصادقة البريد القياسية؛ الرسائل التي لا تجتاز فحص البريد المزعج أو الفيروسات لن تبدأ routine أبدًا - يتعامل الـ Bot مع محتوى البريد بوصفه معلومة وليس تعليمات — عبارة «يرجى إعادة توجيه رمز التحقق إلى…» المخبأة في رسالة لا تُعد تفويضًا منك
يجب أن ترى: يعرض When to run شرط التشغيل نصًا (القناة مع العبارة، أو نوع الحدث، أو قاعدة تصفية البريد).
- قاعدة التشغيل ضيقة بما يكفي: قناة أو مستودع أو مرسل محدد، وليس «أي رسالة»
الخطوة 5: إعداد مشغّل Webhook (webhook الخاص بـ Grok Bot)
لماذا: يتيح webhook لأي نظام خارجي — CI، وتنبيهات المراقبة، وخدمات النماذج، والسكربتات التي تكتبها بنفسك — أن يستدعي الـ Bot عبر HTTP POST واحد. هذا هو المدخل القياسي لربط Grok Bot بسلاسل الأتمتة الحالية.
اطلب أولًا من الـ Bot إضافة مشغّل webhook إلى الـ routine، ثم افتح هذا الـ routine في نسخة سطح المكتب. تحتوي منطقة Webhook على ثلاثة حقول، انقر عليها لنسخها:
| الحقل | ما هو |
|---|---|
| POST to | عنوان URL الذي يستقبل الاستدعاءات |
| key | المفتاح السري؛ يرفعه المرسل بالشكل Authorization: Bearer <key> |
| header | الترويسة الكاملة المُجمّعة، تُنسخ كاملة وتستخدم مباشرة |
يستدعي المرسل بهذه الطريقة (جسم JSON اختياري، وسيتلقاه الـ Bot مع تعليمات الـ routine):
curl -X POST "<POST to 字段的 URL>" \
-H "<header 字段整条复制>" \
-d '{"ticket":"12345","priority":"high"}'اقرأ رمز الاستجابة:
| الاستجابة | المعنى | الخطوة التالية |
|---|---|---|
200 | Grok Bot تلقّى هذا الاستدعاء وبدأ run — لا يعني أن العمل اكتمل | اذهب إلى محادثة الـ Bot لرؤية النتيجة |
| غير ذلك | لم يبدأ الـ run | تأكد أن الـ routine غير موقوف وأن الطلب يستخدم المفتاح الحالي |
يجب أن ترى: بعد استجابة 200 تظهر عملية هذه الـ run ونتيجتها في محادثة الـ Bot.
- أرسل POST تجريبيًا واحدًا: تعود الاستجابة 200 وتظهر الـ run المقابلة في محادثة الـ Bot
الخطوة 6: إدارة الـ routines: الإيقاف والتعديل والحذف والحدود
لماذا: الأتمتة أصل طويل الأمد، قد تتقادم، وقد تخرج عن السيطرة، وقد تحرق الاستخدام — يجب أن تكون على دراية تامة بمنفذ الإدارة والحدود الصارمة.
نسخة سطح المكتب: انقر على اسم Bot أعلى الدردشة لفتح التفاصيل، وتوجد routines في علامة التبويب Details. يعرض كل صف الاسم ووقت التشغيل (أو Paused)، والمفتاح داخل الصف يوقف مؤقتًا أو يستأنف مباشرة. عند فتح routine يمكنك رؤية Instruction (ما يفعله كل run) و When to run (الجدولة وأحداث التشغيل)؛ والروتينات التي تبدأ عبر webhook تعرض أيضًا منطقة Webhook. الأزرار في الأسفل:
| الزر | الوظيفة |
|---|---|
| Pause / Resume | إيقاف مؤقت / استئناف |
| Test | تشغيل فوري مرة واحدة (تتوفر في بعض routine) |
| Edit | يبدأ رسالة تبدأ بـ "Edit your routine:"، أضف التغييرات المطلوبة وأرسلها |
| Delete routine (أيقونة سلة المهملات) | حذف، يتطلب تأكيدًا؛ لا يمكن التراجع عنه، وتتوقف جميع الـ runs المستقبلية |
النقر بزر الماوس الأيمن على routine يتيح أيضًا Pause / Resume، Test، Edit، Delete. عندما لا يملك Bot أي routine بعد، تعرض القائمة Ask in chat to set a routine.
نسخة الهاتف: ملف Bot الشخصي ← Routines. عند الفتح يمكنك رؤية Active، وSchedule، وNext run، وInstruction و Run history؛ إيقاف Active يعني الإيقاف المؤقت، والسحب على صف يحذفه. Run history يصنف كل run كـ Running / Succeeded / Failed، والفاشل يأتي مع سببه؛ وNo runs yet يعني أنه لم يبدأه شيء بعد.
الحدود الصارمة والسجلات:
| بند الحد | القيمة |
|---|---|
| عدد الـ routines لكل Bot | بحد أقصى 50 |
| فاصل الجدولة | على الأقل 5 دقيقة |
| المعدل: مجموع جميع routines لديك | بحد أقصى 300 مرة في الساعة |
| المعدل: routine واحد | بحد أقصى 200 مرة في الساعة |
| سجل الـ Run | يُبقي لكل routine آخر 20 سجلًا |
الـ run الذي يتجاوز المعدل يفشل بـ Automation run rate limit exceeded. إضافة إلى ذلك، حذف Bot يحذف معه الـ routines التي يملكها.
هناك نقطة يسهل إغفالها: بعد فترة طويلة دون استخدام، قد يسألك Grok Bot عما إذا كنت تريد إبقاء routine قيد التشغيل، وعدم الرد قد يوقفها مؤقتًا — تذكر عند العودة أن تتحقق من الـ routines المتوقفة مؤقتًا.
يجب أن ترى: يمكنك في ثلاث خطوات الوصول إلى قائمة routines لأي Bot، وأن تقول متى سيتم تشغيله في المرة القادمة.
نقطة تحقق ✅
- يمكنك إنشاء routine بجملة واحدة، وتتطابق عناصر التأكيد الـ 6 (Bot المسؤول / الجدولة والمنطقة الزمنية / مصدر الإدخال / النتيجة المتوقعة / حدود الموافقة / استراتيجية النقص)
- تعرف أن الـ routine المنشأ حديثًا لا يبدأ أول تشغيل إلا عند نقطة الوقت التالية؛ للتحقق استخدم Test في نسخة سطح المكتب، وأن الاختبار يؤدي عملًا حقيقيًا
- قواعد التشغيل بالأحداث ضيقة بما يكفي، وتعرف أن الأنشطة الجديدة فقط بعد إنشاء المشغل تُحتسب
- يمكنك إعداد حقول webhook الثلاثة (POST to / key / header) وضبطها؛ 200 = تم الاستلام ≠ اكتمل
- لديك حساب الحدود في ذهنك: لكل Bot ≤50، وفاصل الجدولة ≥5 دقيقة، وفي الساعة 300 مرة إجمالًا / 200 مرة للواحد
تنبيهات المخاطر
❌ الاعتقاد بأن المهمة اكتملت بمجرد إرجاع webhook 200
الظاهرة: نظامك يستقبل 200، ويضع علامة «تمت المعالجة»، بينما Bot في الواقع لا يزال يعمل، وربما لم يكمل الإجراءات المتوقعة.
السبب: معنى 200 هو أن Grok Bot قبل الاستدعاء وبدأ run واحدًا، وليس أن Bot أكمل التعليمات.
الطريقة الصحيحة: اعتبر 200 «تم الاستلام»، وتحقق من النتيجة في دردشة Bot. غير 200 يعني عدم بدء التشغيل — تحقق مما إذا كان routine متوقفًا مؤقتًا، أو أن المفتاح key هو الحالي.
❌ الاصطدام بـ Automation run rate limit exceeded
الظاهرة: يفشل routine بشكل متكرر، والسبب في Run history مكتوب Automation run rate limit exceeded، لكنك عند حساب تكرارك الخاص يبدو أنك لم تتجاوز.
السبب: احتمالان. تجاوز حقيقي — مجموع جميع routines 300 مرة في الساعة، والواحد 200 مرة في الساعة؛ أو الاصطدام بـ** حد مشترك بين جميع routines الـ Grok Bot** — أكدت الجهة الرسمية أن هذه مشكلة معروفة، وقد تتضرر بالخطأ حتى لو كان تكرارك الخاص منخفضًا.
الطريقة الصحيحة: إذا كان التجاوز حقيقيًا، فاطلب من Bot تضييق المشغلات أو تخفيف الجدولة؛ أما من تضرر بالحد المشترك فلينتظر ثم يعيد التشغيل. الـ runs الفاشلة لا تعاد تلقائيًا — أعد التشغيل بنفسك باستخدام Test، وللـ webhook أعد إرسال الاستدعاء مرة أخرى.
❌ موافقة routine عالقة 30 دقيقة دون اهتمام، ويتم تخطي الإجراء بصمت
الظاهرة: عند مراجعة نتائج الـ routine في الصباح، تكتشف أن الخطوة الأخيرة لم تُنفَّذ، وفي المحادثة توجد بطاقة Expired.
السبب: العمل الذي تبدأه في المحادثة، تنتظر بطاقة الموافقة الخاصة به إلى ما لا نهاية؛ أما البطاقات التي يطلقها routine أو مشغّل أو عمل خلفي آخر، فتنتهي صلاحيتها بعد 30 دقيقة، وبعد انتهاء الصلاحية لا يُنفَّذ ذلك الإجراء.
الطريقة الصحيحة: فعّل Notifications للبوت الذي يشغّل الـ routine؛ وللإجراءات الموثوقة اختر Always allow واحفظها كقاعدة؛ وإذا انتهت الصلاحية فاطلب من البوت إعادة محاولة المهمة. أما عن كيفية رسم الحدود، فراجع الموافقات وAuto Review.
❌ الاستهلاك يحترق أسرع مما تتوقع
الظاهرة: الحصة الأسبوعية التي كان لا يزال يتبقى منها معظمها يوم الاثنين، نفدت يوم الثلاثاء.
السبب: كل عملية run تستهلك من الحصة. التشغيل كل ساعة، أو الفواصل الزمنية القصيرة جدًا، أو مشغّلات Slack على القنوات المزدحمة، يمكن أن تحرق حصة أسبوع كامل في يوم واحد. الـ routine الذي لا يعمل أبدًا لا يكلّف شيئًا، لكن الـ Test يستهلك — فهو يقوم بعمل حقيقي.
الطريقة الصحيحة: أوقف مؤقتًا الـ routines غير الضرورية أولًا، ثم اطلب من البوت تخفيف الجدولة وتضييق مشغّلات Slack؛ وإذا لم يكن ذلك كافيًا بعد فعل كل هذا، ففكر عندها فقط في ترقية الخطة أو تعديل حد on-demand. لمعرفة كيفية حساب حصة الاستهلاك راجع الاشتراكات والأسعار.
نصائح متقدمة (اختياري)
أضِف إلى الـ routine «تصميمًا للثقة». قدّمت الجهة الرسمية 7 مبدأ ثقة للأتمتة، راجعها قبل الإنشاء:
| # | المبدأ | في سطر واحد |
|---|---|---|
| 1 | أتمت التحضير أولًا ثم أتمتة التنفيذ | التجميع والصياغة أولًا؛ الإرسال والتغيير لاحقًا |
| 2 | اجعل البوت يصوغ ويراجع ويقترح أولًا | إنتاج أشياء قابلة للمراجعة بدلًا من التدخل المباشر |
| 3 | الإرسال والشراء والحذف والنشر وتعديل أنظمة الإنتاج تتطلب موافقة | الإجراءات ذات العواقب الكبيرة تبقى خلف الموافقة |
| 4 | اكتب بوضوح سياسة غياب البيانات والبيانات القديمة | عند عدم وجود بيانات أبلغ عن خطأ، ولا تحسب بالبيانات القديمة |
| 5 | اجعل إعادة المحاولة idempotent قدر الإمكان | إعادة التشغيل مرة واحدة لا تسبب أثرين جانبيين |
| 6 | أخبر البوت إلى من يبلّغ عند الإنجاز الجزئي | يجب أن يكون العمل الناقص مرئيًا |
| 7 | عند تغيّر الموقع أو التطبيق أو صيغة المصدر أعد الاختبار | الأتمتة تتقادم بصمت |
عندما لا يعمل، تحقق وفق القائمة الرسمية. تحقق أولًا من 6 عناصر:
- لم يتم إيقافه مؤقتًا بحالة Paused (على الهاتف Active مفعّل)
- جدول When to run والمنطقة الزمنية يطابقان التوقعات
- البوت الذي يملكه لا يزال موجودًا
- الإضافات المطلوبة لا تزال في حالة مصادقة
- الكمبيوتر السحابي يستطيع الاتصال بالنظام المصدر
- الاستهلاك أو الوصول إلى الحساب لم يُوقفا
للمشغّلات بالأحداث، تأكد مجددًا من أن قناة المصدر والمستودع وقواعد المطابقة لا تزال صالحة. كل شيء سليم ومع ذلك لم يعمل لأكثر من 24 ساعة دون خطأ؟ أبلغ عن الخلل مع ذكر اسم البوت وتفاصيل الـ routine. لمزيد من مطابقة الأخطاء راجع مرجع سريع للأخطاء.
البريد مع الـ routine هو خط معالجة للبريد الوارد دون حاجة إلى مراقبة. اجعل قواعد الاستلام (حسب المرسل أو النطاق) مشغّلًا للـ routine، فتُؤرشف الفواتير والإشعارات الواردة إلى بريد البوت وتُلخّص تلقائيًا؛ أما الرسائل التي يرسلها الـ routine فتُحفظ كلها كمسودات في انتظار أن تضغط Send، ولا يوجد إرسال دون مراقبة. للاطلاع على الاستخدام الكامل راجع البريد المخصص للبوت وتطبيق عملي: ملخص البريد.
خلاصة هذا الدرس
✅ طريقة إنشاء Grok مهام البوت المجدولة هي محادثة: اشرح للبوت المسؤول الوقت، وما الذي يشغّله، والمدخلات، ووجهة النتائج، وحدود الموافقة، واستراتيجية الفشل، ثم تحقق من 6 عناصر للتأكيد.
✅ قل الجدولة بلغة طبيعية؛ المنطقة الزمنية في Settings → Bot → Timezone (يتبع Auto-detect الجهاز المحلي). الـ routine الجديد ينتظر الموعد التالي ليعمل أول مرة، وللتحقق استخدم Test في نسخة سطح المكتب — الاختبار يقوم بعمل حقيقي.
✅ المشغّلات بالأحداث تغطي رسائل Slack، وأحداث GitHub / Linear / Sentry / PagerDuty، والرسائل الجديدة في بريد البوت، وwebhook؛ الأنشطة الجديدة فقط تُحتسب، واجعل القواعد ضيقة لا واسعة.
✅ ثلاثة حقول للـ Webhook: POST to (عنوان URL)، وkey (Authorization: Bearer)، وheader (انسخه كاملًا)؛ والإرجاع 200 = تم الاستلام وبدأ run، ولا يعني الاكتمال.
✅ حساب الحدود: لكل بوت ≤50 routine، وفاصل الجدولة ≥5 دقيقة، وإجمالي 300 عملية في الساعة / 200 عملية للواحد، مع الاحتفاظ بآخر 20 سجل run؛ والـ run الفاشل لا يعاد تلقائيًا.
مرجع سريع للمواقع الرئيسية:
| الحقل / الموقع | الاستخدام |
|---|---|
| Settings → Bot → Timezone | المنطقة الزمنية للجدولة؛ يتبع Auto-detect الجهاز المحلي |
| routine → When to run | يعرض الجدولة والمشغّلات نصيًا؛ إذا لم يطابق فاستخدم Edit |
| routine → Webhook | الحقول الثلاثة POST to / key / header، انسخها بالنقر |
| تفاصيل البوت → Details → Routines | إيقاف مؤقت / استئناف، Test، Edit، Delete |
| ملف البوت على الهاتف → Routines | مفتاح Active، وRun history، والحذف بالسحب |
استعراض الدرس التالي
الـ routine يتبع البوت. في الدرس التالي سنحزم البوت المهيأ ونرسله لشخص آخر: قوالب البوت: شارك البوت المهيأ مع فريقك.
ستتعلم:
- Share → Create a copy → Publish → Copy link، أربع خطوات لنشر البوت كقالب
- الرابط العام يكشف identity وdescription وskills وroutines — تحقق قبل النشر
- نصّا رسالتي الخطأ عند إغلاق الفريق لمشاركة القوالب والحلول المقابلة
- الدخول إلى مكتبة القوالب من Connect apps → Bot templates