انتقل إلى المحتوى
Sursa Developers

الكائنات

ChatEventError

خطأ بعد بدء التدفق. ينتهي التدفق بلا done، ولا يُحفظ السؤال في السجل. حين يتوقف مثيل الخادم للتحديث (code = server_restart، retry: true)، تُعلَّم الإجابة على أنها ملغاة ولا تُعَدّ مرة أخرى، لذا يمكنك إرسال الطلب نفسه مرة أخرى دون تغيير.

الحقول

  • type"error"مطلوب
  • codeChatErrorCodeمطلوب
  • messagestringمطلوب
  • retryboolean

    القيمة true تعني أن الإجابة لم تكتمل بسبب الخادم (توقف المثيل للتحديث، code = server_restart)، ويمكنك تكرار الطلب دون تغيير. يغيب مع الرموز الأخرى.

  • answer_idstring

    معرّف كائن الإجابة، إن كانت الإجابة قد أُنشئت بالفعل.

  • detailsobject

    التفاصيل. للرمزين sources_inaccessible وout_of_scope: hidden (عدد المصادر غير المتاحة)، وcan_request (يمكنك طلب الوصول بالعملية POST /v1/access-requests مع answer_id)، وreason (مثل حقل الحدث)، وللرمز out_of_scope أيضًا collections (قائمة CollectionRef حيث توجد الإجابة). وللرمز assistant.unavailable حين يكون المساعد مشغولًا (السبب rate_limited): retry_after، مدة الانتظار قبل إعادة المحاولة بالثواني، كما في 429 answers.engine_busy قبل بدء التدفق. لا يتضمن details رمزًا سابقًا للخطأ.

    الحقول
    • hiddeninteger
    • can_requestboolean
    • reasonstring
    • collectionsarray of CollectionRef
    • retry_afterinteger
  • reasonstring

    رمز السبب لرسالة بلغة الواجهة (قابل للتوسيع، سلسلة نصية حرة). رموز أخطاء المساعد: timeout، وrate_limited، وupstream_unavailable، وlicense_blocked، وlicense_restricted، وforbidden، وcanceled، وinternal، وbad_request، وconflict، وnot_found، وtoo_large، وunprocessable، وnot_implemented، وserver_restart. رموز Sursa: engine_unavailable (المساعد غير متاح)، وengine_closed (أُغلق تدفق المساعد بلا نتيجة)، وsources_inaccessible، وserver_restart (توقف مثيل Sursa للتحديث)، وsources_unavailable (مخفية بسبب مصادر محذوفة أو مؤرشفة)، وout_of_scope (المصادر موجودة فقط خارج المجموعة المختارة)، وsuperseded (مع canceled: حلت محل الإجابة إعادة محاولة بالقيمة request_id نفسها)، وawaiting_classification (مخفية لأن المستند لا يزال قيد المعالجة: لم تُحدَّد فئة الوصول الخاصة به بعد، وتصبح الإجابة متاحة بعد التصنيف، ولا يمكن طلب الوصول، لذا can_request = false). اعرض رسالة بناءً على الرمز. وللرمز غير المعروف، اعرض رسالة عامة بناءً على code؛ أما message فهو احتياطي فقط للعملاء الذين ليست لديهم ترجمات، ولغته غير مضمونة.

جزء من

ChatEvent