cicora.ai
مواصفات APIالعمل غير المتزامن

تنفيذ الدفعات

عالج العمليات المستقلة في مجموعات مضبوطة عندما يسمح سير العمل بالتسليم غير المتزامن.

مرجع التكامل: اختر المعلمات والإمكانات المتاحة من إعدادات API لحسابك ومن كتالوج النماذج لبيئتك.

توازٍ محدود

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

وضع الدفعات في الخدمة عقد API منفصل: استخدم مساره ونصه فقط بعد نشرهما في إعدادات الحساب أو المواصفة.

توازٍ محدود يتحكم فيه العميل
typescript
async function runWithLimit(items, limit, work) {
  const results = [];
  for (let offset = 0; offset < items.length; offset += limit) {
    const group = items.slice(offset, offset + limit);
    results.push(...await Promise.all(group.map(work)));
  }
  return results;
}

التحكم في قائمة الانتظار

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

جمع النتائج

اربط النتيجة بمعرّف داخلي واحتفظ بحالة كل مهمة.

لا تُعد محاولة كل المهام تلقائيًا: أعد محاولة الأعطال المؤقتة فقط بعد التحقق من عدم تكرار الأثر عند الإعادة.