اختبار الاسترجاع

يجيب الاختبار عن سؤال واحد: هل كان هذا الوكيل سيصل إلى عملية API هذه إذا قال متصل ذلك؟ يُجري الاختبار نفس البحث الذي تُجريه المحادثة الحية، ويعرض لك ما الذي عاد وبأي قوة. إنه اختبار للاسترجاع، وليس اختباراً للتنفيذ، والفرق بينهما يحدد كيف تقرأ النتيجة.

ما تحتاجه

• وكيل مفتوح على تبويب الأدوات الخاص به. الاختبار مرتبط بوكيل واحد، لذلك لا تعرضه صفحة مكتبة الأدوات في مساحة العمل.
• أداة OpenAPI مستوردة حالتها جاهزة، ومختارة على ذلك الوكيل. لا يُبحث في غيرها. لاتصال قاعدة بيانات اختبار خاص به، موصوف في مراجعة أسئلة قاعدة البيانات واعتمادها.

الخطوات

الخطوة 1: افتح الأداة من الوكيل

في تبويب الأدوات على الوكيل، افتح الأداة. تحمل صفحة تفاصيلها تبويب نظرة عامة وتبويب نقاط النهاية، وبعد أن تصبح الأداة جاهزة يظهر أيضاً تبويب الاختبارات.

الخطوة 2: افتح تبويب الاختبارات

يضم تبويب الاختبارات أداة الاختبار، محصورة في هذه الأداة. بعد تسجيل تشغيل، يظهر سطر فوق المربع فيه "✓ تطابق" أو "× لا تطابق" مع العبارة التي شغّلتها.

الخطوة 3: اكتب ما قد يقوله المتصل

يستقبل المربع كلاماً عادياً، وليس اسم نقطة نهاية. النص الظاهر فيه هو "مثال: إمتى أقرب رحلة؟"، والتلميح فوقه يشرح المقصود: "اكتب ما قد يقوله المتصل. سيُجري هذا نفس البحث الدلالي الذي يجريه الوكيل في كل مرة، حتى تتمكن من اكتشاف أي تطابق غير صحيح قبل إطلاقه."

تحت المربع أربع رقائق اقتراحات: "إمتى أقرب رحلة"، و"ألغي حجزي"، و"كم وزن الأمتعة المسموح"، و"غيّر مقعدي". الضغط على إحداها يملأ المربع ويُشغّل الاختبار فوراً.

الخطوة 4: شغّله

اضغط تشغيل بجوار المربع، أو اضغط Enter داخل المربع. يصبح الزر "جارٍ الاختبار…" طوال مدة البحث.

للحصول على أفضل نتيجة

يقارن الاختبار جملتك بوصف العملية، لذلك اكتب الجملة التي سيقولها المتصل فعلاً. كتابة اسم العملية نفسه لا تثبت شيئاً، لأنها تتطابق مع نفسها.

الموصى به

my parcel hasn't turned up and I ordered it last Tuesday

الأقل فاعلية

getOrderShipmentStatus

ماذا يحدث بعد ذلك

يأخذ إيكونوڤا الأدوات المختارة على هذا الوكيل، ويُبقي منها عمليات OpenAPI المستوردة التي حالتها جاهزة، ثم يضيّق القائمة إلى الأداة التي فتحتها، ويعيد العمليات الأقرب إلى نصك. ما يعود قائمة مرتبة بالدرجات، وليس استدعاءً.

تحت النتائج يعرض كل صف رمز أعمدة الإشارة، وطريقة HTTP، ومسار العملية، والأداة التي تنتمي إليها، ودرجة كنسبة مئوية. الدرجة تشابه مُقرَّب إلى عدد صحيح ومحصور بين 0 و100. وهي تقيس المسافة بين صياغتك ووصف العملية. إنها ليست احتمالاً، ولا يمكن مقارنتها بين استعلامات مختلفة.

لا شيء تحت الحد الأدنى يُعد نتيجة في حد ذاته، والاختبار يقول ذلك: "لا يوجد تطابق يتجاوز الحد الأدنى المحدد. سيطرح الوكيل سؤالاً توضيحياً بدلاً من استدعاء نقطة نهاية."

ما لا يفعله الاختبار

• لا يستدعي واجهة API الخاصة بك. لا يصل أي طلب إلى عنوان العملية، ولن تظهر شيئاً في سجلات خادمك.
• لا يرسل أي معاملات. تعطيه كلاماً وليس متن طلب، ولا تُملأ أي معاملات.
• لا يستخدم نموذج اللغة الخاص بالوكيل. المطابقة تقارن نصوصاً، ولا يدخل النموذج الذي اخترته للوكيل في الأمر.
• لا ينشئ محادثة. لا تُفتح جلسة ولا يُسجَّل أي دور، فلا يظهر شيء ضمن محادثات الوكيل.
• لا يستهلك أي رصيد. تُحتسب الأرصدة على الأدوار في المحادثة الحية، والتشغيل في الاختبار ليس دوراً.

