أوصاف ومخططات يقرؤها النموذج فعلًا
الأداة ذات الوصف السيئ أسوأ من غيابها
يستحق هذا أن يُقال صراحة لأنه يعكس الميل المعتاد إلى إضافة القدرات. الأداة التي لا يملكها الوكيل الذكي (Agent) تُنتج فشلًا نظيفًا: لا يستطيع القيام بالأمر، فيقول ذلك، وتتعلّم أنت شيئًا. أما الأداة ذات الوصف الغامض أو الخاطئ بشكل خفي فتُنتج سوء استخدام واثقًا — تُستدعى في مواقف خاطئة، وبمعاملات معقولة لكنها غير صحيحة، ويُوثق بها لأنها أعادت شيئًا. وتظهر الإخفاقات الناتجة كأنها مشكلات استدلال، فيُحقَّق فيها على أنها مشكلات استدلال، ولهذا تبقى شهورًا. قبل إضافة أداة، اسأل: هل يمكنك وصفها بدقة تكفي لأن يستخدمها مهندس كفء جديد لا يصل إلى الكود استخدامًا صحيحًا في كل مرة؟ إن لم يكن، فإما أن تصلح الوصف أو لا تطلق الأداة، لأن النسخة التي توشك على إطلاقها ستُنتج عملًا لا يمكنك الوثوق به.
- الأداة المفقودة تفشل بنظافة؛ والأداة الموصوفة خطأً تفشل بثقة
- سوء الاستخدام الناتج عن الأوصاف السيئة يظهر كفشل استدلال ويُشخَّص خطأً لشهور
- المعيار: مهندس كفء لا يصل إلى الكود يستخدمها صحيحًا في كل مرة
- إن لم تبلغ هذا المعيار، أصلح الوصف أو لا تطلق الأداة
اكتب الوصف للاختيار أولًا، ثم للاستخدام
للوصف مهمتان، ومعظم الأوصاف لا تؤدي إلا الثانية. عليه أولًا أن يساعد النموذج على أن يقرر هل هذه هي الأداة المناسبة الآن، ما يعني أن يذكر متى تُستخدم، والأثمن من ذلك متى لا تُستخدم — بما في ذلك أي أداة شقيقة تُفضَّل في الحالة المجاورة. ثم عليه أن يدعم الاستدعاء الصحيح: ماذا تفعل الأداة في العالم، وماذا تعيد، وكم تكلّف أو كم تستغرق إن كان ذلك يجب أن يؤثر في الاختيار، وأي شرط مسبق يجب أن يتحقق. أضف مثال استدعاء قصيرًا لكل ما له أشكال معاملات غير بديهية. واكتبه بنثر تقريري واضح لا برموز مقتضبة، لأنه يُقرأ بوصفه لغة. وحين تلاحظ سوء استخدام منهجيًا في التشغيل الفعلي، فالوصف هو أول مكان لإصلاحه، قبل تعليمات النظام (System prompt).
- اذكر متى تُستخدم ومتى لا تُستخدم، مع تسمية الأداة الشقيقة المفضّلة بدلًا منها
- غطِّ الأثر في العالم، وشكل القيمة المُعادة، والتكلفة أو زمن الاستجابة إن كان يؤثر في الاختيار، والشروط المسبقة
- أضف مثال استدعاء حيثما كانت أشكال المعاملات غير بديهية
- أصلح سوء الاستخدام المنهجي في وصف الأداة قبل المساس بتعليمات النظام
مخططات تمنع خطأ المعاملات
ثاني أكثر إخفاقات الوكلاء شيوعًا بعد اختيار الأداة الخطأ هو اختيار الأداة الصحيحة بمعاملات خاطئة، والمخطط هو المكان الذي يُمنع فيه معظم ذلك. استخدم قائمة قيم محددة (enum) حيثما جاءت القيمة من مجموعة ثابتة، لأن النص الحر يدعو إلى الاختلاق. صِف كل حقل، بما في ذلك الحقول التي تبدو بديهية، فالتاريخ والمبلغ والمعرّف هي بالضبط الحقول التي تُملأ بصيغة خاطئة معقولة. كن صريحًا بشأن الصيغ والوحدات في وصف الحقل بدل افتراض اصطلاح ما. وعلّم الحقول الإلزامية بأنها إلزامية بدل تعيين قيمة افتراضية بصمت، كي يفشل الإغفال بصوت عالٍ عند الحد بدل المضي بافتراض. وتحقّق قبل التنفيذ، وأعِد خطأً محددًا قابلًا للتصحيح — الحقل يتوقع إحدى هذه القيم وتلقّى تلك — يستطيع النموذج التصرف بناءً عليه في خطوة واحدة.
- استخدم قوائم قيم محددة للمجموعات الثابتة؛ النص الحر يدعو إلى اختلاق القيم
- صِف كل حقل، خصوصًا التواريخ والمبالغ والمعرّفات
- اذكر الصيغ والوحدات صراحة بدل الاعتماد على الاصطلاح
- تحقّق قبل التنفيذ وأعِد رسالة محددة قابلة للتصحيح
كيف ينطبق هذا عليّ؟
يختار وكيل الذكاء الاصطناعي (AI agent) أفعاله من قائمة قدرات موصوفة، وجودة تلك الأوصاف تحدد إلى حد كبير هل يختار الفعل الصحيح. وكثير من أخطاء الاستدلال الظاهرة هي في الحقيقة نظام وصف أدواته وصفًا سيئًا.
- يختار الوكلاء أفعالهم من أوصاف كتبها مهندسون، لا من فهمٍ لأنظمتك
- إضافة مزيد من القدرات إلى مساعد قد تجعله أقل دقة لا أكثر
- الفعل الخاطئ الواثق كثيرًا ما يكون أداة موصوفة خطأً لا نموذجًا مرتبكًا
أوصاف الأدوات سياق يعامله النموذج على أنه موثوق، ما يجعلها سطحًا للجودة وسطحًا لسلسلة التوريد معًا حين تأتي من خوادم طرف ثالث. فالسؤال الهندسي والسؤال الأمني يلتقيان عند الشيء نفسه.
- اطلب رؤية أوصاف الأدوات كما تُرسل — إنها محتوى تعليمات (Prompt) لا توثيق
- قوائم أدوات الطرف الثالث تصل بأوصاف لم يكتبها فريقك ولم يراجعها
- المعاملات ذات القيم المحددة والمعرّفات المُتحقَّق منها تضيّق سوء الاستخدام والإساءة معًا
- سجلّ لكل أداة مسجّلة مع مالك لها أمر معقول يمكن توقعه
عامِل الأوصاف والمخططات ككود إنتاج: تُراجع، وتُدار نسخها، وتُغيَّر عن قصد. وحين ترى سوء استخدام منهجيًا في سجلات التتبّع، فالإصلاح يكون غالبًا في تعريف الأداة، لا في تعليمات النظام التي تلجأ إليها الفرق أولًا بحكم الغريزة.
- كل حقل موصوف، والمجموعات الثابتة محددة القيم، والصيغ والوحدات مذكورة
- اذكر متى لا تُستخدم الأداة وأي أداة شقيقة تُفضَّل بدلًا منها
- تحقّق من المعاملات قبل التنفيذ وأعِد أخطاء محددة قابلة للتصحيح
- تابع معدلات الاختيار وأخطاء المعاملات لكل أداة؛ فهي تخبرك أي وصف تعيد كتابته
ينسب العملاء إخفاقات الوكلاء إلى النموذج على نحو ثابت، ويلجؤون إلى الترقية. أما المراجعة المنظّمة لأوصاف الأدوات ومخططاتها فرخيصة وسريعة، وتحلّ نسبة كبيرة من تلك الشكاوى دون تغيير أي شيء مكلف.
- نفّذ مراجعة لتعريفات الأدوات قبل التفكير في أي تغيير للنموذج
- ابحث عن الأدوات المتداخلة أولًا — فهي تسبب سوء اختيار يبدو كضعف في الاستدلال
- اترك وراءك معيارًا للأوصاف وخطوة مراجعة، لأن قوائم الأدوات تستمر في النمو
- سمِّ مالكًا لسجلّ الأدوات قبل انتهاء المهمة الاستشارية