معالجة الدفعات

أثرِ أي عدد من الكيانات (entities) بالتوازي مع تتبّع التقدم في الوقت الفعلي، ودمج (fusion) تلقائي متعدد النماذج (models)، والتصدير إلى JSON أو Excel — ضمن حدود حصة الاستخدام لخطتك فقط، وليس حجم دُفعة (batch) ثابتًا.

طرق الإدخال

تدخل الصفوف عبر شريط المصادر أعلى الشبكة — ثلاثة تبويبات، واحد مفتوح في كل مرة. يؤدي تحميل الصفوف إلى طيّ الشريط في سطر واحد («لصق / CSV · تم تحميل 12 صفًا») لتحتفظ الشبكة بارتفاعها؛ انقر على ذلك السطر لتحميل مجموعة مختلفة.

  1. 1لصق / CSV، وملف، ورابط URL — مصدر واحد مفتوح في كل مرة
  2. 2يحصي الزر الصفوف قبل تحميلها
  3. 3عدد الأعمدة المُكتشَف وصفّ العناوين
يُستنتج الفاصل — فاصلة أو مسافة جدولة أو فاصلة منقوطة — وصف الترويسة داخل المتصفح أثناء اللصق، فيتضح أي تخمين خاطئ قبل تحميل أي صف.

لصق / CSV

الصق الصفوف مباشرة من Excel أو Google Sheets أو من ملف CSV مُصدَّر. تُفهَم الفاصلة وعلامة الجدولة والفاصلة المنقوطة جميعًا، ويجوز أن تحتوي الخلية المقتبسة على الفاصل، ويُعامَل الصف الأول على أنه عناوين الأعمدة إن كانت أسماؤه غير رقمية.

ملف

أفلِت ملف .csv أو .tsv أو .json على علامة التبويب، أو اختر ملفًا من القرص. قد يحتوي ملف JSON على مصفوفة كائنات أو كائنًا واحدًا؛ والأعمدة هي اتحاد مفاتيحها، لذا تُحمَّل السجلات غير المتساوية أيضًا.

عنوان URL

اجلب الكيانات من أي نقطة نهاية REST. يُقرأ كل ما يعود كقائمة كائنات حرّة الشكل، ومجموعة الأعمدة هي اتحاد مفاتيحها.

المصادقة المدعومة:

لا شيءرمز Bearerترويسة مفتاح APIالمصادقة الأساسية

إذا أعاد الـ API كائنًا، يفحص النظام مفاتيح مثل data وresults وitems بحثًا عن مصفوفة مضمّنة.

اختيار الكيان والتحقق منه

بعد تحميل الكيانات، تظهر في قائمة قابلة للتحديد مع حالة التحقق. يمكنك اختيار الكيانات التي تريد تضمينها في الدفعة:

تحديد متعدد— حدّد الصفوف واحدًا تلو الآخر، أو استخدم مربّع الرأس لتحديدها جميعًا؛ ويحدّد Ctrl+A كل ما يعرضه عامل التصفية الحالي. أما النقر على صف فيفتح درج نتيجته بدل تغيير التحديد.
التحرير المُضمَّن— انقر نقرًا مزدوجًا على أي خلية إدخال لتصحيح قيمة في مكانها — كل عمود جاءت به بياناتك قابل للتحرير، وليس مفاتيح البحث في المخطط فقط.
التحقق— لا يلزم أن تستخدم صفوفك أسماء حقول المخطط — فالنماذج تقرأها كما هي. الحكم الوحيد الذي تصدره الشبكة هو الفراغ: أي صف لا يحمل أي قيمة على الإطلاق يُوسم ويُعرض باللون الرمادي ويُستبعد من التشغيل. اختر نموذج تصنيف ليتم استبعاد الكيانات ذات النوع الخاطئ تلقائيًا.
المعالجة الانتقائية— تُرسل الكيانات المحددة فقط للإثراء. ألغِ تحديد الكيانات التي لا ترغب في معالجتها.
التحقق من العقد لكل صف— يتحقق الخادم من كل صف مقابل عقد الإدخال الخاص بالمخطط قبل إنفاق أي شيء، ويُبلّغ عن كل صف مخالف بدلًا من التوقّف عند أولها — فتصحّح الدفعة كاملة في مرور واحد.
  1. 1مربعات التحديد في كل صف تقرر ما يُنفق عليه التشغيل
  2. 2يُوسم الصف الفارغ هنا — ويُستبعد من التشغيل
  3. 3‏12 محدَّدًا — لكن 11 فقط قابلة للتشغيل