لذلك النتيجة الخضراء تعني أن الوكيل سيصل إلى العملية، ولا تعني أن العملية تعمل. المصادقة وعنوان الأساس وشكل الطلب وسلوك نقطة النهاية نفسها كلها غير مختبرة هنا. تحقق منها بشكل منفصل، ثم تحدّث مع الوكيل في ساحة التجربة لترى الجزأين يعملان معاً.

الحد نفسه يسري بالعكس على الأنواع التي لا يُبحث فيها أبداً. أداة Webhook أو التكامل أو النظام أمام الوكيل في كل دور، فلا يوجد قرار استرجاع تختبره، ولا يقيّمها الاختبار.

ما يسجله التشغيل

تُحفظ نتيجة التشغيل لكل أداة: هل تطابقت، وأعلى درجة، والاستعلام الدقيق، والوقت. تُحدَّث فقط الأدوات التي بُحث فيها، فالتشغيل المحصور يترك نتائج الأدوات الأخرى كما هي.

تراها في مكانين بعد ذلك.

النتيجة تبقى بعد إعادة التحميل، وتنتمي إلى الوكيل الذي شغّلها. ما يُبحث فيه يعتمد على ما اختاره ذلك الوكيل، لذلك قد تظهر الأداة نفسها لوكيل ولا تظهر لوكيل آخر.

الحدود

عدد النتائج والدرجة التي يجب أن تبلغها غير قابلين للتعديل من البوابة حالياً.

استكشاف الأخطاء وإصلاحها

"تعذّر تشغيل الاختبار."

فشل التشغيل بدلاً من أن يعيد نتيجة فارغة. أعد المحاولة مرة واحدة. إذا استمر الفشل، انتظر لحظة ثم حاول مجدداً: فالأداة التي انتهى استيرادها للتو قد لا تكون قابلة للبحث بعد.

النتيجة فارغة لكل استعلام، بما في ذلك الاقتراحات

لم يُبحث في شيء. تحقق من أمرين بالترتيب: حالة الأداة جاهزة وليست جارٍ الاستيراد أو فشل، وأن الأداة مختارة على هذا الوكيل وليست موجودة في مكتبة مساحة العمل فقط. التشغيل الذي لا يوجد فيه ما يُبحث عنه يعيد نتيجة فارغة وليس خطأ، وهذا يبدو تماماً كتطابق سيئ.

لا يوجد تبويب الاختبارات

الاختبار متاح لأدوات OpenAPI المستوردة التي حالتها جاهزة ومفتوحة من وكيل. أداة Webhook أو التكامل أو النظام ليس لها خطوة استرجاع تُختبر. أما اتصال قاعدة البيانات فله اختباره الخاص، ولا يظهر إلا بعد صياغة أسئلته.

الاختبار يطابق لكن الوكيل لا يستدعي العملية

الاسترجاع هو إحدى البوابتين. ظهرت العملية، إذن الصياغة سليمة؛ ما تبقى هو قرار الوكيل وحالة العملية نفسها. تحقق من أن العملية مُفعّلة، وأن وصفها يذكر متى ينبغي استخدامها.

الدرجة تبدو منخفضة لكن الوكيل يتصرف بشكل صحيح

تعامل مع النسبة المئوية كأداة للترتيب، وليست علامة نجاح. المهم هو هل العملية التي تتوقعها موجودة في القائمة وأعلى من التي لم تتوقعها.

الأسئلة الشائعة

هل يكلّف تشغيل الاختبار شيئاً؟

لا. لا يسجل أي دور ولا يستهلك أي رصيد.

هل يصل الاختبار إلى نقطة النهاية الخاصة بي؟

لا. يبحث في أوصاف عملياتك، وليس في العمليات نفسها.

لماذا لا تظهر أداة Webhook الخاصة بي في النتائج؟

لأنها لا تُبحث أبداً. أدوات Webhook والتكامل والنظام أمام الوكيل في كل دور، لذلك لا تُرتَّب ولا تحمل درجة.

هل يمكنني اختبار كيف يختار الوكيل بين أداتين؟

ليس من تبويب الاختبارات، لأنه يُحصر دائماً في أداة واحدة. تحدّث مع الوكيل في ساحة التجربة بدلاً من ذلك، حيث تتنافس كل أدواته كما تتنافس في محادثة حقيقية.

هل تتغير النتيجة المسجلة إذا عدّلت الأداة؟

لا. تحتفظ بنتيجة آخر تشغيل واستعلامه. شغّل الاختبار مرة أخرى بعد أي تعديل لتحديثها.

هل تنتقل نتائج الاختبار إلى وكيل آخر؟

لا. النتيجة تنتمي إلى الوكيل الذي شغّلها، لأن ما يُبحث فيه يعتمد على الأدوات المختارة لذلك الوكيل.

صفحات ذات صلة

• أدوات OpenAPI: استورد الواجهة التي يبحث فيها هذا الاختبار
• عمليات أداة OpenAPI: أصلح الوصف الذي تشير إليه الدرجة المنخفضة
• مراجعة أسئلة قاعدة البيانات واعتمادها: الاختبار نفسه لقاعدة بيانات
• اختبر وكيلك: الجزء الآخر، في محادثة حقيقية
• نظرة عامة على الأدوات: أي أنواع الأدوات يُبحث فيها وأيها لا يُبحث فيه