إخفاقات الأدوات
أصلح أدوات لا تُستدعى أبدًا، أو تعيد أخطاء، أو تنتهي مهلتها، أو ترسل قيمًا خاطئة، أو تُنفَّذ مرتين.
ما الذي ستحققه
ستعرف ما إذا كانت الأداة تفشل في خدمتك أو في طريقة استخدام الوكيل لها.
ابدأ بالاختبار
في صفحة الأداة، استخدم Save changes ثم Run test بقيم نموذجية. وإذا فشل الاختبار فسيفشل الوكيل بالطريقة نفسها، لذا أصلح ذلك أولًا. راجع اختبر الأدوات وأصلح أعطالها.
الأعراض
| العَرَض | السبب المحتمل | الحل |
|---|---|---|
| لا يستخدم الوكيل الأداة أبدًا | غير مرتبطة، أو أن الوصف مبهم | فعّلها في تبويب Tools الخاص بالوكيل؛ وأعد كتابة وصف الأداة ليذكر بالضبط متى تُستخدم |
| "Missing required parameter(s): …" | لم يجمع الوكيل قيمة مطلوبة | صف المعامل بوضوح؛ وأخبر الوكيل في Instructions أن يطلبها أولًا |
| "Parameter 'x' must be a integer." | نوع خاطئ | أصلح نوع المعامل أو وصفه |
| "The service rejected the request (401 or 403)." | مصادقة خاطئة أو مفقودة | تحقق من بيانات الاعتماد تحت Authentication |
| "The service rejected the request (404)." | عنوان URL أو قيمة مسار خاطئة | تحقق من العنوان ومعاملات المسار |
| "The service did not answer within 5s." | خدمة بطيئة | ارفع Timeout (حتى 30 ثانية) أو استخدم Run in the background |
| "The service returned 5xx" | خدمتك تفشل | أصلحها؛ فتُعاد المحاولة في GET وPUT وDELETE، ولا تُعاد أبدًا في POST وPATCH |
| "Not an allowed address" | عنوان URL خاص أو داخلي | استخدم عنوان https عامًا |
| ينطق الوكيل كتلة JSON خامًا | Read this from the response فارغ | اختر الحقل الذي ينبغي أن يقرأه الوكيل |
| حدث إجراء مرتين | طلب المتصل مرتين، أو أعاد الوكيل المحاولة | اجعل نقطة الاتصال آمنة للتكرار؛ ولا يُعاد POST تلقائيًا أبدًا |
| يعمل في الاختبار ولا يعمل في مكالمة | قدّم الوكيل قيمًا مختلفة | اقرأ نتائج الأداة في النص المكتوب للمكالمة في History |
أدوات التطبيقات المتصلة
الأدوات المنشأة من التكاملات (Calendly وGoogle Calendar وغيرهما) تفشل لمجموعة أسباب مختلفة، مثل انتهاء صلاحية الربط. راجع أخطاء التكاملات.
الاختبار
أجرِ مكالمة ينبغي أن تُشغّل الأداة، ثم افتحها في History وانظر إلى نتيجة الأداة تحت النص المكتوب.
النتيجة المتوقعة
تعرض نتيجة الأداة في History جواب الخدمة، وينطق الوكيل به.
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.