Silabus Pelajaran 117 dari 250 · Memanggil LLM Asli
Memanggil LLM Asli

Putaran Bolak-Balik Tool-Call

Tool calling adalah tarian dua langkah. Kamu mengirim pesan pengguna bersama dengan tool schemas kamu; model menjawab dengan blok tool_use yang berbunyi "call get_weather with {city: 'Paris'}"; kode kamu menjalankan fungsi itu dan mengirim jawabannya kembali sebagai tool_result; lalu model menggunakannya untuk menulis balasan akhir. Pelajaran ini membangun langkah tengah -> bagian di mana permintaan model menjadi panggilan Python asli dan hasilnya dikemas untuk perjalanan kembali.

Ini adalah loop yang sebenarnya (hanya ilustrasi -> kita tidak memanggil network):

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)

Detail yang tidak bisa dinegosiasikan: kamu memanggil fungsi yang dinamai model dengan argumen yang diberikan, kamu mengecho tool_use_id kembali di tool_result supaya model bisa mencocokkan setiap jawaban dengan permintaannya, dan saat satu giliran meminta beberapa tools kamu mengembalikan setiap hasil dalam satu pesan user (memisahkannya ke beberapa pesan mengajarkan model untuk berhenti meminta secara paralel). Di pelajaran ini kamu menangani kasus paling sederhana, satu pemanggilan tool; pelajaran 4 menangani beberapa. Kita memodelkan respons sebagai dict biasa supaya bisa berjalan offline:

{"content": [{"type": "tool_use", "id": "toolu_1",
              "name": "get_weather", "input": {"city": "Paris"}}],
 "stop_reason": "tool_use"}

Kamu sedang membangun run_tool_call(resp, tools), di mana tools memetakan nama alat ke fungsi Python. Ini harus:

  • Cari blok pertama di resp["content"] yang type nya adalah "tool_use".
  • Cari tools[name] dan panggil dengan input dari blok sebagai keyword arguments: tools[name](**block["input"]). Jika namanya tidak ada di tools, raise (sebuah KeyError atau ValueError) -> jangan pernah jalankan tool yang dihalusinasi oleh model.
  • Kembalikan pesan pengguna lanjutan yang membawa hasilnya kembali:
{"role": "user",
 "content": [{"type": "tool_result",
              "tool_use_id": <the block's id>,
              "content": str(result)}]}

Stringify hasilnya dengan str(result) -> isi tool_result dikirim sebagai teks. Buat agar dua pemanggilan tool yang berbeda (nama dan input berbeda) menghasilkan dua pesan tool_result yang berbeda, tool_use_id asli dikembalikan, dan nama tool yang tidak dikenal memicu error.

Giliranku

Tulis run_tool_call(resp, tools). Cari blok {"type": "tool_use", "id", "name", "input"} pertama di resp["content"], panggil tools[name](**input), dan kembalikan pesan lanjutan {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]}. Raise jika nama tool tidak ada di tools.

Ada masalah di pelajaran ini? Laporkan · Tanya tentang pelajaran ini

Latihan ini akan segera dibuka

Selesaikan pelajaran sebelumnya agar pelajaran ini terbuka. Seluruh kursus ini gratis, tidak butuh akun, dan kamu bisa baca pelajaran ini sekarang.