Araç Çağrısı Gidiş Dönüşü
Tool calling iki turluk bir danstır. Kullanıcının mesajını tool şemalarınla birlikte gönderirsin; model "{city: 'Paris'} ile get_weather çağır" diyen bir tool_use bloğuyla cevap verir; kodun o fonksiyonu çalıştırır ve cevabı bir tool_result olarak geri gönderir; sonra model bunu final cevabı yazmak için kullanır. Bu ders orta adımı inşa ediyor -> modelin isteğinin gerçek bir Python çağrısına dönüştüğü ve sonucun geri dönüş için paketlendiği kısım.
Gerçek döngü burada (sadece örnek amaçlı -> ağı çağırmıyoruz):
resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
tools=TOOLS, messages=history)
# resp.stop_reason == "tool_use". The model may ask for SEVERAL tools at once:
# append its turn once, run every tool_use block, and send ALL the results
# back together in ONE user message.
history.append({"role": "assistant", "content": resp.content})
results = []
for block in resp.content:
if block.type == "tool_use":
result = TOOLS_BY_NAME[block.name](**block.input)
results.append({"type": "tool_result", "tool_use_id": block.id,
"content": str(result)})
history.append({"role": "user", "content": results})
final = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
tools=TOOLS, messages=history)Tartışmaya kapalı detaylar: modeli verdiğin argümanlarla adlandırılmış fonksiyonu çağırmalısın, model her cevabı kendi isteğiyle eşleştirebilsin diye tool_use_id kısmını tool_result içinde yankılamalısın ve bir turda birden fazla araç istendiğinde her sonucu tek bir kullanıcı mesajında döndürmelisin (mesajlara bölmek modele paralel istemeyi bırakmayı öğretir). Bu derste en basit durumu, tek bir araç çağrısını ele alıyorsun; ders 4 birden fazlasını ele alıyor. Yanıtı çevrimdışı çalışması için düz bir dict olarak modelliyoruz:
{"content": [{"type": "tool_use", "id": "toolu_1",
"name": "get_weather", "input": {"city": "Paris"}}],
"stop_reason": "tool_use"}run_tool_call(resp, tools)'yi oluşturuyorsun, burada tools bir araç adını bir Python fonksiyonuna eşliyor. Şunları yapmalı:
resp["content"]içindetypedeğeri"tool_use"olan ilk bloğu bul.-
tools[name]değerini bul ve onu bloğuninputdeğeri ile anahtar argüman olarak çağır:tools[name](**block["input"]). Eğer isimtoolsiçinde yoksa, (birKeyErrorveyaValueError) hatası fırlat -> modelin uydurduğu bir aracı asla çalıştırma. - Sonucu geri döndüren takip mesajını döndür:
{"role": "user",
"content": [{"type": "tool_result",
"tool_use_id": <the block's id>,
"content": str(result)}]}Sonucu str(result) ile string haline getir -> tool_result içeriği metin olarak iletilir. İki farklı araç çağrısının (farklı isim ve girdi) iki farklı tool_result mesajı üretmesi, orijinal tool_use_id mesajının geri döndürülmesi ve bilinmeyen bir araç isminin hata vermesi için bunu oluştur.
run_tool_call(resp, tools) yaz. resp["content"] içindeki ilk {"type": "tool_use", "id", "name", "input"} bloğunu bul, tools[name](**input) çağır ve takip mesajı {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]} döndür. tools içinde olmayan bir araç adında hata fırlat.
Bu derste bir sorun mu fark ettin? Bildir · Bu ders hakkında soru sor
Bu alıştırma yakında açılacak
Bu dersi bitirince bu ders açılacak. Kursun tamamı ücretsiz, hesap gerekmiyor ve bu dersi hemen şimdi okuyabilirsin.
Bu tarayıcı learn.floati.life için çerezleri engelliyor, bu yüzden burada bitirdiğin dersler sırasıyla açılamıyor. Bu site için çerezlere izin ver ve sayfayı yenile.