من الطلب إلى التحقيق والدعم
- افتح الطلبات في مساحة العمل المالكة للطلب. ابحث عن Request ID وحدد الصف.
- افتح التفاصيل الكاملة في صفحة مستقلة. تعيد العودة إلى القائمة عوامل التصفية. لا يمنح الرابط صلاحية الوصول إلى مساحة أخرى؛ استخدم حسابًا مخولًا.
- إذا كانت الحالة معلقة أو غير معروفة، حدّث التقدم أولًا. عند فشل الطلب أو انقطاع الرد، استخدم إجراء التحقيق المتاح لبدء التحقيق في Agent داخل التطبيق. لا يُعاد إرسال الطلب الأصلي للنموذج. لا تحتاج الطلبات الناجحة إلى تحقيق افتراضيًا.
- إذا احتجت مساعدة، اختر الدعم البشري من الطلب أو التحقيق. راجع المعاينة وروابط الطلب والمحادثة عندما تكون متاحة، واحذف المحتوى الخاص، ثم أرسل صراحة. بدء التحقيق أو فتح المعاينة وحده لا يرسل طلب دعم.
- احتفظ بتأكيد الإرسال وتابع المحادثة نفسها في الدعم للردود والمعلومات الإضافية بدل إنشاء طلبات مكررة.
المعرفات العامة التي يجب التقاطها
لا تخزن معرفات مهام المزود، عناوين URL الخاصة بالمزود، معرفات المزود، مفاتيح Redis، أو بيانات التنفيذ الحساسة كسجلات ظاهرة للعملاء.
ما يجب تسجيله
سجل ما يكفي لتشخيص الطلب دون تسريب الأسرار:- نقطة النهاية، طريقة HTTP، النموذج، رمز الحالة، الطابع الزمني، والكمون.
- المعرفات العامة:
request_id،task_id،poll_url، وbilling_transaction_idعند وجودها. - شكل الطلب المنقح: أي الحقول كانت موجودة، وليس النص الكامل أو محتوى الوسائط الخاصة.
- استجابات الحالة غير المتزامنة النهائية، بما في ذلك حقول الخطأ العامة.
- عدد محاولات إعادة الاتصال من العميل وما إذا كانت إعادة الاتصال قد أنشأت مهمة جديدة أو استأنفت واحدة موجودة.
Authorization، مفاتيح API، رموز الإدارة، عناوين URL الموقعة، عناوين URL الوسائط الخاصة، النصوص الكاملة، وبيانات المستخدم الشخصية ما لم يكن لديك إذن صريح للاحتفاظ بها.
مصفوفة استكشاف الأخطاء
تسوية الاستخدام
استخدم واجهة إدارة API للتسوية من جانب الخادم:GET /v1/management/api-keys/{keyId}/usage يمكن أن يقوم بالتصفية حسب scene، model، modelVendor، startDate، و endDate. استخدم هذه السجلات بدلاً من جمع بيانات صفحات لوحة التحكم أو الاعتماد على معرفات مهام المزود العلوية.
قد تستقر الاستجابات المتدفقة بعد إرسال التدفق، لذا قد يكون رأس الفوترة غائبًا حتى عندما يتم تسجيل الاستخدام لاحقًا. قد تستقر المهام الإعلامية غير المتزامنة بعد الاستعلام النهائي.
قالب حزمة الدعم
عند الاتصال بالدعم، قم بتضمين:request_id.task_idوpoll_urlللعمل غير المتزامن.billing_transaction_idعند وجوده.- نقطة النهاية، الطريقة، النموذج، الطابع الزمني، ورمز الحالة.
- شكل الطلب المنقح وجسم الخطأ العام.
- النتيجة المتوقعة وما رآه المستخدم فعليًا.
الفحوصات التشغيلية
- تنبيه على تكرار الاستجابات
401،402،429، و5xxبشكل منفصل؛ عادةً ما يكون لها مالكون مختلفون. - تتبع المهام غير المتزامنة التي تبقى غير نهائية لفترة أطول من SLA المنتج الخاص بك.
- تتبع محاولات الإنشاء المكررة لنفس معرف وظيفة المستخدم.
- عيّن عينة من الوظائف المكتملة وتحقق من أن الأصل المرئي للمستخدم، سجل الاستخدام، وسجل المهمة المخزنة تتفق.