Mengapa Agen Memerlukan Pelacakan
Agen melakukan banyak panggilan LLM dan alat untuk setiap permintaan—tanpa pelacakan, Anda bekerja tanpa mengetahui apa yang terjadi.
Mengapa Agen Memerlukan Pelacakan adalah pelajaran AI Agents gratis di CoddyKit. Ini adalah pelajaran 1 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar AI Agents, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus AI Agents mencakup 4 pelajaran total.
Bagian dari pelajaran ini belum diterjemahkan dan ditampilkan dalam bahasa Inggris.
Agen Sulit Di-debug
Satu pesan pengguna dapat memicu 10 pemanggilan LLM, 5 pemanggilan alat, dan latensi selama 30 detik. Ketika terjadi kesalahan, "agen memberikan jawaban aneh" tidak memberi Anda informasi apa pun.
Pelacakan adalah cara untuk melihat apa yang sebenarnya terjadi.
Yang Dicatat oleh Jejak
Untuk satu permintaan pengguna:
- Setiap pemanggilan LLM: model, pesan yang masuk, respons yang keluar, token, latensi
- Setiap pemanggilan alat: nama, argumen, hasil, kesalahan
- Urutan dan waktu semua langkah
- Jawaban akhir yang terlihat oleh pengguna
Log Tidak Cukup
Log biasa (pernyataan print) kehilangan struktur sebuah jejak — Anda tidak dapat mengetahui pemanggilan LLM mana yang terkait dengan permintaan pengguna mana, atau bagaimana langkah-langkah tersebut membentuk sebuah pohon.
Alat pelacakan terstruktur dapat mengatasinya.
span vs Jejak
Diadaptasi dari OpenTelemetry:
- Jejak — seluruh proses agen (satu permintaan pengguna)
- span — satu langkah di dalam jejak (pemanggilan LLM, pemanggilan alat, pengambilan data)
- span memiliki induk — sehingga membentuk pohon
A Concrete Trace Tree
Trace: user asks 'What is our return policy?'
|-- Span: retrieve_docs (12 ms)
|-- Span: llm_call_planner (820 ms)
| |-- tool_call: search_kb
|-- Span: tool_call: search_kb (340 ms)
|-- Span: llm_call_synthesise (1100 ms)
Total: 2.3 s, 8400 tokens, $0.012Mengapa Pelacakan Mengungguli Log
- Struktur pohon menunjukkan hubungan induk/anak
- Diagram waktu menunjukkan langkah yang lambat
- Token dan biaya diakumulasikan per jejak
- Putar ulang: jalankan kembali jejak dengan prompt baru untuk menguji perubahan
Kapan Menambahkan Pelacakan
Sejak hari pertama. Pelacakan selama pengembangan mengungkapkan bug yang mungkin tidak Anda sadari saat melakukan debug hanya melalui chat. Menambahkannya setelah insiden produksi terjadi sudah terlambat.
Privasi dan Pelacakan
Jejak berisi data pengguna. Perlakukan seperti log:
- Sembunyikan PII sebelum mengekspor
- Enkripsi saat disimpan
- Patuhi kebijakan penyimpanan
Pelacakan vs Evaluasi
Pelacakan = "apa yang terjadi dalam satu proses ini". Evaluasi = "seberapa baik kinerja agen pada kumpulan pengujian". Anda memerlukan keduanya, tetapi pelacakan harus didahulukan — Anda tidak dapat mengevaluasi sesuatu yang tidak dapat diperiksa.
Biaya Pelacakan
Pelacakan menambah overhead latensi sebesar 1–2% dan meningkatkan kebutuhan penyimpanan. Untuk agen yang banyak berinteraksi, ambil sampel (misalnya, 10% jejak secara lengkap dan 100% kegagalan), bukan merekam semuanya.
Instrumentasi Manual vs Otomatis
Beberapa kerangka kerja (LangChain, LlamaIndex) melakukan instrumentasi otomatis — Anda mendapatkan jejak secara gratis. Untuk kode khusus, bungkus pemanggilan LLM dan alat Anda dengan pembantu span.
ID Jejak dalam Kesalahan yang Dilihat Pengguna
Ketika agen gagal, kembalikan ID jejak kepada pengguna:
"Terjadi kesalahan. ID referensi: trace-9c4a... Tunjukkan ini kepada tim dukungan."
Tim dukungan dapat membuka jejak tersebut dan melihat apa yang sebenarnya terjadi.
Mengapa Pelacakan?
Mengapa pelacakan terstruktur lebih baik daripada pencatatan dengan pernyataan print biasa untuk agen?
Ringkasan
Pelacakan itu wajib. Bangun sejak hari pertama. Pelajaran berikutnya membahas hal-hal yang perlu dicatat dan alat yang sebaiknya digunakan.
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Mengapa Agen Memerlukan Pelacakan” gratis?
Ya — teks lengkap “Mengapa Agen Memerlukan Pelacakan” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus AI Agents, upgrade ke CoddyKit PRO. Kursus AI Agents mencakup 4 pelajaran total.
Apa yang akan aku pelajari di “Mengapa Agen Memerlukan Pelacakan”?
Agen melakukan banyak panggilan LLM dan alat untuk setiap permintaan—tanpa pelacakan, Anda bekerja tanpa mengetahui apa yang terjadi. Kamu berlatih AI Agents dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.
Apakah aku perlu pengalaman untuk memulai AI Agents?
Tidak diperlukan pengalaman sebelumnya. AI Agents di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 1 dari 4.
Berapa lama pelajaran “Mengapa Agen Memerlukan Pelacakan” memakan waktu?
Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.
Bisakah aku menulis dan menjalankan kode dalam pelajaran AI Agents ini?
Ya. Setiap pelajaran AI Agents menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.
Semua pelajaran dalam kursus ini
- Mengapa Agen Memerlukan Pelacakan
- Mencatat Panggilan Alat dan Masukan/Keluaran
- Latensi dan Biaya per Langkah
- Memvisualisasikan Eksekusi Agen (Langfuse, LangSmith)