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

Bangun Payload Messages

Setiap panggilan ke model chat hanyalah permintaan HTTP yang membawa body JSON, dan mendapatkan body itu dengan benar adalah hal pertama yang dilakukan kode asli. Di seluruh modul ini kamu akan membangun dict dan list yang dikonsumsi dan dikembalikan oleh Anthropic API secara manual dengan Python biasa -> jadi semuanya berjalan offline dan bisa dinilai. Setiap pelajaran juga menunjukkan satu baris asli yang akan kamu jalankan dengan API key di mesinmu sendiri. Bentuk yang kamu bangun di sini ADALAH bentuk yang dikirim melalui jaringan.

Setelah SDK terinstal, mengirim pesan terlihat seperti ini (hanya ilustrasi -> kita tidak memanggil jaringan di sini):

import anthropic
client = anthropic.Anthropic()   # reads ANTHROPIC_API_KEY from the environment
resp = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    system="You are a terse assistant.",
    messages=[{"role": "user", "content": "Hello"}],
)

Perhatikan bentuknya: system adalah field tingkat atasnya sendiri (bukan sebuah pesan), dan messages adalah daftar turn, masing-masing berupa dict dengan role dan content. Satu-satunya role yang valid di dalam messages adalah "user" dan "assistant", bergantian seperti percakapan. Bug umum adalah menaruh instruksi di turn {"role": "system", ...} di awal messages, seperti cara beberapa API lain melakukannya. API Anthropic menolak turn sistem sebagai pesan pertama: prompt sistem punya slot tingkat atas sendiri. (Model Claude terbaru menerima pesan sistem di tengah percakapan untuk instruksi yang datang di tengah jalan, tapi itu fitur tingkat lanjut; kursus ini selalu menggunakan slot tingkat atas, jadi build_request kamu menolak turn sistem apa pun.)

Kamu sedang membangun build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). Ini mengembalikan dict request:

{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}
    Salin
  • model dan max_tokens secara langsung, dan masukkan system ke kunci sendiri.
  • Untuk setiap turn di messages, pastikan role adalah tepat "user" atau "assistant". Apapun yang lain (turn "system", typo seperti "User", atau role yang hilang) harus memicu ValueError -> gagal dengan jelas sebelum kamu memanggil API dan membuang satu putaran.
  • Kembalikan turn di messages tanpa perubahan (urutan sama, konten sama).

Ini adalah pemanggilan asli yang akan kamu buat dengan dict yang baru saja kamu buat; ** membongkar dict menjadi keyword arguments:

resp = client.messages.create(**build_request("Be brief.", history))

Buat supaya dua pasangan (system, messages) yang berbeda menghasilkan dua dict request yang berbeda, dan turn dengan role selain user atau assistant memicu error.

Giliranku

Tulis build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) yang mengembalikan dict permintaan bentuk Anthropic {"model", "max_tokens", "system", "messages"}. messages adalah list dari turn {"role", "content"}. Validasi setiap role harus tepat "user" atau "assistant" dan lempar ValueError untuk hal lainnya (termasuk turn "system" yang diselundupkan). Kembalikan turn tanpa perubahan.

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.