تصميم الأدوات هو تصميم واجهات API
مستهلكك لا يستطيع طرح الأسئلة
الأداة واجهة API مستهلكها الوحيد نموذج يقرأ التوثيق مرة واحدة، ولا يستطيع التجريب بأمان، ولا يستطيع قراءة الكود، ولن يعود ليسأل عن معنى معامل غامض. سيخمّن، بثقة وباتساق في الاتجاه الخطأ إن كانت التسمية تدعوه إلى ذلك. يغيّر هذا القيد قواعد التصميم بطرق محددة. فالغموض الذي يحسمه مطوّر بشري في ثلاثين ثانية يصبح نمط فشل دائمًا. والاتساق عبر مجموعة الأدوات أهم من أناقة أي أداة بمفردها، لأن النموذج يعمّم من أداة إلى التي تليها. وتكلفة الأداة السيئة تُدفع في كل تشغيل إلى الأبد، ما يجعل تصميم الأدوات من أعلى الأعمال أثرًا في النظام كله، ومن أكثرها إهمالًا في الاستثمار على الدوام.
- المستهلك يقرأ مرة واحدة، ولا يستطيع التجريب، ولن يطلب توضيحًا أبدًا
- الغموض الذي يحسمه مطوّر بشري في ثوانٍ يصبح نمط فشل دائمًا
- الاتساق عبر مجموعة الأدوات يتفوّق على أناقة أي أداة منفردة
- الأداة السيئة تكلّف في كل تشغيل، ولهذا يعود هذا العمل بمردود غير متناسب
دقة التقسيم: طابِق وحدة القصد
اتجاها الفشل شائعان بالقدر نفسه. الأدوات المفرطة في التجزئة تجبر النموذج على تركيب سلاسل طويلة من العمليات الأولية، وكل خطوة تركيب فرصة أخرى للخطأ — فالوكيل الذي يجب أن يستدعي ست أدوات لتحديث سجل سيستدعي خمسًا فقط في مرة ما. والأدوات المفرطة في الشمول تأخذ تعليمات بنص حر وتنفّذ بداخلها شيئًا غير محدد، ما ينقل الغموض بعيدًا عن نظرك إلى كود مضطر إلى تفسير النثر. الهدف المفيد هو وحدة القصد: أداة واحدة لكل ما قد يسمّيه المستخدم مهمة. حدّث عنوان التوصيل. ردّ مبلغ الطلب إلى العميل. اعثر على التذاكر المفتوحة لهذا الحساب. وحيث تُنفَّذ سلسلة من الخطوات معًا دائمًا، اجعلها أداة واحدة، فالنموذج لا يستفيد من ائتمانه على ترتيب خطوات لا تتغير أبدًا.
- المفرطة في التجزئة: تركيبات طويلة، وكل خطوة فرصة جديدة للخطأ
- المفرطة في الشمول: تعليمات بنص حر تدفع الغموض إلى داخل كودك
- استهدف وحدة القصد — أداة واحدة لكل مهمة قد يسمّيها المستخدم
- السلسلة التي لا تتغير أبدًا يجب أن تكون أداة واحدة، لا خطة يعيد النموذج تجميعها
أبقِ الواجهة صغيرة ومتمايزة
تنخفض دقة الاختيار كلما كبرت مجموعة الأدوات، وتنخفض بأسرع ما يكون حين تتداخل الأدوات. فأداتان يمكن لكل منهما أن تجيب عن الاستعلام بشكل معقول تفرضان تمييزًا لا يملك النموذج أساسًا له، ولن يقوم به باتساق. فضّل أداة واحدة بوضع تشغيل من قائمة محددة على ثلاث أدوات شبه متطابقة. سمِّ الأداة بحسب النتيجة لا بحسب التنفيذ، لأن النموذج يختار بحسب ما يريد تحقيقه لا بحسب الخدمة الداخلية التي تصادف أنك تملكها. واستخدم مفردات واحدة عبر المجموعة كلها، لأن مجموعة أدوات تقول «عميل» في موضع و«حساب» في آخر تُنتج أخطاء في المعاملات تبدو كأنها إخفاقات في الاستدلال. وحين تدمج واجهة أدوات معيارية مثل MCP، تذكّر أن اعتماد خادم يعني إدخال قائمة أدواته كاملة إلى سياقك واصطلاحات تسميته إلى فضاء أسمائك.
- الأدوات المتداخلة أسوأ من الأدوات المفقودة — فالتمييز بينها بلا أساس
- أداة واحدة بوضع تشغيل من قائمة محددة تتفوّق على ثلاث أدوات شبه متطابقة
- سمِّ بحسب النتيجة لا التنفيذ، واستخدم مفردات واحدة في كل مكان
- اعتماد خادم معياري يُدخل قائمة أدواته كاملة وتسمياته إلى سياقك