تحديد المشكلات الرئيسية في مسارات الوكلاء لتحسين الأداء

لتحسين أداء الوكلاء، يعد تحليل مساراتهم أمرًا ضروريًا. توضح هذه المسارات كل خطوة تم اتخاذها والأسباب الكامنة وراءها، مما يكشف عن تحديات قد لا تنعكس في درجات التقييم. على سبيل المثال، خلال تقييم Dev Proxy، كشفت خمس محاولات لإنشاء نص CI باستخدام Dev Proxy API عن 15 مشكلة مميزة، حيث أجرى كل تشغيل ما بين 29 و39 طلبًا واستهلك ما يصل إلى 1.2 مليون token.

ما الذي يجب البحث عنه في المسار

غالبًا ما يواجه الوكلاء تحديات عند التفاعل مع التكنولوجيا. يمكن ملاحظة الأنماط التالية في مسارات الوكلاء، كما توضحها الأمثلة من تقييم Dev Proxy.

الوكلاء يخمنون عناوين URL قبل البحث

قد يتخطى الوكلاء البحث ويجلبون مباشرة عناوين URL يعتقدون أنها تحتوي على صفحات ذات صلة، مما يؤدي إلى تخمينات خاطئة. على سبيل المثال، حاولت أربع من أصل خمس عمليات تشغيل لـ Dev Proxy الوصول إلى عنوان URL أسفر عن خطأ 404 بسبب اسم صفحة تم تحديده بشكل خاطئ. يشير هذا إلى أن بنية URL المنطقية يمكن أن تضلل الوكلاء رغم ذلك.

تحقق من منتجك: راجع سجلات 404 الخاصة بك بحثًا عن مسارات وثائق قريبة من الوجود، وأدرج عناوين URL للوثائق في مخرجات CLI الخاصة بك لمنع التخمين.

الوكلاء يستكشفون عندما تتوقف واجهتك خطوة واحدة قبل النهاية

قد لا توفر مخرجات المساعدة ورسائل الخطأ المصممة للمستخدمين البشريين إرشادات كافية للوكلاء. على سبيل المثال، عندما استدعى تشغيل نقطة نهاية API دون المعلمات المطلوبة، تلقى خطأ 400 بسبب نقص المعلومات. ثم قام الوكلاء بمزيد من التخمينات، مما استهلك طلبات دون داع.

تحقق من منتجك: تأكد من أن رسائل الخطأ توفر أمثلة صالحة للمدخلات أو قوائم بالقيم المقبولة.

كل تشغيل يعيد اختراع نفس الحل البديل

عندما يفتقر المنتج إلى ميزات ضرورية، ينشئ الوكلاء حلولهم الخاصة. في حالة Dev Proxy، قامت أربع عمليات تشغيل بالاستعلام عن اكتمال المخرجات دون مؤشر واضح على جاهزيتها، مما أدى إلى حلول بديلة غير فعالة.

تحقق من منتجك: تأكد من أن كل عملية تكتمل بعد استدعاء ترجع طريقة لإبلاغ الوكيل باكتمالها.

الوكلاء يملأون الفجوات من الذاكرة

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

تحقق من منتجك: تأكد من أن الوثائق تغطي التكامل مع بيئات التشغيل والأطر الشائعة الاستخدام.

الوكلاء يرفضون الإعدادات الافتراضية المصممة للتشغيل الأول

قد تعيق التكوينات الافتراضية مهامًا محددة. في حالة Dev Proxy، تجنب الوكلاء تكوينًا افتراضيًا كان يحقن أخطاء عشوائية، مما أدى إلى إعدادات غير متسقة.

تحقق من منتجك: وفر إعدادات مسبقة للمهام الشائعة إلى جانب التكوينات الافتراضية.

الوكلاء يثقون بكل ما يعرضه البحث

غالبًا ما يصل الوكلاء إلى الإرشادات عبر محركات البحث، والتي قد تنتج معلومات قديمة. على سبيل المثال، واجه تشغيل وثائق API قديمة لا تعكس متطلبًا حديثًا لـ token.

تحقق من منتجك: تأكد من ذكر متطلبات الإصدار بوضوح في صفحات الوثائق.

الوكلاء يفترضون الإعدادات الافتراضية التي لا يذكرها نص المساعدة

يجب أن يذكر نص المساعدة الإعدادات الافتراضية بوضوح. في Dev Proxy، كان الإعداد الافتراضي يوجه جميع حركة مرور الجهاز عبر proxy، وهو ما لم يكن مذكورًا بوضوح في نص المساعدة، مما أدى إلى آثار جانبية غير مقصودة.

تحقق من منتجك: راجع نص المساعدة للتأكد من أنه يعكس الإعدادات الافتراضية بدقة وكيفية تعطيلها.

أصلح منتجك ووثائقك قبل تنفيذ skill

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

كيف تبدأ قراءة المسارات

افحص المسارات من عمليات التشغيل الناجحة لتحديد الحلول البديلة التي قد تُفهم خطأً على أنها خطوات قياسية. يمكن لأدوات مثل ATIF Preview أن تساعد في تصور المسارات. يظل كل اكتشاف فرضية حتى يتم اختباره مقابل نفس المهام مع الإصلاحات وبدونها لقياس الفعالية.

رابط ذو صلة: aka.ms

 

المصدر: Microsoft Developer Blogs