Silabus Pelajaran 230 dari 250 · Proyek: Agen Riset Pengguna Alat
Proyek: Agen Riset Pengguna Alat

Daftar Alat + Dispatcher

Setiap "agen AI" yang pernah kamu baca pada akhirnya bertumpu pada satu komponen yang tidak glamor: registri tool. Model mengeluarkan sesuatu seperti {"tool": "search", "args": {"query": "weather"}}, dan kodemu harus menemukan fungsi Python yang tepat, memeriksa bahwa argumennya masuk akal, menjalankannya, dan menyerahkan hasilnya kembali. Salah di lapisan ini dan seluruh agen hanya berjarak satu argumen cacat dari crash di produksi. Pelajaran pertama proyek ini membangun persis lapisan itu, dan kamu akan memakai ulang idenya di setiap pelajaran sesudahnya.

Kamu membangun dispatcher untuk agen riset. Untuk mulai ia butuh dua tool: search(query) yang mencari sebuah fakta, dan calc(op, a, b) yang menghitung aritmetika. Registri memetakan nama tool ke sebuah pasangan: fungsinya, dan skema argumen (himpunan nama argumen yang diterima tool itu). Dispatch adalah gerbang yang dilewati semuanya.

class Registry:
    def __init__(self):
        self.tools = {}   # name -> {"fn": callable, "args": set_of_arg_names}

    def register(self, name, fn, args):
        self.tools[name] = {"fn": fn, "args": set(args)}

    def dispatch(self, name, args):
        # 1. unknown tool name      -> raise KeyError
        # 2. args keys != schema    -> raise ValueError (missing OR extra)
        # 3. otherwise              -> call fn(**args) and return the result
        ...

Aturan yang harus ditegakkan dispatch (inilah inti latihannya):

  • Nama tool yang tidak dikenal -> munculkan KeyError. Agen meminta sesuatu yang tidak ada.
  • Kunci dict args harus cocok persis dengan skema yang terdaftar. Argumen yang hilang atau yang berlebih -> munculkan ValueError. Inilah yang menghentikan {"q": ...} hasil halusinasi (kunci yang salah) supaya tidak diam-diam tidak melakukan apa-apa.
  • Panggilan yang valid -> jalankan fn(**args) dan kembalikan apa pun hasilnya.

Kenapa set untuk skemanya? Karena validasinya lalu hanya kesamaan himpunan: set(args) == self.tools[name]["args"]. Kalau itu salah, cari tahu apakah ada kunci yang hilang atau berlebih dan munculkan ValueError untuk keduanya. Memanggil dengan fn(**args) menyebarkan dict menjadi argumen kata kunci, jadi tanda tangan fungsinya yang melakukan pengikatan terakhir.

Perekrut yang membaca "membangun agen yang memakai tool" sebenarnya bertanya: apakah kamu menangani jalur yang tidak mulus? Agen yang dirilis adalah agen yang dispatcher-nya menolak panggilan buruk dengan keras alih-alih merusak sebuah run. Tekan Run untuk mendaftarkan dua tool dan melihat panggilan yang baik berhasil sementara yang buruk memunculkan galat.

Giliranku

Buat kelas Registry. register(name, fn, args) menyimpan fungsi dan skema nama argumennya (gunakan set). dispatch(name, args) harus: melempar KeyError untuk nama alat yang tidak dikenal; melempar ValueError jika kunci args tidak cocok dengan skema secara persis (kurang atau lebih); jika tidak, panggil fn(**args) dan kembalikan hasilnya. Daftarkan alat search(query) dan calc(op, a, b) agar dispatcher punya sesuatu yang nyata untuk diarahkan.

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.