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

استخدم هذا الدليل عندما تحتاج إلى فهم ما يحدث بعد إرسال مهمة توليد صورة أو فيديو أو صوت في Rivya.

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

حالات المهمة الحقيقية

تستخدم دورة حياة التوليد غير المتزامن الحالية أربع حالات مرئية:

WAITING
GENERATING
SUCCESS
FAILED

تخزن هذه الحالات على ai_task ويعاد استخدامها عبر Studio والسجل ولوحة التحكم وتدفق الإشعارات.

ماذا يحدث عند الإرسال

1. تتحقق Rivya من الطلب

قبل أن يصل أي شيء إلى المزود، تفحص Rivya:

هل النموذج موجود
هل التوليد المباشر مفعل لذلك النموذج
هل وقت التشغيل قائم على مهمة غير متزامنة
هل طول المطالبة صالح
هل معاملات الاستمارة مطبعة
هل الملفات المرجعية تطابق ما يقبله النموذج

لبعض النماذج قواعد إضافية. مثلا، يتطلب عزل الصوت ملف صوت مرفوعا مع تحقق من المدة.

2. تنشئ Rivya سجل المهمة

تنشئ Rivya إدخال ai_task أولا، بحالة WAITING.

يحفظ ذلك السجل النموذج، والفئة، والمطالبة، وparams، والأرصدة المحجوزة، ونوع الفوترة، ولاحقا النتيجة أو حالة الفشل.

3. تستهلك الأرصدة قبل إرسال المزود

هذا مهم: في التوليد غير المتزامن، تنفق Rivya أرصدة المهمة قبل إرسال المهمة إلى الخدمة الأعلى.

إذا كانت الأرصدة منخفضة جدا:

تعلم المهمة كفاشلة
لا تستدعى الخدمة الأعلى أبدا
يمكن إنشاء إشعار بنقص الرصيد

4. تنشأ مهمة المزود

إذا كانت الأرصدة متاحة، ترسل Rivya المهمة إلى الخدمة الأعلى المطابقة وتحفظ معرف المهمة الأعلى.

عند تلك النقطة تنتقل الحالة إلى GENERATING.

كيف تعرف Rivya النتيجة

تدعم Rivya مساري اكتمال:

رد نداء من المزود في البيئات التي تدعم رد النداء
تحديث الحالة والاستطلاع عندما لا يكون اكتمال رد النداء متاحا

يتحقق مسار رد النداء أيضا من توقيع webhook قبل إنهاء المهمة.

إذا وصل رد النداء قبل أن تكون نتيجة المزود جاهزة بالكامل، يمكن أن تؤجل Rivya وتحاول مرة أخرى عبر فحص الحالة الأعلى.

مسار Success

عند النجاح، تقوم Rivya بـ:

تخزين روابط النتائج
ضبط الحالة على SUCCESS
تسوية المهمة
جعل الناتج متاحا في سجل التوليد
إنشاء إشعار نجاح التوليد

لهذا تبقى صورة أو فيديو مكتمل مرئيا بعد مغادرتك الصفحة.

مسار Failure

عند الفشل، تقوم Rivya بـ:

تخزين رسالة الخطأ
ضبط الحالة على FAILED
رد الأرصدة عندما حدث الفشل بعد الحجز ويجب عكسه
إنشاء إشعار فشل التوليد للمراجعة الدائمة

هذا مختلف عن toast مؤقت. يصبح الفشل جزءا من سجل الحساب.

أين ترى حالة المهمة

يمكن أن تظهر المهمة نفسها في عدة أماكن:

Studio النشط أثناء تشغيلها
History بعد استقرارها
Notifications Center للنتائج الكبرى
/dashboard في التوليدات الأخيرة

هذه الحالة المشتركة أحد أسباب شعور المنتج بأنه متماسك بدلا من أن يكون مؤقتا.

كيف يختلف Chat

المحادثة قابلة للفوترة أيضا، لكنها لا تستخدم سجل المهمة غير المتزامنة نفسه. تحفظ أدوار Chat كـ:

جلسات دردشة
رسائل دردشة

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

لذلك القاعدة العامة هي:

توليد الصورة والفيديو والصوت يستخدم ai_task
تستخدم الدردشة الجلسات المحفوظة والتسوية على مستوى الرسائل

اقرأ بعد ذلك

قائمة فحص حالة المهمة

عندما يكون التوليد مربكا أو بطيئا أو فاشلا أو مفقودا، تحقق مما يلي:

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

أعد الفحص قبل التشغيل مرة أخرى

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

دليل دورة حياة المهام في Rivya