اختبر الأدوات وأصلح أعطالها
جرّب أداة بقيم نموذجية، واقرأ النتيجة، وأصلح المعاملات غير الصالحة وانتهاء المهلة وواجهات API المتعثرة.
ما الذي ستحققه
ستتأكد من أن الأداة تعمل قبل أن يعتمد عليها وكيل.
خطوة بخطوة: اختبار أداة
- افتح الأداة من Tools.
- استخدم Save changes أولًا. تقول صفحة الاختبار "Save first, the test uses the saved version."
- في Test، أدخل قيمة لكل معامل (المطلوبة موسومة بـ
*). - اضغط Run test. تقول النتيجة Succeeded أو Failed، وتعرض المدة بالمللي ثانية، وتعرض ما أعادته نقطة الاتصال (بعد تطبيق Read this from the response) أو الخطأ.
وإذا استغرقت النتيجة أكثر من 300 مللي ثانية تحذّر الصفحة: "Over 300 ms, so the caller hears silence while it runs." فانظر عندها في Run in the background أو نقطة اتصال أسرع.
اقرأ السجلات
في تبويب Logs الخاص بالوكيل، يسرد عرض الأدوات عدد مرات تشغيل كل أداة مرتبطة. ويعرض تبويب API Usage في صفحة Settings استخدام الأدوات والإجراءات عبر مساحة العمل مع النشاط الأخير.
ما يُقال للوكيل حين تفشل أداة
| ما حدث | الرسالة |
|---|---|
| فُقد معامل مطلوب | "Missing required parameter(s): order_id" |
| كانت لقيمة نوع خاطئ أو لم تكن خيارًا مسموحًا | "Parameter 'x' must be a integer." أو "…must be one of: …" |
| العنوان خاص أو داخلي | رسالة بأنه ليس عنوانًا مسموحًا |
| استغرقت الخدمة وقتًا طويلًا | "The service did not answer within 5s." |
| أعادت الخدمة 4xx | "The service rejected the request (404)." لا تُعاد المحاولة. |
| أعادت الخدمة 5xx | "The service returned 502." تُعاد المحاولة في GET وPUT وDELETE فقط. |
| أعادت الخدمة التوجيه | "The service redirected the request, which is not followed." |
استكشاف الأخطاء
- 404 أو 401 في الاختبار. تحقق من العنوان ومعاملات المسار والمصادقة.
- تنتهي المهلة دائمًا. ارفع Timeout (حتى 30 ثانية) فقط إذا كان المتصل يستطيع الانتظار، أو استخدم Run in the background.
- ينجح الاختبار لكن الوكيل لا يستدعيها أبدًا. حسّن الوصف وتعليمات النظام.
- نُفِّذ POST مرة واحدة لكنك توقعت إعادة المحاولة. لا يُعاد POST وPATCH أبدًا، بحكم التصميم.
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.