Tool Use: Granting Claude Real Capabilities

import anthropic
client = anthropic.Anthropic()
 
tools = [{
  "name": "get_weather",
  "description": "Bir şehrin anlık hava durumunu getirir.",
  "input_schema": {
    "type": "object",
    "properties": {
      "city": {"type":"string", "description":"Şehir adı"}
    },
    "required": ["city"]
  }
}]
 
resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    tools=tools,
    messages=[{"role":"user","content":"İstanbul'da bugün hava nasıl?"}],
)
 
# resp.stop_reason == "tool_use"
# resp.content[0].type == "tool_use"  →  isim ve input içerir
# Sen tool'u kendi kodunla çalıştır, sonucu role:"user", type:"tool_result" mesajıyla geri yolla
 

# Tool Use loop pseudo-code (yerel test)
def get_weather(city: str):
    fake = {"İstanbul": {"temp_c": 18, "cond": "yağmurlu"}}
    return fake.get(city, {"temp_c": None, "cond": "bilinmiyor"})
 
# Claude bu adımı simüle ediyor diyelim:
tool_call = {"name": "get_weather", "input": {"city": "İstanbul"}}
 
# 1) tool çalıştır
result = get_weather(**tool_call["input"])
# 2) sonucu Claude'a geri yolla (psödo)
print("Tool sonucu:", result)
print("Claude'un üreteceği final cevap:")
print("- İstanbul'da bugün 18°C ve yağmurlu görünüyor; şemsiyeni unutma.")

{
  "name": "search_orders",
  "description": "Sipariş veritabanında arama yapar. Sadece müşteri kendi sipariş kimliğini sorduğunda kullan.",
  "input_schema": {
    "type": "object",
    "properties": {
      "order_id": {"type":"string", "pattern":"^ORD-[0-9]{6}$"},
      "include_items": {"type":"boolean", "default": true}
    },
    "required": ["order_id"],
    "additionalProperties": false
  }
}

Tool use'da Claude tool _____ üretir, sen _____ , sonra sonucu role 'user' içinde tool_result olarak geri yollarsın. Tool tasarımının ilk kuralı _____ olmasıdır.