Cara Kerja AI Agent: Lingkarnya, Langkah demi Langkah
Agent tampak ajaib di demo dan seperti pekerjaan pipa di produksi. Sebabnya, bagian menariknya bukan keluaran model melainkan lingkar yang mengonsumsinya, dan lingkar itu cukup pendek untuk dibaca sekali duduk.
Panduan ini menuntun satu permintaan dari ujung ke ujung: apa yang dilihat model tiap giliran, apa yang dilakukan kode Anda terhadap hasilnya, bagaimana alat yang gagal kembali, dan apa yang menghentikan lingkar. Kalau Anda bisa menceritakan ini untuk sistem sendiri, Anda bisa men-debug-nya.
Satu giliran, berurutan#
- Susun konteks: tujuan, definisi alat, fakta relevan yang diambil, dan riwayat yang sudah dipangkas.
- Minta langkah berikutnya ke model. Ia menjawab langsung atau meminta panggilan alat dengan argumen.
- Validasi argumen sebelum apa pun terjadi — tipe, rentang, dan apakah pemanggil ini boleh menyentuh catatan itu.
- Jalankan alat. Tangkap kegagalan dan ubah jadi pesan pendek dan faktual, bukan stack trace.
- Tambahkan panggilan dan hasilnya ke riwayat, lalu periksa syarat berhenti.
- Ulangi, atau kembalikan jawaban akhir beserta apa yang benar-benar dilakukan agent.
Apa yang bisa dan tidak bisa dilihat model#
Model tidak mengingat giliran sebelumnya selain yang Anda letakkan kembali ke konteks. Fakta tunggal itu menjelaskan sebagian besar perilaku membingungkan. Kalau agent melupakan batasan dari empat langkah lalu, pemangkasan Andalah yang membuangnya. Kalau ia mengulang panggilan gagal yang sama tiga kali, pesan galatnya tidak menyebut alasannya dalam kata yang bisa ditindaklanjuti.
Tulis galat alat sebagai instruksi, bukan diagnosis. Bukan `HTTP 404`, melainkan `Tidak ada pelanggan dengan ID itu. Minta konfirmasi nomor pesanan.`
Merencana: eksplisit atau muncul sendiri#
Ada dua cara yang sama-sama terhormat. Perencanaan yang muncul sendiri memilih satu langkah tiap kali tanpa dokumen rencana — sederhana, tahan banting, rawan melantur pada tugas panjang. Perencanaan eksplisit meminta rencana bernomor lebih dulu, menjalankannya, dan merencanakan ulang hanya saat sebuah langkah gagal.
Berhenti: bagian yang tak pernah ditunjukkan demo#
| Syarat | Setelan khas | Yang terjadi |
|---|---|---|
| Batas langkah | 8–15 panggilan alat | Kembalikan hasil parsial dengan penjelasan |
| Batas belanja | Biaya tetap per eksekusi | Berhenti dan catat untuk ditinjau |
| Jam dinding | 30–120 detik untuk interaktif | Serahkan dengan yang sudah diketahui |
| Deteksi pengulangan | Panggilan dan argumen sama dua kali | Paksa cabang lain atau berhenti |
| Gerbang manusia | Setiap tindakan tak terbalikkan | Jeda dan minta persetujuan |
Membaca jejak saat ada yang keliru#
Jejak adalah catatan berurutan tiap konteks, keputusan, panggilan, dan hasil dalam satu eksekusi. Itu satu-satunya alat debug yang penting dan hal pertama yang harus dibangun. Pertanyaannya tak pernah kenapa modelnya buruk, melainkan giliran mana yang pertama meleset dan apa yang bisa dilihat model saat itu. Sembilan dari sepuluh kali jawabannya membosankan: sebuah alat mengembalikan daftar kosong tanpa mengatakannya.
Pertanyaan yang sering diajukan
Berapa langkah sebelum berhenti?
Untuk tugas interaktif, batas delapan sampai dua belas panggilan mencakup hampir semua yang wajar; yang butuh lebih biasanya tersangkut. Tugas batch boleh lebih tinggi, tapi pasangkan dengan batas belanja.
Merencana dulu atau memutuskan sambil jalan?
Tugas pendek baik-baik saja sambil jalan. Begitu tugas rutin melewati lima langkah, rencana eksplisit membuat eksekusi bisa diaudit dan kemajuan bisa ditunjukkan.
Kenapa agent saya mengulang panggilan gagal yang sama?
Hampir selalu karena pesan galatnya tidak memuat informasi yang bisa ditindaklanjuti. Kembalikan galat singkat dan jelas, lalu tambahkan deteksi pengulangan.
cara kerja ai agentlingkar agentnalar tindak amatitool callingarsitektur agent
