Bir aracı bir kez tanımlayın — adını, ne işe yaradığını ve neler aldığını — ve tanımı Anthropic, OpenAI, Gemini veya MCP'nin beklediği biçimde alın. Soldaki kontroller, modelin aracı doğru kullanıp kullanmayacağını belirleyenlerdir; bu, JSON'un ayrıştırılıp ayrıştırılmadığından farklı bir sorudur.
Modelin çağırmaya karar vermeden önce okuduğu şey.
Engelleyici bir şey yok; bunlar araç çağrılarını doğru tutan alışkanlıklardır.
Bu tanım iyi okunuyor.
Bir Messages API isteğinin tools dizisine girer.
[
{
"name": "search_orders",
"description": "Search the customer's orders by status, date or product. Use it whenever the customer asks about an order they have already placed. Do not use it to create, cancel or modify an order.",
"input_schema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Free text to match against the product name or the order reference."
},
"status": {
"type": "string",
"description": "Restrict the search to orders in this state.",
"enum": [
"pending",
"shipped",
"delivered",
"cancelled"
]
},
"limit": {
"type": "integer",
"description": "How many orders to return, newest first. Defaults to ten on the server."
},
"customer_id": {
"type": "string",
"description": "The customer whose orders to search."
}
},
"required": [
"customer_id"
]
}
}
]Model kodunuzu görmez; aracın adını ve açıklamasını görür ve bunlara göre karar verir. «Siparişleri ara» bir tahmindir. «Müşterinin mevcut siparişlerinde ara; sipariş oluşturmak veya iptal etmek için kullanma» bir talimattır — yanlış çağrıyı durduran da olumsuz yarısıdır.
String olarak tanımlanan bir durum parametresi, modeli bir değer uydurmaya davet eder. Aynı parametre dört izinli değerle yanlış doldurulamaz ve sizin tarafınızda şemanın ötesinde doğrulama gerektirmez.
JSON Schema her yerde aynıdır; yalnızca sarmalayıcı değişir — Anthropic için input_schema, OpenAI ve Gemini için parameters, MCP için inputSchema. Bunu elle dört kez yazmak, bir aracın bir sağlayıcıda çalışıp bir sonrakinde sessizce başarısız olmasının yoludur.
Bu sayfayı ilk puanlayan siz olun