الصف 11 بلا اسم، ولا يحمل سوى بلد ورمز تداول، ومع ذلك يُثرى كغيره: غياب مفتاح البحث أمر تستطيع النماذج تجاوزه، أما الصف الفارغ فلا. الإدخال والتحقق وحالة التشغيل كلها في صف واحد هنا، لا في ثلاث قوائم منفصلة.

التهيئة

يعكس الشريط الجانبي خيارات إعداد الإثراء الفردي:

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

تقدير التكلفة

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

  1. 1نموذجان: استدعاء واحد لكل منهما، لكل كيان
  2. 2التقدير، ويُعاد حسابه مع تغيّر التحديد
  3. 3‏11 كيانًا، لا الـ12 المحمَّلة — يُسقَط الصف الفارغ
يوضّح الزر ما سيشغّله، فيُقرأ العدد والسعر معًا. وتحت نقطة التوقف الخاصة بالهاتف، تنطوي أدوات الاختيار داخل «خيارات إضافية» ويبقى التقدير بجوار الزر.

التنفيذ المتوازي

تُعالَج جميع الكيانات المحددة في آنٍ واحد. ويمرّ كل كيان عبر مسار الإثراء الكامل بشكل مستقل:

خط معالجة لكل كيان

  1. التصنيف (اختياري) — يتحقق نموذج سريع من نوع الكِيان. في وضع الدُّفعات، لا تُوقِف حالات عدم التطابق المهمة؛ ويُمرَّر السياق.
  2. إثراء متعدد النماذج — يُثري كل نموذج مُحدَّد الكيان على التوازي، مع ضبط وتيرة كلٍّ منها ضمن ميزانية معدّل مفتاحه.
  3. الدمج التلقائي (عند نجاح نموذجين أو أكثر) — تُدمج النتائج تلقائيًا باستخدام اكتشاف التعارضات وحلّها.

ضبط وتيرة المعدّل

تتشارك جميع الكيانات ميزانية المعدّل لكل مفتاح API ونموذج — أي عدد الطلبات والتوكنات في الدقيقة التي يمنحها المزوّد لذلك المفتاح، والمقروءة من استجاباته أو المستنتجة من رفض. فمع 20 كيانًا ونموذجين، تُوزَّع الاستدعاءات إلى نموذج يسمح بـ 15 طلبًا في الدقيقة على مدار الدقيقة بينما يعمل النموذج الآخر بوتيرته الخاصة، فتكتمل الدفعة دون أخطاء 429.

تقدّم آني

يؤدي بدء التشغيل إلى فتح شريط تنفيذ بين شريط الأدوات والشبكة، تغذّيه أحداث Server-Sent Events (SSE): شريط تقدّم واحد للدفعة، وعدّادات منفصلة للمكتمل / الفاشل / المتخطّى بدلًا من رقم واحد مدمج، والوقت المنقضي مع وقت متوقّع للانتهاء مشتق من الصفوف التي استقرّت فعلًا، والإنفاق حتى الآن مقارنةً بالتقدير المسبق. ولا يُفتح شيء فوق الشبكة — تبقى الصفوف حيث تركتها، ويحمل كل صف حالته الخاصة في عمود الحالة إلى جانب الوقت والتكلفة اللذين استغرقهما.

لم يُنفَّذ

لم يمر الصف بأي عملية تشغيل بعد — تعرض خلية «الحالة» شرطةً بدلًا من تكرار نفسها على امتداد العمود.

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

