الجداول الزمنية وخطافات الويب

يجيب الوكيل عادةً عندما يسأله أحد: في لوحة التحكم، أو عبر الواجهة البرمجية، أو أداة الموقع، أو تيليجرام. أما الجداول الزمنية وخطافات الويب فتشغّله دون أن يسأله أحد، للأعمال المتكررة أو التي يبدؤها نظام آخر.

أعِدّها من صفحة الوكيل ← Schedules & webhooks. ويمكن أن يكون للوكيل الواحد ما يصل إلى 10 منها.

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

الجداول الزمنية

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

1. انقر على + Schedule.
2. سمِّه، واكتب ما تريد أن تطلبه من الوكيل.
3. اختر موعد التشغيل: اختر أحد الإعدادات الجاهزة، أو اكتب تعبير cron.
4. اختر المنطقة الزمنية التي تُحسب بها الأوقات.

يتكون تعبير cron من خمسة حقول: الدقيقة الساعة يوم-الشهر الشهر يوم-الأسبوع.

التعبير	موعد التشغيل
0 6 * * *	كل يوم الساعة 06:00
0 6 * * 1-5	أيام العمل (من الاثنين إلى الجمعة) الساعة 06:00
0 9 * * sun	كل يوم أحد الساعة 09:00
30 */4 * * *	كل 4 ساعات، عند الدقيقة 30
0 8 1 * *	اليوم الأول من كل شهر الساعة 08:00

لا يمكن أن يعمل الجدول الزمني أكثر من مرة كل 15 دقيقة. وتعرض الصفحة موعد التشغيل التالي.

خطافات الويب

يمنح خطاف الويب الوكيلَ عنوان URL سريًّا. وعندما يرسل نظام آخر طلب POST إليه، يعمل الوكيل بتعليماتك متبوعةً بما أُرسل، مثل تذكرة جديدة، أو عملية بناء فاشلة، أو ملاحظة أمنية.

1. انقر على + Webhook.
2. سمِّه، واكتب ما تريد أن تطلبه من الوكيل. ويُضاف بعده ما يستقبله الخطاف.
3. انسخ العنوان. لا يُعرض إلا مرة واحدة. ويستطيع كل من يملكه تشغيل الوكيل، فاحفظه سرًّا كما تحفظ كلمة المرور.

وجِّه النظام الآخر إلى هذا العنوان، أو جرّبه من الطرفية:

curl -X POST 'https://api.eu.backcrew.ai/v1/hooks/bkh_…' \
  -H 'Content-Type: application/json' \
  -d '{"ticket": "OPS-42", "title": "Disk full on web-1"}'

• يمكن أن يكون محتوى الطلب أي نص، وغالبًا ما يكون JSON. ويُمرَّر إلى الوكيل ما يصل إلى 16,000 حرف منه.
• يجيب العنوان فورًا بـ 202 Accepted، ويعمل الوكيل في الخلفية. وتجد إجابته في سجل نشاط الوكيل.
• يقبل خطاف الويب ما يصل إلى 30 طلبًا في الدقيقة.
• إذا احتمل تسرّب العنوان، فانقر على New URL: إذ يتوقف العنوان القديم عن العمل فورًا.

متابعة عمليات التشغيل

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

يشغّله Run now فورًا بتعليماته ويعرض الإجابة، ويُحتسب كأي تشغيل آخر.

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

أوقف أيًّا منها بمفتاحه: فيحتفظ بإعداداته وعنوانه، ولا يعمل حتى تعيد تشغيله. وحذف الوكيل يحذف جداوله الزمنية وخطافاته.

جدول زمني أم خطاف ويب أم واجهة برمجية؟

تشغّل الطرق الثلاث الوكيلَ نفسه وبالتكلفة نفسها. ويكمن الفرق في ما يبدأ تشغيل الوكيل، وفي ما إذا كان أحدٌ ينتظر الإجابة.

	الجدول الزمني	خطاف الويب	الواجهة البرمجية العامة
ما يبدأ التشغيل	الوقت المحدد	نظام آخر يرسل طلب POST إلى عنوانه السري	شيفرتك الخاصة
ما يُطلب من الوكيل	تعليماتك الثابتة	تعليماتك الثابتة متبوعةً بما أُرسل	ما ترسله شيفرتك في كل مرة
من يتلقى الإجابة	لا أحد ينتظرها: تجدها في سجل نشاط الوكيل	لا أحد ينتظرها: يجيب العنوان فورًا بـ 202، وتجد الإجابة في سجل نشاط الوكيل	شيفرتك: ضمن الاستجابة، أو لاحقًا عبر تشغيل تستعلم عنه أو استدعاء راجع موقَّع
التحقق من الهوية	لا شيء، إذ يعمل داخل backcrew	العنوان نفسه هو السر	مفتاح API يصلح لجميع وكلاء مساحة العمل
المحادثة	محادثة واحدة لكل جدول زمني: ومع تفعيل الذاكرة، يمكنه تذكّر عمليات التشغيل السابقة	محادثة واحدة لكل خطاف ويب، بالطريقة نفسها	تحددها أنت عبر session_id وuser_id، كأن تخصص محادثة لكل عميل
تشغيلان في وقت واحد	لا يحدث أبدًا: يُتخطّى التشغيل الذي يتداخل مع سابقه	لا يحدث أبدًا، بالطريقة نفسها	نعم، بالتوازي
الأعمال الطويلة	لا مشكلة، حتى الحد الزمني للوكيل	لا مشكلة، حتى الحد الزمني للوكيل	ابدأ تشغيلًا: فقد تنتهي مهلة الطلب الواحد الذي يستغرق أكثر من 100 ثانية

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

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

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