استكشاف الأخطاء وإصلاحها
حدد ما إذا كانت المشكلة تكمن في الوصول إلى الاتصال أو أذونات الأداة أو الخدمة الأولية.
تُرجم آليًا من الإنجليزية. اقرأ النص الأصلي بالإنجليزية
2 دقيقة للقراءة · دليل العملاء
ابدأ بتحديد مرحلة الفشل: إضافة الاتصال أو اكتشاف الأدوات أو تشغيل أداة واحدة أو التحقق من الكتابة. التقط الوقت ووصفًا موجزًا قبل تغيير الإعدادات.
لا يمكن الوصول إلى الاتصال#
تحقق من نقطة النهاية المعينة بالضبط وما إذا كان عميل الذكاء الاصطناعي يدعم طريقة النقل والمصادقة الخاصة به. عنوان منزل النظام الأساسي ليس نقطة نهاية MCP. استخدم الاتصال الآمن العادي؛ لا تتجاوز تحذير الشهادة.
إذا كان نفس الاتصال المعين يعمل سابقًا، فأبلغ عن آخر مرة نجح فيها وما الذي تغير في العميل. تجنب حذف تفاصيل اتصال العمل قبل التحقق من الاستبدال.
مرجع الخطأ#
| أعراض | ما يجب التحقق منه |
|---|---|
401 عند الاتصال أو الاكتشاف | بيانات الاعتماد مفقودة أو خاطئة أو منتهية الصلاحية أو ملغاة؛ رأس أو نقطة نهاية غير صحيحة. |
403 لإجراء عملية جراحية | نطاق الاعتماد أو إذن الأداة أو دور الخدمة الأولية؛ تحديد الطبقة التي أعادتها. |
429 | تم تجاوز بدل الطلب؛ احترام تأخير إعادة المحاولة وتقليل تكرار الطلب. |
404 | قد تكون نقطة النهاية أو السجل المشار إليه خاطئًا أو غير متاح؛ تحقق من المسار والسياق الدقيقين. |
5xx أو غير متوفر | مشكلة النظام الأساسي أو الخدمة الأولية؛ التقاط الوقت ومرحلة الطلب. |
| وسائط غير صالحة | حقل مطلوب أو نوع الإدخال أو حقل إضافي غير مدعوم أو معرف غير متطابق. |
| متصل ولكن لا توجد أداة متوقعة | النطاق المخصص، أو الإضافة غير النشطة أو التي لم يتم التحقق منها، أو اكتشاف العميل الذي لا معنى له. |
| تظهر الأدوات ولكن تفشل المكالمات | الترخيص الأولي أو استحقاق الحساب أو المدخلات الخاصة بالعملية. |
هذه هي نقاط البداية التشخيصية. المصدر الفعلي لخطأ HTTP مهم؛ لا يتم إصلاح خطأ إذن الخدمة عن طريق إضعاف مصادقة MCP.
تسلسل تشخيصي آمن#
قم بتأكيد نقطة النهاية، وقم بتحديث قائمة الأدوات، وقارنها بعملية التسليم، وقم بإجراء اختبار القراءة فقط المتفق عليه. إذا فشلت، سجل اسم الأداة والخطأ المنقح. توقف قبل تكرار إجراء الكتابة الذي تكون نتيجته غير مؤكدة.
ما لإرسال الدعم#
استخدم قائمة مراجعة الدعم. أرفق لقطة شاشة أُخفيت منها المعلومات السرية أو نص الخطأ ذي الصلة، وليس تصديرًا كاملًا للمحادثة أو ملف إعدادات يحتوي على مفتاح.