أُدرج في الدفعة، بانتظار متسع في ميزانية معدّل المفتاح.

قيد التشغيل

يفسح العنوان المجال لشريط داخلي يحصي خطوات مجال الخبرة المنجزة من إجماليها.

تم

استجابت كل النماذج. يُملأ عمودا الوقت والتكلفة، وتصبح أعمدة النتيجة قابلة للقراءة.

فشل

لم يُنتج أي نموذج نتيجة لهذا الصف. وبمجرد توقّف الدفعة، يعرض الشريط إعادة المحاولة على الصفوف الفاشلة وحدها.

تم التخطي

استُبعد قبل الإثراء — بسبب عدم تطابق في التصنيف بدرجة ثقة عالية مثلًا — فلم يكلّف الصف شيئًا.

تُصفّي شارات «مكتمل / فاشل / متخطّى» في شريط الأدوات الجدول ليقتصر على تلك الصفوف، ويعرض مفتاح «المدخل / كلاهما / النتيجة» الصفوف نفسها بصيغة ما أرسلته، أو ما عاد إليك، أو كليهما جنبًا إلى جنب.

الإلغاء ومعالجة الأخطاء

يمكنك إلغاء دفعة قيد التشغيل في أي وقت. الإلغاء تعاوني — تُكمل الكيانات الجارية بالفعل استدعاء LLM الحالي، لكن لا تبدأ أي استدعاءات جديدة. تُحفَظ النتائج الجزئية من الكيانات المكتملة.

المرونة تجاه الأخطاء

صُممت معالجة الدفعات لتكون مرنة. لا توقف حالات الفشل الفردية الدفعة:

  • إذا فشل التصنيف لكيان ما، يستمر الإثراء دون سياق
  • إذا فشل نموذج واحد، تستمر النماذج الأخرى لذلك الكيان
  • عند استخدام نموذجين أو أكثر، لا يعمل الدمج التلقائي إلا مع الكيانات التي نجح فيها كل نموذج — فالكيان الجزئي لا ينتج عنه أي نتيجة مدمجة ولا يصل شيء إلى قاعدة بياناتك حتى تتم استعادة النموذج المفقود بإعادة محاولة مجالات خبرته الفاشلة
  • إذا فشلت جميع النماذج لكيان ما، يُوسَم بأنه فاشل بينما تستمر الكيانات الأخرى
  • يُلغى تفعيل النماذج التي تُعيد أخطاء ”غير موجود“ تلقائيًا

صيغ التصدير

بعد اكتمال الدفعة، صدّر النتائج بثلاث صيغ. لكل كيان، يُفضَّل نتيجة الدمج إن كانت متاحة؛ وإلا فتُستخدم نتيجة أفضل نموذج.

ملف JSON

نزّل النتائج الكاملة كملف JSON منظم يحتوي على جميع بيانات الكيانات ومخرجات النماذج وبيانات دمج الوصفية.

الحافظة

انسخ نتائج JSON مباشرة إلى الحافظة للصقها في أدوات أو نصوص برمجية أخرى.

Excel

مصنّف من ثلاث أوراق: النتائج (صف واحد لكل كيان بخصائص مُسطَّحة)، والملخص (بيانات الدفعة الوصفية والنماذج والتكاليف)، والتعارضات (تفاصيل التعارض لكل كيان مع تعليل الحل).

الحدود

الحدالقيمة
الحد الأقصى للكيانات لكل دفعةدون حد أقصى ثابت — ضمن حدود حصة الاستخدام لخطتك
الحد الأقصى لحجم بيانات الكيان50٬000 حرف
الحد الأقصى لطول المُوجِّه100,000 حرف
انتهت مهلة جلب URL30 ثانية

الخطوات التالية

دمج متعدد النماذج

كيف يتم اكتشاف التعارضات بين النماذج وحلّها.

استراتيجيات الإثراء

قارن استراتيجيات التمرير الأحادي مقابل مجالات الخبرة المتعددة.

مرجع API

شغّل الإثراء بالدُّفعات برمجيًا عبر REST API.