مركز تعلّم الذكاء الاصطناعيEnglish
ترجمة عربية جديدة ✦ نراجعها باستمرار لتحسينها.
◆ الأدوات

تصميم الأدوات هو تصميم واجهات API

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

مستهلكك لا يستطيع طرح الأسئلة

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

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

دقة التقسيم: طابِق وحدة القصد

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

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

أبقِ الواجهة صغيرة ومتمايزة

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

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