Araç Açıklaması (Tool Description)

Araç açıklaması, bir modele aracın ne yaptığını, ne zaman kullanılacağını ve argümanlarının ne anlama geldiğini söyleyen metindir. Modelin elindeki tek şey odur: uygulamayı okuyamaz, uç noktayı deneyemez, durum adlı alanın gerçekte neyi kabul ettiğini bir meslektaşına soramaz. Bu yüzden her araç açıklaması, isteme eklenmiş bir belge değil, istemin kendisinin parçasıdır. Ekipler bunları sonradan aklına gelen bir iş gibi yazar, sonuçlarını ise başka bir yerde ayıklamaya çalışır. Yanlış aracı seçen, argüman uyduran, aynı aracı birbirine yakın ifadelerle iki kez çağıran ya da gayet uygun bir aracı bırakıp daha kötüsünü kullanan bir ajan genellikle zayıf bir modelden muzdarip değildir; yanıtı zaten bilen birinin yazdığı açıklamalarla çalışmaktadır. Ele veren işaret, arızaların en muğlak metne sahip araçlarda kümelenmesidir. İşe yarayan sürüm, kod tabanına erişimi olmayan yetkin ve yeni bir meslektaşa verilen bir yönerge gibi okunur. Aracın ne yaptığını somut biçimde söyleyin, hangi koşullarda seçilmesi gerektiğini belirtin ve —en çok atlanan kısım— ne zaman seçilmemesi gerektiğini yazın. İki araç örtüşüyorsa her açıklama diğerini adıyla anmalı ve sınırı çizmelidir; çünkü model ikisi arasında seçim yapmaktadır ve sistemde ona bunu söyleyen başka hiçbir şey yoktur. Parametreler de aynı muameleyi ister: değerin anlamı, biçimi, nereden geldiği ve yanlış olduğunda ne olacağı. Açıklamalar yorum satırı gibi değil, istem gibi bakım ister. Bir aracın davranışı değiştiğinde açıklaması, üretimdeki kararlara canlı bir girdidir; bayatlamış bir açıklama derleme hatası değil, kendinden emin yanlış çağrılar üretir. İfadeyi değiştirmek davranışı değiştirir; bu da açıklamaların sürüm denetiminde ve ajanı kapsayan değerlendirmenin içinde olması gerektiği anlamına gelir. Nicelik de en az nitelik kadar önemlidir. Uzun bir araç listesi her seçimi zorlaştırır ve görevin ihtiyaç duyduğu bağlamı doldurur; zorlanan bir ajanda alışılmış iyileştirme daha iyi bir açıklama değil, önüne daha az araç koymaktır — platformun yapabildiği her şeye değil, eldeki göreve göre daraltılmış olarak.