# aiagentdevelopment.info — teks lengkap > Teks lengkap setiap panduan dalam bahasa ini, supaya mesin penjawab dapat membaca katalog dalam satu permintaan. Tidak ada di sini yang absen dari halaman yang terlihat. ## Peta Jalan Pengembangan AI Agent yang Benar-benar Sampai Produksi https://aiagentdevelopment.info/id/guides/peta-jalan-pengembangan-agent Diperbarui 2026-08-05 · Biaya dan bisnis - Empat fase dengan uji keluar tertulis: cakupan, prototipe, pengerasan, rilis. - Pengerasan fase terpanjang dan paling sering kurang dianggarkan. - Rilis terbatas dan perluas berdasarkan angka, bukan kalender. - Setelah rilis ini adalah layanan: pemilik, evaluasi tumbuh, kualifikasi ulang. Pola kegagalan proyek agent bukan hal teknis. Ia berupa prototipe bagus di minggu ketiga, disusul tiga bulan perbaikan tanpa arah, lalu pembatalan diam-diam karena tak ada yang bisa mengatakan apakah sudah siap. Peta jalan ini memperbaikinya dengan uji keluar. Tiap fase punya syarat yang ditulis sebelum fase dimulai dan terpenuhi atau tidak. Bila sebuah fase gagal ujinya, Anda memperbaiki celah konkretnya atau berhenti. ### Fase 1 — Cakupan (1–2 minggu) Tulis tugasnya sebagai kalimat yang bisa ditandai benar atau salah. Daftar alat beserta skema argumennya. Putuskan tindakan mana yang tak terbalikkan dan akan berada di balik manusia. Kumpulkan dua puluh contoh nyata. Uji keluar: rekan yang tak ikut rapat bisa membaca brief dan menilai lima contoh eksekusi dengan benar. ### Fase 2 — Prototipe (2–3 minggu) Bangun lingkar terkecil yang mengerjakan tugas itu dengan alat nyata di lingkungan uji. Jalankan dua puluh kasus Anda, lihat tiap kegagalan, dan perbaiki desain alat alih-alih prompt bila bisa memilih. Uji keluar: 60% dari dua puluh kasus lolos ujung ke ujung, dan tiap kegagalan punya penyebab yang tertulis. ### Fase 3 — Pengerasan (3–5 minggu) Di sinilah sebagian besar pekerjaan nyata dan di sinilah proyek beranggaran kurang mati. Izin atas identitas pengguna akhir, gerbang pada yang tak terbalikkan, validasi argumen, jejak yang terbaca, pemantauan, set evaluasi tumbuh ke lima puluh kasus termasuk yang adversarial, dan mode degradasi. - Otorisasi diperiksa di sisi server pada tiap panggilan alat. - Gerbang manusia di depan tiap tindakan tak terbalikkan. - Batas langkah dan belanja, plus deteksi pengulangan. - Jejak dengan pengenal eksekusi dan retensi yang diputuskan sengaja. - Kasus adversarial dalam evaluasi, dijalankan seperti uji lain. Uji keluar: 85% pada set evaluasi, 100% pada subhimpunan penolakan, dan tak ada temuan keamanan terbuka. ### Fase 4 — Rilis (2 minggu, lalu berkelanjutan) Mulai dengan audiens terbatas. Baca eksekusi tiap hari. Jaga jalur eskalasi terlihat dan berawak. Perluas saat angkanya bertahan dua minggu berturut-turut, bukan saat kalender mengatakannya. | 1 | Hanya tim internal | Jejak, kegagalan nyata, galat alat | | 2 | 5% trafik nyata | Tingkat eskalasi, keberhasilan | | 3–4 | 25% | Biaya per tugas, latensi puncak | | 5+ | Penuh bila angka bertahan | Pergeseran, kategori baru | Q: Dua belas minggu terasa lama untuk demo tiga hari. A: Demonya memang berhasil. Sembilan minggu sisanya adalah izin, evaluasi, pemantauan, dan jalur kegagalan. Q: Bolehkah fase tumpang tindih? A: Pengerasan boleh dimulai saat prototipe, dan sebaiknya begitu untuk izin. Jangan mulai rilis sebelum uji pengerasan lolos. Q: Bagaimana kalau prototipe gagal ujinya? A: Lihat penyebab yang Anda catat. Kalau desain alat dan akses data, perbaiki. Kalau tugasnya butuh pertimbangan yang tak bisa didefinisikan siapa pun, berhenti. ## Kasus Penggunaan AI Agent per Industri: yang Benar-benar Berhasil https://aiagentdevelopment.info/id/guides/kasus-penggunaan-per-industri Diperbarui 2026-08-05 · Biaya dan bisnis - Agent bertahan bila tugasnya sempit, ada sistem pencatatan, dan langkah berisiko dijaga. - Rekonsiliasi, triase, dan penyusunan draf internal adalah kemenangan pertama paling andal. - Proyek tersendat karena API, definisi, atau pemilik yang hilang — bukan batas model. - Di sektor teregulasi mulailah dari sisi draf dan perluas otonomi berdasarkan bukti. Daftar kasus penggunaan biasanya terbaca seperti daftar keinginan. Daftar ini disusun dari apa yang benar-benar sampai produksi dan bertahan di sana — daftar yang jauh lebih pendek dan lebih berulang daripada yang disiratkan pemasaran. Polanya konsisten lintas industri. Tugas sempit dengan definisi selesai yang jelas, dua atau tiga alat terhadap sistem pencatatan nyata, dan seorang manusia di depan apa pun yang tak bisa dibatalkan. ### Yang berhasil, per sektor | E-commerce | Status pesanan, kelayakan retur, ubah alamat | Cari pesanan, kebijakan, perbarui alamat | Pengembalian dana di atas ambang | | Dukungan SaaS | Triase tingkat pertama dengan konteks akun | Cari akun, cari dokumen, perbarui tiket | Perubahan paket, kredit | | Operasi keuangan | Mencocokkan faktur dengan pesanan pembelian | Baca ERP, urai dokumen, tandai selisih | Setiap pembayaran | | Administrasi kesehatan | Penjadwalan dan pengingat | Kalender, baca rekam pasien | Segala hal klinis | | Rekrutmen | Penyaringan kriteria eksplisit, penjadwalan | Baca ATS, kalender, draf email | Penolakan dan penawaran | | Logistik | Penanganan pengecualian keterlambatan | Pelacakan, API kurir, notifikasi | Tawaran kompensasi | ### Agent internal yang tak ditulis siapa pun Kemenangan paling andal justru tak menarik dan internal: mencocokkan dua sistem yang berbeda, menyusun draf pertama laporan rutin, memilah permintaan masuk ke antrean yang tepat, dan menjawab pertanyaan kebijakan dengan kutipan. Semua itu berhasil karena definisi selesainya jelas dan kesalahannya murah serta terlihat. ### Di mana proyek tersendat, di sektor mana pun - Tak ada sistem pencatatan dengan API — agent tak punya pijakan. - Tak ada kesepakatan tentang hasil yang benar, jadi tak ada yang bisa menilai. - Tugas sarat pertimbangan dengan nol selera risiko: semua lewat gerbang dan nilainya hilang. - Kepemilikan kabur: dibangun inovasi, dibutuhkan operasi, tak ada yang siaga. ### Memilih yang pertama Nilai kandidat pada empat sumbu: volume, keberulangan langkah, keberadaan sistem pencatatan, dan keterbalikan tindakan. Proyek pertama terbaik adalah bervolume tinggi, sangat berulang, didukung API, dan bisa dibatalkan. Pilih dengan sengaja sesuatu yang kesalahannya memalukan, bukan mahal. Q: Sektor mana yang kemenangannya paling jelas? A: E-commerce dan dukungan SaaS, karena tugasnya bervolume tinggi, API sistemnya memadai, dan sebagian besar tindakan bisa dibatalkan. Q: Apakah berguna untuk usaha kecil? A: Ya, biasanya dalam bentuk internal: triase, draf, rekonsiliasi. Q: Bagaimana memperkirakan nilainya sebelum membangun? A: Hitung volumenya, ukur waktu manusia saat ini, dan perkirakan porsi yang bisa diselesaikan agent tanpa bantuan. ## Mengukur ROI AI Agent Tanpa Menipu Diri Sendiri https://aiagentdevelopment.info/id/guides/mengukur-roi-agent Diperbarui 2026-08-05 · Biaya dan bisnis - Tulis garis dasar sebelum rilis — volume, waktu, biaya, tingkat kesalahan. - Hitung tugas selesai tanpa manusia, bukan deflection atau jumlah pesan. - Kurangi biaya kesalahan dan waktu peninjauan; pengurangan itu yang membuat angkanya kredibel. - Laporkan manfaat kualitatif terpisah, jangan diubah jadi uang karangan. Sebagian besar angka ROI agent tak bertahan saat dibaca cermat, dan alasannya hampir selalu sama: garis dasarnya disusun ulang setelah kejadian, dan kesalahan ditinggalkan di luar hitungan. Mendapat angka jujur tidaklah sulit, tapi harus dimulai sebelum rilis. Tulis berapa biayanya hari ini, dalam satuan yang akan Anda pakai nanti. Selebihnya mengalir dari satu disiplin itu. ### Tulis dulu garis dasarnya - Volume: berapa kali tugas ini terjadi per minggu? - Waktu penanganan: berapa lama bagi seseorang — diukur dari sampel, bukan diingat? - Biaya per jam yang dibebankan penuh. - Kualitas saat ini: tingkat kesalahan atau pengerjaan ulang. - Waktu tunggu: berapa lama pemohon menunggu hari ini, bila itu penting. Garis dasar yang disusun setelahnya selalu menguntungkan proyek, dan semua peninjau tahu itu. ### Metrik yang bertahan dan yang menyanjung | Tingkat deflection | Menghitung yang tak terjawab sebagai selesai | Tugas selesai tanpa manusia | | Pesan tertangani | Volume bukan nilai | Tugas selesai ujung ke ujung | | Kepuasan pada obrolan agent | Bias penyintas | Kepuasan di semua kontak | | Waktu dihemat per jawaban | Mengabaikan waktu peninjauan | Menit bersih setelah peninjauan | | Biaya per token | Bukan angka bisnis | Biaya per tugas selesai | ### Rumusnya, termasuk bagian yang dihilangkan orang Manfaat tahunan = tugas selesai tanpa manusia × menit dihemat per tugas × biaya per menit — dikurangi biaya kesalahan yang ditimbulkan, dikurangi waktu peninjauan yang tercipta. Pengurangan itulah bagian jujurnya. Agent yang menyelesaikan 70% tapi tiap keluarannya harus diperiksa menghemat waktu peninjauan, bukan penanganan. Perkirakan biaya kesalahan secara eksplisit, meski kasar. ### Ketika jawaban jujurnya adalah tidak Kadang aritmetikanya menyuruh berhenti, dan mengatakannya adalah hal paling berharga dari latihan ini. Tugas bervolume rendah jarang menutup biaya membangun. Tugas yang keluarannya tetap harus diperiksa hanya menghemat waktu peninjauan. Dan tugas dengan kesalahan mahal bisa menghasilkan imbal hasil negatif bahkan pada akurasi tinggi. Q: Berapa tingkat penyelesaian yang realistis? A: Enam puluh sampai delapan puluh persen dari tugas bervolume tinggi yang dicakup baik, sisanya dieskalasi. Q: Berapa lama sampai balik modal? A: Pada tugas internal yang dipilih baik, umumnya enam sampai dua belas bulan termasuk pemeliharaan. Q: Bagaimana menghitung nilai bila agent hanya menyusun draf? A: Ukur waktu dari halaman kosong sampai keluaran disetujui, sebelum dan sesudah. ## Merekrut Pengembang AI Agent: Apa yang Dicari dan Cara Mengujinya https://aiagentdevelopment.info/id/guides/merekrut-pengembang-agent Diperbarui 2026-08-05 · Biaya dan bisnis - Rekrut insinyur sistem yang berpikir dalam mode kegagalan, bukan spesialis prompt. - Saring dengan brief: skema, syarat berhenti, sepuluh kasus, gerbang manusia. - Pengetahuan framework paling lemah memprediksi keberhasilan. - Syaratkan serah terima prompt, skema, evaluasi, dan jejak. Jabatannya baru, keterampilannya tidak. Orang yang membangun agent yang bertahan di produksi adalah insinyur kuat biasa yang belajar bekerja dengan komponen yang cepat, cakap, dan sesekali salah dengan percaya diri. Sudut pandang itu membuat perekrutan jauh lebih mudah. Anda tidak mencari spesialis prompt. Anda mencari orang yang secara naluriah bertanya apa yang terjadi kalau alat tak mengembalikan apa pun. ### Yang penting, berurutan - Rekayasa API dan integrasi: sebagian besar pekerjaannya berbicara benar dengan sistem Anda. - Naluri pengujian: menanyakan evaluasi sebelum menanyakan model. - Berpikir dalam mode kegagalan: hasil kosong, izin, timeout, keberhasilan parsial. - Kesadaran keamanan: hak minimal, injection, jejak audit, gerbang. - Kesadaran biaya: bisa menjelaskan ke mana token pergi tanpa mencari. - Keakraban dengan model: berguna, bisa dipelajari dalam hitungan minggu. - Pengetahuan framework: paling tidak penting dan paling banyak diiklankan. ### Latihan penyaringan sembilan puluh menit yang berhasil Beri brief singkat: agent yang menjawab pertanyaan pesanan dan boleh menerbitkan pengembalian dana di bawah lima ratus ribu rupiah. Minta daftar alat dengan skema argumen, syarat berhenti, sepuluh kasus evaluasi, dan apa yang berada di balik gerbang manusia. Anda tidak mencari kode. Kandidat kuat mengajukan pertanyaan tentang izin dan kasus tepi dalam lima menit pertama. Itu sinyal paling andal. ### Pertanyaan yang memisahkan pengalaman dari antusiasme | Bagaimana tahu perubahan menolong? | Kami uji manual | Set evaluasi tetap, sebelum dan sesudah | | Apa yang dilakukan bila alat kosong? | Coba lagi | Hasil kosong eksplisit yang bisa ditindaklanjuti | | Bagaimana menghentikan injection? | Menyuruh model mengabaikannya | Hak minimal, isolasi, gerbang | | Kenapa agent terakhir Anda lambat? | Modelnya lambat | Enam panggilan berurutan; dua diparalelkan | | Bagaimana memilih model? | Yang terbaik | Per langkah, diukur pada kasus kami | ### Agensi, lepas, atau internal Agensi cocok untuk pembangunan pertama dengan tenggat: Anda membeli tim yang sudah membuat kesalahan standar, dan Anda harus mensyaratkan serah terima set evaluasi dan skema alat. Internal tepat saat agent menjadi bagian produk. Q: Perlukah insinyur machine learning? A: Biasanya tidak. Ini rekayasa sistem terhadap API model. Q: Sebesar apa timnya? A: Dua insinyur dan seorang pakar domain paruh waktu mencukupi untuk sebagian besar proyek pertama. Q: Apa yang harus diserahkan agensi? A: Repositori, prompt, skema alat, set evaluasi beserta hasilnya, jejak sebulan terakhir, dasbor pemantauan, dan catatan mode kegagalan yang diketahui. ## Biaya Pengembangan AI Agent: Angka Nyata dan Pemicunya https://aiagentdevelopment.info/id/guides/biaya-pengembangan-agent Diperbarui 2026-08-05 · Biaya dan bisnis - Agent internal biasanya $8k–$45k; menghadap pelanggan $35k–$150k. - Integrasi, evaluasi, dan izin mendominasi jam kerja — prompt baris terkecil. - Biaya menjalankan biasanya moderat dan bisa dipangkas separuh dengan kerja rutin. - Anggarkan 15–25% biaya membangun per tahun dan tunjuk pemilik. Tak ada yang bisa mengalkulasi proyek Anda dari sebuah halaman web, tetapi rentangnya juga bukan misteri, dan bentuk estimasinya sangat konsisten pada proyek yang kami kerjakan dan tinjau. Tiga angka yang Anda butuhkan: membangun, menjalankan, merawat. Tim menawar keras yang pertama, mencemaskan yang kedua, dan melupakan yang ketiga sama sekali — itulah sebabnya begitu banyak agent diam-diam rusak delapan bulan setelah rilis. ### Biaya membangun menurut cakupan | Asisten internal, 2–3 alat baca | $8.000–$20.000 | Lingkar, alat, retrieval, set evaluasi kecil | | Agent internal dengan hak tulis | $20.000–$45.000 | Ditambah izin, audit, gerbang persetujuan | | Agent dukungan menghadap pelanggan | $35.000–$90.000 | Ditambah eskalasi, nada, pemantauan, beban | | Agent di dalam produk Anda | $60.000–$150.000+ | Ditambah antarmuka, multi-tenant, SLA, versi | | Bukti konsep saja | $5.000–$12.000 | Satu jalur, tanpa izin, belum layak rilis | ### Ke mana jam kerja sebenarnya pergi Sebarannya mengejutkan mereka yang mengira model adalah proyeknya. Kasarnya: integrasi dan lapisan alat 30%, evaluasi dan iterasi 20%, izin-audit-keamanan 15%, pemantauan dan perkakas operasional 10%, prompt dan retrieval 15%, dan lingkar agent sendiri sekitar 10%. Kalau proposal tak punya baris evaluasi, Anda sedang membeli demo. ### Menjalankan lebih murah dari yang ditakutkan Pada agent dukungan biasa, satu tugas selesai menghabiskan beberapa sen sampai beberapa puluh sen panggilan model. Pada sepuluh ribu tugas per bulan itu uang sungguhan, tapi jarang jadi angka dominan dibanding kerja yang digantikannya. ### Baris yang terlupakan: pemeliharaan - Penghentian model: kualifikasi ulang pada versi baru satu atau dua kali setahun. - Pergeseran API: sistem yang dipanggil alat Anda berubah tanpa bertanya. - Perawatan retrieval: dokumen berubah dan indeks basi lebih buruk daripada tak ada. - Pertumbuhan evaluasi: pengguna baru membawa kategori kegagalan baru. - Kepemilikan: seseorang harus siaga saat agent berbuat aneh. Anggarkan 15–25% biaya membangun per tahun. Agent adalah layanan, bukan proyek yang selesai. Q: Kenapa penawaran untuk brief yang sama berbeda jauh? A: Karena brief jarang sekonkret yang terasa. Penawaran yang mencakup izin, evaluasi, pemantauan, dan jalur pemeliharaan adalah produk berbeda. Q: Bisakah kami mulai lebih kecil? A: Bisa. Satu tugas sempit, dua alat baca, dan dua puluh kasus evaluasi sering $8.000–$15.000. Q: Lebih murah dibangun sendiri? A: Lebih murah secara kas, lebih mahal secara waktu, dan hanya bila ada orang senior yang memilikinya. ## Menskalakan AI Agent: Latensi, Konkurensi, dan Batas Laju https://aiagentdevelopment.info/id/guides/menskalakan-agent Diperbarui 2026-08-04 · Produksi dan operasi - Hambatannya kuota penyedia, bukan server Anda. - Pisahkan trafik interaktif dan latar, lalu antrekan yang kedua. - Alirkan, tampilkan kemajuan nyata, dan kembalikan hasil parsial saat batas. - Bangun mode degradasi di balik sakelar sebelum insiden memaksanya. Lonjakan trafik pertama mengajarkan hal yang sama ke tiap tim. Server Anda hampir menganggur, basis data baik-baik saja, dan semuanya lambat — karena tiap permintaan adalah beberapa panggilan berdurasi detik ke penyedia berkuota, dan kuota tak peduli berapa kontainer yang Anda jalankan. Menskalakan agent karena itu sebagian besar teori antrean dan pengelolaan ekspektasi, ditambah sedikit perencanaan kapasitas. Kabar baiknya: tekniknya sudah dipahami dan tak satu pun menuntut penulisan ulang agent. ### Ketahui batas mana dari tiga yang Anda tabrak | 429 dari penyedia | Permintaan atau token per menit | Antrean, backoff, sebar antar kunci atau wilayah | | Lambat tanpa galat | Panggilan berurutan per eksekusi | Paralelkan langkah mandiri; perpendek lingkar | | Memori atau koneksi habis | Layanan Anda sendiri | Kerja kapasitas biasa | | Lambat hanya saat puncak | Perebutan kuota bersama | Antrean prioritas; buang yang bernilai rendah | ### Antrekan semua yang tidak interaktif Pisahkan trafik menjadi dua kelas sejak hari pertama. Pekerjaan interaktif — ada yang menunggu — mendapat tenggat pendek, batas langkah ketat, dan model cepat bila kualitas mengizinkan. Pekerjaan latar — klasifikasi batch, pengayaan, proses malam — masuk ke antrean yang konkurensinya Anda kendalikan, dan itulah yang pertama dicekik saat kuota menyempit. ### Perpendek penantian dengan jujur - Alirkan jawaban sembari dihasilkan, bukan setelah token terakhir. - Tampilkan langkah saat ini dalam bahasa biasa: `memeriksa pesanan Anda`. - Saat batas tercapai, kembalikan hasil parsial yang berguna dan sebutkan yang kurang. - Keluarkan dari jalur kritis apa pun yang tidak memblokir. Persepsi latensi sama-sama masalah produk dan enjiniring. Lima detik dengan kemajuan terlihat mengalahkan tiga detik layar kosong. ### Rancang mode degradasi sebelum dibutuhkan Putuskan lebih dulu apa yang dilakukan agent saat penyedia lambat, kehabisan kuota, atau mati — dan bangun saat Anda tenang. Tangga yang masuk akal: agent penuh, lalu model alternatif lebih murah, lalu jawaban hanya-retrieval tanpa alat, lalu permintaan maaf jujur dengan penyerahan ke manusia. Q: Beberapa akun penyedia atau wilayah? A: Untuk skala atau ketahanan nyata, ya. Lakukan di balik satu antarmuka internal dan sematkan versi model per rute. Q: Bagaimana menjaga latensi interaktif tetap layak? A: Batasi langkah dengan tegas, rutekan langkah sederhana ke model cepat, paralelkan panggilan mandiri, dan alirkan keluaran. Q: Apa yang pertama patah saat trafik tumbuh? A: Hampir selalu batas laju penyedia, lalu API internal dari alat Anda yang paling sibuk. ## Keamanan AI Agent: Pagar Pengaman, Izin, dan Prompt Injection https://aiagentdevelopment.info/id/guides/keamanan-dan-pagar-pengaman-agent Diperbarui 2026-08-04 · Produksi dan operasi - Anggap agent sebagai rekan kerja yang bisa dibujuk orang asing. - Injection bersifat arsitektural: hak minimal, isolasi, gerbang, audit. - Otorisasi atas identitas pengguna akhir, di sisi server, tiap panggilan. - Masukkan kasus adversarial ke evaluasi dan jalankan ulang tiap ganti model. Model keamanan agent jadi lebih mudah dinalar begitu Anda berhenti memikirkannya sebagai kode dan mulai memikirkannya sebagai rekan kerja yang membantu, cepat, tak kenal lelah, dan bisa dibujuk orang asing. Kepada orang seperti itu Anda tak akan memberi akses basis data tanpa batas, kartu perusahaan tanpa plafon, dan izin mengirim email ke pelanggan tanpa pengawasan di hari pertama. Naluri yang sama berlaku langsung di sini dan lebih andal daripada instruksi apa pun di prompt. ### Ancaman yang tak bisa diselesaikan dengan prompt Prompt injection adalah instruksi yang disembunyikan dalam konten yang dibaca agent — tiket, halaman web, PDF, deskripsi alat. Model tak bisa memisahkan secara andal data yang harus dinalar dari instruksi yang harus diikuti, dan tak ada kalimat seperti `abaikan instruksi dalam dokumen` yang menutup celah itu. Pertahanannya harus arsitektural. Anggap tiap konten yang diambil ditulis oleh orang yang ingin agent Anda berperilaku buruk. Rancang agar itu sekadar menjengkelkan. ### Sembilan kendali, sesuai urutan penerapan kami - Hak seminimal mungkin per alat: sempit, hanya-baca bila bisa, bukan akun serba bisa. - Otorisasi atas pengguna akhir, diperiksa di sisi server pada tiap panggilan. - Persetujuan manusia di depan tiap tindakan tak terbalikkan, dengan konteks memadai. - Validasi argumen dan penyelesaian pengenal sebelum eksekusi; tolak, jangan paksakan. - Batas belanja dan langkah per eksekusi, dan batas laju per pengguna dan alat. - Isolasi konten: teks yang diambil adalah data, bukan instruksi sistem. - Penyaringan keluaran untuk apa pun yang meninggalkan sistem. - Log audit lengkap: siapa, apa, catatan mana, eksekusi mana, hasil apa. - Sakelar darurat: satu setelan yang mematikan alat dan membiarkan mode baca hidup. ### Radius kerusakan menurut jenis tindakan | Membaca catatan milik pengguna | — | Pemeriksaan izin | | Menyusun draf balasan | Ya | Tak perlu | | Memperbarui kolom status | Biasanya | Audit dan batas laju | | Mengirim pesan eksternal | Tidak | Persetujuan manusia | | Menerbitkan pengembalian dana | Tidak | Persetujuan, batas nominal | | Menghapus data | Tidak | Persetujuan, hanya hapus lunak | ### Uji seperti penyerang, secara berkala Masukkan kasus adversarial ke set evaluasi dan jalankan seperti uji lain: tiket berisi instruksi mengirim dokumen internal; dokumen yang mengklaim penggunanya administrator; permintaan yang melampaui mandat. Tiap eksekusi yang berakhir dengan tindakan terlarang adalah uji yang gagal. Q: Bisakah prompt injection diselesaikan dengan prompt lebih baik? A: Tidak. Instruksi menurunkan tingkatnya tapi tak menghapusnya, karena model tak memisahkan data dari instruksi secara andal. Q: Haruskah agent memakai akun layanan? A: Hanya untuk data yang benar-benar publik. Untuk apa pun yang spesifik pengguna, identitas harus mengalir sampai pemeriksaan izin. Q: Apa yang berada di balik gerbang manusia? A: Apa pun yang tak bisa dibatalkan, terlihat pelanggan, di atas ambang nominal, dan apa pun yang membuat agent ragu. ## Memantau Agent di Produksi: Apa yang Dicatat dan Apa yang Diperingatkan https://aiagentdevelopment.info/id/guides/memantau-agent-di-produksi Diperbarui 2026-08-04 · Produksi dan operasi - Catat jejak tiap eksekusi: konteks, panggilan, versi, alasan berhenti, koreksi. - Pantau enam metrik perilaku; keberhasilan dan intervensi manusia paling penting. - Beri peringatan pada laju perubahan dan lampirkan jejak pada tiap peringatan. - Baca sampel eksekusi nyata setiap hari. Layanan biasa dianggap sehat bila merespons cepat dan tak melempar galat. Agent bisa melakukan keduanya sambil sepenuhnya salah — tiap permintaan dijawab dalam dua detik, dan semuanya mengutip kebijakan yang ditarik bulan Maret. Karena itu memantau agent adalah disiplin lain. Ia bertumpu pada dua hal: jejak tiap eksekusi yang cukup rinci untuk merekonstruksi apa yang terjadi, dan segelintir metrik perilaku yang pergerakannya bermakna. ### Isi jejak yang berguna - Pengenal eksekusi pada tiap baris log, panggilan model, dan permintaan keluar. - Konteks persis yang dikirim ke model tiap langkah, atau hash plus bagian-bagiannya. - Tiap panggilan alat dengan argumen, hasil, durasi, dan luaran. - Nama dan versi model per panggilan, plus hitungan token. - Alasan berhenti: selesai, batas langkah, batas belanja, gerbang manusia, galat. - Keluaran akhir dan apakah kemudian dikoreksi atau dibatalkan seseorang. ### Enam metrik yang benar-benar bergerak | Tingkat keberhasilan | Penurunan berkelanjutan | Model berubah, data bergeser, API berubah | | Langkah per eksekusi | Naik perlahan | Galat alat diulang; retrieval memburuk | | Tingkat galat per alat | Lonjakan pada satu alat | Sistem hulu rusak — bukan agent | | Intervensi manusia | Meningkat | Kepercayaan turun atau kategori baru | | Klaim tak berdasar | Kenaikan apa pun | Retrieval gagal diam-diam | | Biaya per tugas | Naik pada volume tetap | Konteks membengkak atau coba ulang bertambah | ### Beri peringatan pada perilaku, bukan hanya galat Agent jarang gagal dengan berisik. Ia memburuk perlahan: sedikit lebih banyak langkah, sedikit lebih banyak coba ulang, sedikit lebih banyak eskalasi — lalu suatu pagi ia menjawab dari dokumen basi. Beri peringatan pada laju perubahan dalam jendela bergulir, bukan ambang mutlak, dan lampirkan jejak satu eksekusi perwakilan pada tiap peringatan. ### Ambil sampel dan baca eksekusi nyata, setiap hari Tak ada dasbor yang menggantikan membaca. Pilih beberapa eksekusi tiap hari — beberapa sukses, tiap eskalasi, tiap eksekusi yang kena batas — dan baca seluruhnya. Tiap masalah serius yang kami temukan di produksi terlihat di jejak sebelum terlihat di metrik. Tambahkan apa pun yang mengejutkan ke set evaluasi pada hari yang sama. Q: Berapa lama menyimpan jejak lengkap? A: Cukup lama untuk debug dan audit — umumnya 30–90 hari untuk konteks lengkap, sementara metrik disimpan jauh lebih lama. Q: Peringatan apa yang paling berharga? A: Kenaikan eskalasi atau koreksi manusia. Itu sinyal jujur paling awal bahwa perilaku bergeser. Q: Perlukah alat observability khusus? A: Tidak untuk memulai. Tabel jejak yang bisa dikueri sudah mencakup sebagian besar kebutuhan. ## Menekan Biaya Agent Tanpa Membuatnya Lebih Buruk https://aiagentdevelopment.info/id/guides/menekan-biaya-agent Diperbarui 2026-08-04 · Produksi dan operasi - Ukur biaya per tugas selesai, dipilah menurut jenis, sebelum mengoptimalkan. - Konteks yang tak lagi dibutuhkan biasanya baris terbesar di tagihan. - Turunkan langkah berpertimbangan rendah satu per satu, dengan evaluasi. - Batasi belanja per eksekusi dan beri peringatan saat batas tercapai. Saat tagihan token mengejutkan seseorang, naluri pertama adalah pindah ke model murah di semua tempat dan menerima penurunan kualitas. Itu jarang perlu. Pada sistem yang kami audit, sebagian besar belanja berasal dari konteks yang tak perlu ada dan langkah yang tak butuh model mahal. Metode di bawah ini membosankan dan efektif: ukur dulu, lalu terapkan empat perubahan menurut urutan hasilnya, lalu putuskan apakah masih ada masalah. Kebanyakan tim berhenti setelah yang kedua. ### Ukur per eksekusi sebelum mengubah apa pun Total belanja bulanan tak memberi tahu apa pun yang bisa ditindaklanjuti. Catat per eksekusi: token masukan dan keluaran, jumlah panggilan, model per panggilan, dan jenis tugas. Lalu lihat biaya per tugas selesai, dipilah menurut jenis. Hampir selalu satu atau dua jenis mendominasi. Sertakan eksekusi gagal dalam penyebutnya. Lingkar coba ulang yang membakar tiga percobaan adalah masalah biaya berkedok kualitas. ### Empat perubahan, menurut hasilnya | Pangkas konteks: buang dokumen terpakai, ringkas riwayat | 20–40% | Rendah bila tujuan tetap disematkan | | Rutekan langkah murah ke model lebih kecil | 20–40% | Rendah, dengan evaluasi per langkah | | Cache prefiks prompt yang stabil | 10–30% pada trafik berulang | Rendah | | Kurangi langkah: alat lebih baik, coba ulang lebih sedikit | 10–25% | Sedang — perlu kerja pada alat | ### Tagihannya adalah konteks Tiap giliran mengirim ulang konteks yang menumpuk, jadi eksekusi delapan langkah bisa membayar dokumen yang sama delapan kali. Tiga kebiasaan memperbaiki sebagian besar: buang paragraf yang diambil begitu langkahnya selesai; ringkas giliran lama jadi catatan faktual; pangkas hasil alat ke kolom yang dipakai. ### Rutekan menurut langkah, bukan selera Ekstraksi, klasifikasi, dan pemformatan jarang butuh model terkuat; perencanaan dan prosa untuk pengguna sering butuh. Turunkan kelompok pertama satu tingkat, jalankan set evaluasi, dan pertahankan perubahan hanya bila angkanya bertahan. - Mulai dari langkah bervolume tertinggi dan berpertimbangan terendah. - Ubah satu langkah tiap kali dan jalankan ulang evaluasi. - Catat model mana yang menghasilkan keputusan mana. - Pasang batas belanja per eksekusi. Q: Apakah caching sepadan? A: Kalau eksekusi Anda berbagi prefiks panjang yang stabil, ya, dan itu salah satu kemenangan termurah. Q: Perlukah fine-tuning untuk berhemat? A: Hanya untuk langkah bervolume tinggi, sempit, dan stabil di mana model kecil yang disetel menyamai model besar. Q: Bagaimana mencegah satu eksekusi jadi sangat mahal? A: Batasi langkah dan belanja per eksekusi, deteksi panggilan identik berulang, dan berhenti dengan hasil parsial. ## Menguji AI Agent: Set Evaluasi yang Sepadan Usahanya https://aiagentdevelopment.info/id/guides/menguji-dan-mengevaluasi-agent Diperbarui 2026-08-04 · Produksi dan operasi - Lima puluh kasus Anda sendiri lebih menentukan daripada benchmark mana pun. - Nilai hasil dan efek samping, jangan pernah transkrip persis. - Cakup dengan sengaja masukan ambigu, kasus penolakan, dan hasil kosong. - Jalankan ulang pada tiap perubahan prompt, alat, model, atau retrieval. Pertanyaan yang memisahkan agent yang tayang dari agent yang membusuk di pilot itu sederhana: bagaimana Anda tahu perubahan kemarin membuatnya lebih baik? Tanpa jawaban, tiap suntingan prompt adalah tebakan dan tiap regresi ditemukan pelanggan. Set evaluasi adalah jawabannya, dan itu tak butuh platform. Lima puluh kasus dalam satu berkas, satu skrip yang menjalankannya, dan satu aturan penilaian per kasus akan memberi tahu lebih banyak daripada papan peringkat mana pun, karena itu kasus Anda. ### Seperti apa satu kasus Kasus adalah masukan, keadaan awal dunia, dan ekspektasi yang bisa diperiksa. Ekspektasinya hampir tak pernah berupa string persis — agent bisa benar dalam beberapa rumusan. Nilailah hasilnya: apakah ia memanggil alat pengembalian dana dengan pesanan 4471; apakah jawaban akhir memuat tanggal yang benar; apakah ia menolak dan bertanya, sebagaimana seharusnya. Simpan keadaan yang dibutuhkan tiap kasus bersama kasusnya. Uji yang hanya lolos pada hari Selasa karena data langsung bukanlah uji. ### Lima puluh kasus dan asalnya | Permintaan nyata yang sering dari log | 20 | Melindungi jalur harian | | Kegagalan lampau yang diketahui | 10 | Mencegah regresi kembali | | Masukan ambigu | 8 | Harus bertanya, bukan menebak | | Kasus yang harus ditolak | 6 | Di luar cakupan, tak berizin, tak aman | | Hasil alat kosong atau rusak | 6 | Insiden nyata paling umum | ### Nilai hasil, bukan jalur Dua eksekusi yang mencapai hasil benar yang sama lewat jalur berbeda sama-sama benar, dan suite yang memaksakan satu transkrip akan gagal terus tanpa alasan. Periksa apa yang berubah dan apa yang dikatakan: panggilan berefek samping, fakta kunci pada jawaban, apakah gerbang manusia diminta. ### Empat angka yang diikuti dari waktu ke waktu - Tingkat keberhasilan seluruh set dan terpisah pada subhimpunan yang harus ditolak. - Tingkat klaim tak berdasar — jawaban dengan fakta yang tak ada di bukti. - Median dan persentil ke-95 biaya dan latensi per eksekusi. - Tingkat intervensi manusia: seberapa sering orang harus turun tangan, dan kenapa. ### Jalankan di pipeline, dan lagi setelah rilis Jalankan set itu pada tiap perubahan prompt, alat, versi model, atau konfigurasi retrieval — hanya empat hal itu yang mengubah perilaku. Setelah rilis, terus ambil sampel trafik nyata: beberapa eksekusi sehari dinilai manual, dan apa pun yang mengejutkan masuk ke set. Q: Berapa kasus untuk mulai? A: Lima puluh menangkap regresi nyata dan bisa ditulis dalam beberapa hari. Dua puluh cukup untuk memulai. Q: Bolehkah menilai dengan model? A: Boleh, dengan hati-hati. Beri kriteria eksplisit, jaga rubrik tetap pendek, dan periksa sampel secara manual. Q: Haruskah evaluasi memblokir deployment? A: Blokir pada subhimpunan kritis keamanan. Untuk kualitas umum, ikuti trennya dan minta keputusan manusia saat turun. ## Sistem Multi-Agent: Kapan Beberapa Agent Mengalahkan Satu https://aiagentdevelopment.info/id/guides/sistem-multi-agent Diperbarui 2026-08-04 · Membangun agent - Pakai beberapa agent hanya bila subtugas mandiri, beralat berbeda, dan lambat. - Lewatkan objek terstruktur dan satu pengenal untuk seluruh permintaan. - Batasi biaya seluruh sistem, bukan per agent. - Evaluasi serah terima selain hasil akhirnya. Diagram multi-agent adalah artefak paling menggoda di bidang ini. Kotak-kotak dengan jabatan, panah di antaranya, koordinator di atas — mirip bagan organisasi, dan bagan organisasi terasa seperti kemajuan. Lalu produksi tiba dan pertanyaan bermunculan: agent mana yang menghasilkan angka salah ini, kenapa koordinator menerimanya, dan kenapa satu permintaan kini menelan sebelas panggilan model. ### Tiga syarat Beberapa agent terbayar bila ketiganya terpenuhi. Subtugas benar-benar mandiri. Masing-masing butuh set alat atau tingkat model berbeda, sehingga spesialisasi membeli sesuatu yang nyata. Dan pekerjaannya cukup lambat sehingga paralelisme mengubah pengalaman pengguna. Bila hanya dua terpenuhi, satu lingkar dengan lebih banyak alat hampir selalu lebih baik. Dua agent yang harus terus berbicara satu sama lain adalah satu agent dengan bus pesan yang mahal. ### Topologi dan biayanya | Supervisor | Satu agent mendelegasikan ke spesialis | N+1 lingkar | Supervisor salah merutekan | | Pipeline | Serah terima tetap, tahap terspesialisasi | Terduga | Satu tahap memburuk diam-diam | | Kipas paralel | Tugas sama, beberapa sudut, digabung | Tertinggi | Penggabungan jadi hambatan | | Debat atau kritikus | Satu mengusulkan, satu membantah | 2× per pertukaran | Sepakat tanpa wawasan | | Papan tulis | State bersama, semua baca-tulis | Tak terduga | Kondisi balapan dan lingkar | ### Aturan yang menjaga agar tetap bisa di-debug - Tiap agent punya kontrak tertulis: apa yang diterima, dikembalikan, dan tak boleh dilakukan. - Lewatkan objek terstruktur antar agent, bukan prosa bebas. - Satu pengenal eksekusi untuk seluruh permintaan. - Batasi biaya seluruh sistem, bukan per agent. - Larang siklus kecuali ada pencacah eksplisit dan syarat keluar. - Tiap agent bisa mengembalikan `saya tak bisa` dan koordinator menanganinya. ### Contoh yang memang sepadan Riset kompetitif benar-benar cocok: diberi sepuluh perusahaan, kumpulkan informasi publik tiap satu. Subtugasnya mandiri, tiap satu lambat, dan penggabungannya sekadar agregasi. Sepuluh agent paralel selesai dalam waktu satu, dan satu penyintesis menulis rangkumannya. Q: Apakah supervisor meningkatkan akurasi? A: Hanya bila peruteannya akurat. Supervisor 90% di depan spesialis 95% menghasilkan sekitar 85% ujung ke ujung. Q: Apakah debat antar agent sepadan? A: Kadang, untuk penilaian yang benar-benar bisa diperdebatkan. Untuk pencarian faktual biasanya hanya menghasilkan kesepakatan dengan biaya dua kali lipat. Q: Bagaimana men-debug kegagalan multi-agent? A: Dengan pengenal bersama pada tiap panggilan, masukan dan keluaran tersimpan per agent, dan tampilan serah terima berurutan. ## RAG untuk Agent: Mendasarkan Jawaban Tanpa Tenggelam di Konteks https://aiagentdevelopment.info/id/guides/rag-untuk-agent Diperbarui 2026-08-04 · Membangun agent - Sajikan retrieval sebagai alat yang dipanggil agent, bukan langkah tetap di depan. - Potong menurut struktur, jaga potongan berdiri sendiri, lampirkan judul dan pengenal. - Kata kunci plus vektor mengalahkan salah satunya pada trafik nyata. - Wajibkan kutipan dan izinkan hasil kosong yang jujur. Retrieval-augmented generation biasanya diperkenalkan sebagai pipeline: sematkan pertanyaan, ambil potongan teratas, tempel, hasilkan. Itu bekerja untuk kotak tanya jawab. Di dalam agent bentuknya salah, karena agent belum tahu apa yang dibutuhkannya sampai ia mengambil satu langkah. Versi yang berhasil memperlakukan retrieval sebagai alat yang dipanggil agent ketika ia memutuskan butuh bukti — kadang dua kali dengan kueri berbeda, kadang tidak sama sekali. Satu perubahan itu menghapus banyak konteks tak relevan. ### Retrieval sebagai alat, bukan pembuka Sajikan pencarian sebagai alat biasa dengan argumen kueri dan kembalian kecil terstruktur: beberapa paragraf, masing-masing dengan pengenal dan sumber. Agent memutuskan kapan memanggilnya, bisa memperhalus kueri setelah melihat hasilnya, dan bisa memanggil alat lain bila jawabannya berupa data terstruktur. Catat kueri yang ditulis agent. Itu deskripsi paling jujur tentang apa yang sebenarnya ditanyakan pengguna Anda. ### Keputusan pemotongan lebih penting daripada model embedding - Pisahkan menurut struktur — judul, bagian, butir daftar — bukan jumlah karakter tetap. - Jaga tiap potongan berdiri sendiri. - Lampirkan judul dokumen dan judul bagian ke tiap potongan. - Simpan pengenal dan URL agar jawaban bisa menunjuk sumbernya. - Lebih baik sedikit potongan besar yang bermakna; tumpang tindih hanyalah tambalan. ### Hibrida mengalahkan vektor murni pada korpus nyata | Pertanyaan konseptual | Kuat | Lemah | Vektor | | Kode produk atau teks galat persis | Lemah | Kuat | Kata kunci | | Nama diri langka | Campuran | Kuat | Kata kunci | | Pertanyaan kebijakan yang diparafrase | Kuat | Lemah | Vektor | | Trafik nyata secara keseluruhan | Campuran | Campuran | Keduanya, digabung dan diurut ulang | ### Minta mengutip, dan izinkan gagal Dua syarat mengerjakan sebagian besar keandalan. Pertama, tiap klaim dari retrieval membawa pengenal paragrafnya dan antarmuka Anda menjadikannya tautan. Kedua, pencarian harus boleh mengembalikan kosong, dan agent harus diajari bahwa `saya tak menemukannya di dokumentasi kami` adalah hasil yang benar. Agent yang tak boleh gagal saat mencari akan mengarang. Q: Haruskah agent selalu mencari sebelum menjawab? A: Tidak. Mencari di tiap permintaan memboroskan latensi dan memenuhi konteks pada pertanyaan yang tak butuh bukti. Q: Berapa paragraf yang dikembalikan? A: Tiga sampai enam yang terpilih baik mengalahkan dua puluh. Q: Bagaimana kalau retrieval tak mengembalikan yang berguna? A: Itu harus jadi hasil yang didukung. Kembalikan kosong eksplisit dan minta agent mengatakannya lalu menawarkan langkah berikutnya. ## Memori pada AI Agent: Apa yang Disimpan, Diringkas, dan Dibuang https://aiagentdevelopment.info/id/guides/memori-pada-agent Diperbarui 2026-08-04 · Membangun agent - Model tak punya memori; agent punya apa yang Anda susun ulang. - Empat lapis: tujuan disematkan, giliran terkini, fakta terkompresi, data segar. - Kompres ke fakta yang bisa dicek, bukan narasi, dan hanya pada ambang. - Memori permanen butuh asal, kedaluwarsa, dan cara pengguna mengoreksi. Dalam satu panggilan model tidak ada memori. Tiap giliran adalah permintaan baru, dan model hanya tahu apa yang Anda susun kali ini. Semua yang orang gambarkan sebagai agent yang lupa, atau memburuk sepanjang eksekusi panjang, adalah keputusan yang diambil kode Anda tentang apa yang dibawa. Setelah itu diterima, desain memori menjadi masalah enjiniring biasa: apa yang selalu relevan, apa yang relevan baru-baru ini, apa yang bisa diringkas, dan apa yang lebih baik diambil segar daripada disimpan. ### Empat lapis | Disematkan | Tujuan, batasan, identitas, kebijakan | Tidak pernah | 200–500 token | | Terkini | Beberapa giliran terakhir apa adanya | Jendela bergulir | 2–5 giliran | | Terkompresi | Giliran lama sebagai catatan faktual | Ditulis ulang saat membesar | Di bawah 500 token | | Terambil | Dokumen untuk langkah ini | Dibuang setelah dipakai | Per langkah | ### Kompres fakta, bukan prosa Kesalahan biasa adalah meringkas giliran lama sebagai narasi — pelanggan menanyakan pesanannya dan agent memeriksanya. Itu enak dibaca dan tak membantu. Kompres ke fakta yang mungkin dibutuhkan langkah berikutnya: pesanan 4471, status dikirim, pengembalian dana diminta, kebijakan 30 hari, belum dikembalikan. Kompres pada ambang tertentu, bukan tiap giliran. Meringkas ringkasan berulang kali membuat detail hilang diam-diam. ### Mengambil bukan mengingat Dokumen yang ditarik dari basis pengetahuan milik langkah yang membutuhkannya. Menyimpannya di konteks setelah langkah itu selesai adalah jalan tercepat menuju eksekusi yang membengkak, mahal, dan buyar. Ambil, pakai, kutip, buang. ### Memori yang bertahan antar sesi Agent berumur panjang mengumpulkan fakta yang benar-benar berguna tentang pengguna atau akun. Simpan dengan sengaja dalam catatan kecil terstruktur dengan langkah tulis eksplisit. Tiga aturan menjaganya sehat: tulis hanya fakta yang akan ditindaklanjuti eksekusi mendatang, selalu catat asalnya, dan beri tiap fakta tanggal kedaluwarsa. - Tulis dengan sengaja — sebagai panggilan alat, bukan efek samping. - Simpan sumber dan tanggal di samping tiap fakta. - Batasi ukurannya dan kedaluwarsakan yang tak dipakai. - Biarkan pengguna melihat dan mengoreksi apa yang disimpan tentangnya. Q: Berapa banyak riwayat disimpan apa adanya? A: Tiga sampai lima giliran mencakup sebagian besar penalaran tanpa mendominasi konteks. Q: Perlukah basis data vektor untuk memori agent? A: Untuk mengambil dokumen sering kali ya. Untuk state satu eksekusi, tidak — itu objek kecil terstruktur di penyimpanan Anda. Q: Bagaimana mencegah memori permanen menjadi basi? A: Beri tiap fakta sumber, tanggal, dan kedaluwarsa, dan buat agent mengutamakan data yang baru diambil. ## Tool Calling: Merancang Alat yang Dipakai Agent dengan Benar https://aiagentdevelopment.info/id/guides/tool-calling-untuk-agent Diperbarui 2026-08-04 · Membangun agent - Kebanyakan kegagalan adalah desain alat, bukan prompt. - Satu alat satu tugas; batasi dengan tipe, bukan prosa. - Tulis galat sebagai instruksi pendek; perlakukan hasil kosong sebagai hasil sah. - Validasi tiap argumen dan selesaikan pengenal sesuai hak pengguna. Saat agent berperilaku buruk, naluri pertama adalah menulis ulang prompt. Menurut pengalaman kami, prompt jadi penyebab mungkin sepertiga kali; sisanya, alat dirancang untuk sebuah program, bukan untuk pembaca yang harus menyimpulkan dari nama dan deskripsi apa fungsi itu melakukan. Alat adalah seluruh kemampuan agent memengaruhi dunia, dan definisinya secara harfiah bagian dari konteks model. Merancangnya dengan baik lebih murah dan jauh lebih tahan lama daripada menyetel prompt, karena alat yang baik membatasi perilaku alih-alih memintanya. ### Tujuh aturan yang mencegah sebagian besar panggilan buruk - Satu alat, satu tugas. `search_orders` dan `refund_order` mengalahkan `manage_order` bermode. - Tipe, bukan prosa. Enum, rentang, dan format melakukan apa yang tak pernah dilakukan deskripsi. - Nama yang mengatakan apa yang terjadi. `send_email_to_customer` jelas; `notify` tidak. - Galat sebagai instruksi: apa yang salah dan apa langkah berikutnya, dalam satu kalimat. - Hasil kosong juga hasil. Tidak-ditemukan yang eksplisit lebih baik daripada exception. - Kunci idempotensi pada apa pun yang berefek samping. - Kembalian kecil. Pangkas ke kolom yang dibutuhkan; 40 KB JSON membeli kebingungan. ### Sebelum dan sesudah | `query(sql)` | Kuasa tanpa batas, tak bisa diaudit | `get_orders_by_customer(customer_id, limit)` | | `date: string` | Model mengarang format | `date: string, format YYYY-MM-DD` | | `HTTP 500` | Tak menyiratkan tindakan | `Layanan pesanan tak tersedia. Minta pengguna mencoba nanti.` | | Mengembalikan seluruh catatan | Memenuhi konteks, mengencerkan perhatian | Mengembalikan enam kolom bernama | | `update_status(id, status)` | Status apa pun, catatan apa pun | `cancel_order(id)` dengan cek izin | ### Deskripsi itu prompt Kolom deskripsi bukan dokumentasi untuk rekan kerja; itu teks yang dibaca model saat memutuskan. Katakan kapan memakai alat dan kapan tidak, sebutkan satu prasyarat yang penting, dan beri satu contoh argumen. Tiga kalimat mengalahkan tiga paragraf. Kalau dua alat bisa sama-sama melayani permintaan yang sama, agent kadang memilih salah. Gabungkan atau perjelas batasnya di kedua deskripsi. ### Selalu validasi sebelum eksekusi Jangan pernah meneruskan keluaran model ke panggilan sistem tanpa pemeriksaan. Validasi argumen terhadap skema, selesaikan pengenal terhadap catatan yang boleh dilihat pengguna ini, dan tolak yang tak cocok alih-alih memaksakannya. Penolakan dengan pesan jelas adalah hasil yang baik. Q: Berapa banyak alat yang terlalu banyak? A: Di atas sekitar sepuluh dalam satu lingkar, akurasi pemilihan menurun dan deskripsi memenuhi konteks. Kelompokkan di balik router sempit atau pecah ke agent terspesialisasi. Q: Haruskah alat mengembalikan respons API mentah? A: Tidak. Kembalikan bentuk kecil dan stabil dengan kolom yang benar-benar dibutuhkan. Q: Bagaimana mencegah agent mengarang argumen? A: Dengan membatasi: enum alih-alih teks bebas, format eksplisit, dan pengenal yang harus terselesaikan. Lalu validasi dan tolak dengan jelas. ## Arsitektur AI Agent: Pola yang Bertahan di Produksi https://aiagentdevelopment.info/id/guides/pola-arsitektur-agent Diperbarui 2026-08-04 · Membangun agent - Bawaan: lingkar berbatas dengan syarat berhenti eksplisit dan jejak linear. - Gerbang alat — validasi, izin, batas laju, audit — komponen paling bernilai. - Perencana–pelaksana memberi niat terlihat; kritikus mengurangi klaim tak berdasar. - Lapisi memori: tujuan, giliran terakhir, fakta terkompresi, pengetahuan segar. Diskusi arsitektur biasanya dimulai dari ujung yang salah: diagram kotak yang dinamai menurut konsep. Versi yang berguna dimulai dari kegagalan yang ingin Anda cegah, karena setiap pola di bawah ini ada untuk menghentikan satu sore yang buruk. Enam pola inilah yang selalu kami pakai. Semuanya bisa digabung: agent produksi biasanya adalah lingkar berbatas dengan gerbang alat, dua lapis memori, dan gerbang manusia — ditambah lintasan kritikus hanya di tempat biaya salah membenarkan satu panggilan tambahan. ### 1. Lingkar berbatas Kasus dasar dan pilihan bawaan Anda. Satu lingkar di atas set alat kecil dengan syarat berhenti eksplisit: batas langkah, batas belanja, deteksi pengulangan, dan batas waktu. Keunggulannya adalah jejak linear yang bisa dibaca dari atas ke bawah. Kalau Anda tak bisa menggambar agent Anda sebagai lingkar dengan daftar pintu keluar, Anda belum punya arsitektur — Anda punya prompt yang berambisi. ### 2. Perencana–pelaksana dengan perencanaan ulang Untuk tugas yang melewati lima langkah, minta rencana bernomor lebih dulu, jalankan, lalu rencanakan ulang saat gagal alih-alih mengikuti rencana basi. Manfaatnya bukan akurasi, melainkan manusia bisa melihat niat sebelum tindakan — yang membuat persetujuan dan debug menjadi mungkin. ### 3. Lintasan kritikus Panggilan kedua meninjau draf atau tindakan yang diusulkan terhadap tujuan dan bukti yang diambil, dan boleh mengembalikannya sekali. Ini menangkap sebagian nyata keluaran yang percaya diri tapi tak berdasar. Pakai di tempat hasil salah mahal dan satu panggilan tambahan tidak. | Lingkar berbatas | 0 | Keterlacakan, kendali biaya | Tak pernah — ini dasarnya | | Perencana–pelaksana | 1–2 | Niat terlihat, bisa diaudit | Tugas di bawah lima langkah | | Lintasan kritikus | 1 per keluaran | Lebih sedikit klaim tak berdasar | Keluaran murah dan bisa dibatalkan | | Gerbang alat | 0 | Izin, audit, batas laju | Hanya prototipe | | Memori berlapis | 0–1 | Relevansi pada konteks panjang | Eksekusi tunggal pendek | | Gerbang manusia | 0 | Yang tak terbalikkan tetap aman | Bila tak ada yang tak terbalikkan | ### 4. Gerbang alat Jangan biarkan agent memanggil sistem Anda langsung. Taruh satu lapis di depan tiap alat yang melakukan empat hal: memvalidasi argumen terhadap skema, memeriksa apakah pengguna akhir ini boleh menyentuh catatan itu, menerapkan batas laju, dan menulis satu baris audit dengan pengenal eksekusi. Ini komponen infrastruktur paling bernilai dalam sistem agent. ### 5. Memori berlapis Riwayat percakapan yang tak dibeda-bedakan adalah penyebab paling umum agent memburuk seiring eksekusi. Pisahkan: tujuan dan batasan yang tak pernah dipangkas; giliran terakhir apa adanya; giliran lama diringkas jadi catatan faktual pendek; dan pengetahuan yang diambil segar tiap langkah dan tak pernah ditumpuk. ### 6. Gerbang manusia Setiap tindakan tak terbalikkan berada di balik persetujuan eksplisit dengan konteks yang cukup untuk memutuskan dalam hitungan detik. Gerbang itu fitur produk, bukan batasan: itulah yang memungkinkan Anda tayang di sistem tempat kesalahan berbiaya mahal. Q: Perlukah keenam pola? A: Tidak. Mulai dengan lingkar berbatas dan gerbang alat; keduanya nyaris wajib untuk apa pun yang menyentuh sistem nyata. Gerbang manusia menyusul begitu ada tindakan tak terbalikkan. Q: Apakah lintasan kritikus benar-benar meningkatkan akurasi? A: Pada tugas di mana model bisa menghasilkan jawaban masuk akal tapi tak berdasar, jelas ya — terutama bila kritikus diberi bukti untuk dicek. Q: Di mana gerbang alat sebaiknya berada? A: Di layanan Anda sendiri, antara agent dan sistem, dengan identitas pengguna akhir mengalir melewatinya. ## Platform No-Code atau Bangun Kustom: Perbandingan Jujur https://aiagentdevelopment.info/id/guides/no-code-atau-kustom Diperbarui 2026-08-04 · Framework dan model - Platform dan kustom adalah fase, bukan rival. - Izin per pengguna, kepemilikan produk, dan volume mendorong ke kustom. - Buktikan alur di platform, lalu bangun ulang hanya bagian yang pantas. - Ekspor prompt, definisi, dan log sejak hari pertama. Perdebatan no-code lawan kustom biasanya berlangsung di antara orang-orang yang punya sesuatu untuk dijual. Setelah membangun keduanya, pandangan kami lebih datar dan lebih berguna: keduanya fase, bukan rival — dan kesalahannya adalah bertahan di salah satunya lebih lama daripada yang didukung bukti. Platform adalah cara termurah menemukan apa yang sebenarnya dituntut tugas Anda. Bangun kustom adalah cara mengambil kendali izin, biaya per unit, dan permukaan produk setelah Anda tahu. ### Berdampingan, tanpa pemasaran | Waktu ke versi pertama | Hari | Minggu | | Bentuk biaya | Per kursi atau eksekusi, berjalan terus | Enjiniring di depan, lalu infrastruktur | | Akses ke sistem internal | Sebatas konektor yang ada | Apa pun yang bisa Anda kodekan | | Izin per pengguna akhir | Biasanya kasar | Sehalus yang Anda bangun | | Evaluasi dan uji regresi | Dari vendor, kadang dangkal | Milik Anda, sedalam investasinya | | Portabilitas | Konfigurasi ada di vendor | Repositori milik Anda | | Tepat saat | Bukti nilai, tugas standar, tim kecil | Permukaan produk, izin nyata, volume | ### Empat pertanyaan yang cepat menyelesaikannya - Perlukah izin per pengguna atas data internal? Jika ya, hampir selalu kustom. - Apakah agent bagian dari yang Anda jual? Jika ya, kustom. - Lebih dari beberapa ribu tugas per bulan? Hitung dulu harga per eksekusi. - Butuh set evaluasi dan jejak audit sendiri? Periksa dulu apa yang bisa diekspor platform. ### Pola hibrida yang berhasil Buktikan alurnya di platform, instrumentasikan semuanya, dan biarkan berjalan sebulan dengan pengguna nyata. Anda akan belajar tiga hal yang tak bisa dirancang di awal: permintaan apa yang benar-benar datang, alat mana yang dipakai, dan di mana manusia turun tangan. Lalu bangun ulang hanya bagian yang pantas. Ekspor prompt, definisi alat, dan log sejak hari pertama. Kalau platform mempersulitnya, anggap itu temuan tentang platformnya. Q: Bisakah no-code jadi jawaban permanen? A: Bisa, untuk tugas internal, standar, bervolume sedang, dan berbiaya kesalahan rendah. Q: Apakah kustom selalu lebih akurat? A: Tidak. Akurasi datang dari desain alat, pengikatan bukti, dan evaluasi — semua bisa dilakukan di platform. Kustom memberi kendali dan ekonomi. Q: Apa biaya tersembunyi terbesar kustom? A: Pemeliharaan. Model dihentikan, API berubah, evaluasi harus dijalankan ulang. Anggarkan 15–25% biaya bangun per tahun. ## Model Context Protocol, Dijelaskan untuk Pembangun https://aiagentdevelopment.info/id/guides/model-context-protocol-dijelaskan Diperbarui 2026-08-04 · Framework dan model - MCP membakukan penemuan dan pemanggilan antara klien agent dan server alat. - Autentikasi, otorisasi, dan persetujuan tetap tanggung jawab Anda. - Bungkus kemampuan sempit dan terapkan izin di dalam server, per panggilan. - Server pihak ketiga adalah dependensi yang deskripsinya masuk ke konteks model Anda. Setiap tim yang membangun lebih dari satu agent menulis adaptor yang sama dua kali: menyambung ke sistem, menjelaskan apa yang bisa dilakukannya, dan menyajikan kemampuan itu ke model dalam bentuk yang diharapkan klien hari ini. Model Context Protocol ada untuk menghentikan duplikasi itu dengan membakukan antarmuka antara klien agent dan server alat. Itu benar-benar berguna, dan juga lebih sempit dari yang disiratkan antusiasme. MCP menjelaskan bagaimana kemampuan diumumkan dan dipanggil. Ia tidak memutuskan siapa yang boleh memanggilnya, dan mencampuradukkan keduanya adalah sumber insiden keamanan. ### Yang dibakukan protokol ini - Penemuan: server memberi tahu klien alat dan sumber daya yang ditawarkan, lengkap dengan skema. - Pemanggilan: klien memanggil alat dengan argumen bertipe dan menerima hasil terstruktur. - Sumber daya: konten hanya-baca yang bisa ditarik klien ke konteks saat diminta. - Transport: format bersama agar klien dan server dari penulis berbeda bisa saling bekerja. ### Yang sengaja tidak dilakukannya MCP tidak mengautentikasi pengguna Anda, tidak menentukan catatan mana yang boleh dibaca siapa, dan tidak menentukan apakah sebuah tindakan butuh persetujuan. Semua itu tetap milik Anda dan harus hidup di sisi server — klien yang meminta izin dengan sopan bukanlah sistem izin. Kesalahan arsitektur paling umum adalah membuka alat luas seperti `run_query` lewat MCP dan berharap prompt menahannya. Perlakukan tiap alat MCP seolah pemanggil yang bingung atau dimanipulasi akan memanggilnya dengan argumen terburuk yang masuk akal. ### Di mana ia berguna hari ini | Satu sistem internal, beberapa klien agent | Tinggi — server ditulis sekali | | Asisten desktop yang membaca konteks lokal | Tinggi — ekosistemnya dibangun di sana | | Satu agent dengan tiga alat khusus | Rendah — panggilan fungsi langsung lebih sederhana | | Alat pihak ketiga yang tak Anda kendalikan | Sedang — praktis, tapi audit servernya | ### Cara mengadopsinya dengan aman - Bungkus kemampuan sempit, bukan kuasa umum: `get_order(id)`, bukan `sql(query)`. - Terapkan otorisasi di dalam server, per panggilan, dengan identitas pengguna akhir. - Kembalikan galat pendek dan jujur — `tidak ditemukan`, `tidak diizinkan`. - Catat tiap pemanggilan dengan argumen dan identitas; itulah jejak audit Anda. - Sematkan server yang Anda pakai ke versi yang sudah ditinjau. Q: Perlukah MCP untuk membangun agent? A: Tidak. Untuk satu agent dengan beberapa alat khusus, panggilan fungsi langsung lebih sederhana. MCP mulai berguna saat kemampuan yang sama harus dijangkau dari beberapa klien. Q: Apakah MCP aman secara bawaan? A: Ia standar transport dan penemuan, bukan model keamanan. Autentikasi, otorisasi per pengguna, dan gerbang persetujuan Anda terapkan di sisi server. Q: Bisakah server MCP jadi jalur injeksi? A: Bisa — lewat deskripsi alat yang masuk ke konteks maupun lewat konten yang dikembalikan. Perlakukan keluarannya sebagai tak tepercaya. ## Memilih Model untuk Agent Anda: Kemampuan, Latensi, dan Biaya https://aiagentdevelopment.info/id/guides/memilih-model-untuk-agent Diperbarui 2026-08-04 · Framework dan model - Pilih model per langkah, bukan satu untuk seluruh agent. - Benchmark menyusun daftar pendek; tiga puluh kasus Anda yang memutuskan. - Latensi, keandalan keluaran terstruktur, dan panjang konteks nyata adalah pengikatnya. - Sematkan versi eksplisit dan jaga evaluasi cukup satu perintah. Pertanyaan yang biasa diajukan: model mana yang terbaik untuk agent? Pertanyaan yang menghasilkan sistem bagus: model mana yang terbaik untuk langkah ini, pada data kami, dalam anggaran latensi kami — dan jawabannya biasanya lebih dari satu. Satu eksekusi agent tidak seragam. Memutuskan tindakan berikutnya butuh penalaran. Menarik tiga kolom dari dokumen tidak. Merangkum hasil untuk pengguna juga tidak. Memperlakukan semuanya sebagai satu keputusan pembelian itulah cara tim membayar harga tertinggi hanya untuk merapikan JSON. ### Belah eksekusinya sebelum memilih | Merencana atau memilih tindakan | Penalaran, patuh instruksi | Sekuat yang mampu Anda bayar | | Memanggil alat dengan argumen | Keluaran terstruktur andal | Kelas menengah dengan skema ketat | | Menarik kolom dari hasil | Akurasi pada teks pendek | Kecil dan cepat | | Klasifikasi atau perutean | Konsistensi | Kecil atau klasifier yang disetel | | Menulis jawaban ke pengguna | Nada dan kejelasan | Kelas menengah | ### Benchmark membuat daftar pendek, bukan keputusan Benchmark publik memberi tahu model mana yang masuk akal. Ia tak memberi tahu mana yang sanggup menangani skema Anda, format dokumen Anda, dan pelanggan Anda yang sulit. Bangun tiga puluh kasus nyata dari log Anda — termasuk lima yang memalukan — lalu jalankan daftar pendek pada kasus itu. Sertakan kasus di mana perilaku yang benar adalah menolak atau bertanya. Model berbeda jauh lebih besar dalam hal kapan berhenti. ### Tiga batasan yang benar-benar mengikat - Lantai latensi: tiap panggilan punya, dan agent melakukan beberapa. Ukur seluruh eksekusi. - Keandalan keluaran terstruktur: 97% argumen valid merusak satu dari sepuluh eksekusi bertiga panggilan. - Perilaku konteks: konteks panjang mahal dan mengencerkan perhatian; ukur pada panjang nyata. ### Perutean tanpa proyek riset Perutean model terdengar canggih dan biasanya hanya berkas konfigurasi. Tetapkan model bawaan per jenis langkah, izinkan penggantian per alat, dan catat model mana yang menghasilkan keputusan mana. Mulailah dengan menurunkan satu tingkat langkah ekstraksi dan klasifikasi saja. Q: Pakai model terbesar untuk semuanya? A: Hanya kalau Anda belum mengukur. Langkah keputusan biasanya diuntungkan; ekstraksi, klasifikasi, dan pemformatan jarang. Q: Apakah model terbuka cocok untuk agent? A: Untuk langkah sempit dengan skema ketat sering kali ya, dan ekonominya menarik pada volume besar. Q: Seberapa sering meninjau ulang pilihan model? A: Setiap kali penyedia merilis versi yang mungkin Anda adopsi, dan selebihnya sekitar dua kuartal sekali. ## Orkestrasi Agent: Kapan Perlu dan Kapan Cuma Beban https://aiagentdevelopment.info/id/guides/orkestrasi-agent Diperbarui 2026-08-04 · Framework dan model - Orkestrasi membeli ketahanan, idempotensi, percabangan, dan pelanjutan. - Tanyakan berapa biaya mengulang eksekusi yang gagal separuh jalan. - Antrean, baris state, dan kunci idempotensi memberi sebagian besar manfaat dengan murah. - Simpan prompt dan skema di luar definisi alur, apa pun pilihan Anda. Pustaka orkestrasi menyelesaikan masalah nyata: eksekusi yang berlangsung bermenit-menit, menyentuh beberapa sistem, dan harus selamat dari restart tanpa mengulangi pembayaran yang sudah terjadi. Itu nyata dan tidak menyenangkan dikerjakan manual. Itu juga bukan masalah kebanyakan agent. Agent dukungan yang menjawab dalam lima belas detik dan aman diulang dari nol tak membutuhkan semua itu. Panduan ini memisahkan kasusnya agar Anda mengadopsi orkestrasi karena mode kegagalan, bukan karena diagram terlihat kosong. ### Yang benar-benar diberikan orkestrasi - State tahan lama: eksekusi selamat dari deployment, crash, atau penyusutan skala. - Langkah idempoten: percobaan ulang tidak mengulang efek samping yang sudah terjadi. - Percabangan dan penggabungan: alur kendali sungguhan, bukan prompt yang menjelaskannya. - Pelanjutan: jeda untuk persetujuan manusia yang datang empat jam kemudian. - Keterpantauan sejak rancangan: tiap langkah adalah objek berstatus. ### Uji yang menentukan Satu pertanyaan: kalau eksekusi ini mati di tengah, berapa biaya mengulangnya? Kalau beberapa sen dan beberapa detik, ulangi saja — Anda butuh coba ulang, bukan ketahanan. Kalau berupa pengembalian dana ganda, email kedua ke pelanggan, atau dua puluh menit orang menunggu, Anda butuh langkah tahan lama dan idempoten. Kebanyakan tim menemukan jawabannya saat pertama kali deployment jatuh di tengah eksekusi. Memutuskan lebih awal lebih murah. ### Di mana kerumitannya muncul | Pengembangan lokal | Jalankan berkasnya | Plus worker dan penyimpan state | | Debug | Satu jejak linear | Korelasikan langkah di riwayat eksekusi | | Deployment di tengah | Eksekusi mati | Eksekusi berlanjut | | Persetujuan manusia | Canggung; biasanya permintaan baru | Jeda dan lanjut kelas satu | | Biaya bug di langkah 3 | Ulangi semuanya | Ulangi langkah 3 | ### Jalan tengah yang sering terlewat Anda tak harus memilih antara lingkar telanjang dan platform penuh. Antrean sederhana, satu baris state per eksekusi, dan kunci idempotensi pada dua alat berefek samping mencakup mungkin delapan puluh persen manfaat dengan sebagian kecil permukaan operasional. Tulis pengenal eksekusi dan indeks langkah pada tiap panggilan keluar. Q: Bisakah orkestrasi dipakai untuk agent obrolan sederhana? A: Bisa dan akan jalan, tapi Anda membayar gesekan pengembangan lokal setiap hari demi manfaat yang jarang ditagih. Q: Apakah antrean pesan cukup? A: Sering kali ya. Antrean plus baris state per eksekusi plus kunci idempotensi mencakup mode kegagalan yang umum. Q: Bagaimana menjaga eksekusi terdistribusi tetap bisa di-debug? A: Dengan pengenal stabil pada tiap baris log, panggilan, dan permintaan keluar, serta konteks tepat yang disimpan per langkah. ## Memilih Framework Agent: Apa yang Benar-benar Menentukan https://aiagentdevelopment.info/id/guides/memilih-framework-agent Diperbarui 2026-08-04 · Framework dan model - Peringkat cepat basi; pertanyaan kecocokan tidak. - Tiga tawar-menawar: SDK penyedia, pustaka orkestrasi, platform terkelola. - Prompt, skema, evaluasi, dan format jejak hidup di repositori Anda. - Bangun agent kecil yang sama dua kali dan ukur kemudahan debug. Artikel apa pun yang memeringkat framework agent berdasarkan nama sudah usang sebelum terindeks. Pustaka di bidang ini menulis ulang abstraksi intinya tiap beberapa rilis, dan yang hari ini unggul mungkin sudah berubah saat proyek Anda tayang. Karena itu panduan ini melakukan hal yang lebih tahan lama: mendaftar delapan pertanyaan yang benar-benar menentukan apakah enam bulan lagi Anda masih senang dengan pilihan itu, dan menjelaskan biaya tiap jawaban. ### Delapan pertanyaan, menurut kepentingannya - Bisakah saya membaca lingkarnya? Kalau berkas tempat keluaran model menjadi panggilan alat tak ditemukan, eksekusi buruk tak bisa di-debug. - Apa yang terjadi saat alat gagal — sampai ke saya, atau diulang diam-diam dengan prompt lain? - Apakah prompt saya adalah prompt framework? Teks sistem yang tak Anda tulis akan mengejutkan saat audit. - Bisakah state dipertahankan dan dilanjutkan, atau crash menghilangkan eksekusi? - Bagaimana alat didefinisikan, dan bisakah definisi itu dipakai ulang di luar? - Bagaimana kisah pembaruannya — abstraksi inti diganti nama dalam dua rilis terakhir? - Bisakah ganti model tanpa ganti framework? - Berapa tambahannya pada cold start dan tiap giliran? ### Tiga kategori, tiga tawar-menawar | SDK penyedia dan lingkar sendiri | Visibilitas penuh, sedikit dependensi | Coba ulang, state, persistensi Anda tulis | Satu agent, sedikit alat, butuh debug | | Pustaka orkestrasi | State tahan lama, cabang, coba ulang | Sebagian visibilitas; gejolak pembaruan | Alur panjang atau banyak langkah | | Platform terkelola | Hosting, jejak, evaluasi, antarmuka | Portabilitas; biaya per kursi atau eksekusi | Tim kecil, tugas standar, bukti cepat | ### Tulis sendiri bagian yang harus tetap milik Anda Apa pun pilihannya, empat aset harus hidup di repositori Anda dalam bentuk yang tak dimiliki framework mana pun: prompt, definisi alat beserta skema JSON, set evaluasi, dan format jejak. Itulah yang benar-benar butuh kerja. Sebagai data biasa dengan adaptor tipis, ganti framework adalah pekerjaan sehari; sebagai dekorator dan pewarisan, itu penulisan ulang. ### Uji yang tak dilakukan siapa pun Sebelum memutuskan, bangun agent kecil yang sama dua kali: sekali dengan favorit Anda, sekali dengan SDK penyedia dan lingkar tulisan tangan. Tiga alat sama, sepuluh kasus sama. Anda tidak mengukur akurasi — itu akan mirip. Anda mengukur berapa lama, seberapa terbaca jejaknya, dan semudah apa mencari tahu mengapa kasus ketujuh gagal. Simpan versi tulisan tangan. Ia menjadi acuan saat Anda perlu membuktikan apakah keanehan berasal dari prompt atau framework. Q: Perlukah framework untuk agent pertama? A: Tidak. Agent pertama dengan tiga alat adalah lingkar, daftar skema, dan syarat berhenti. Membuatnya sendiri sekali mengajarkan apa yang akan dikerjakan framework untuk Anda. Q: Apakah platform terkelola itu jebakan? A: Tidak, selama prompt, skema, dan evaluasi tetap portabel. Risikonya bukan platformnya, melainkan kekayaan intelektual Anda hanya ada sebagai konfigurasi di dalamnya. Q: Seberapa besar pengaruh framework pada akurasi? A: Jauh lebih kecil dari dugaan orang. Akurasi datang dari desain alat, pengikatan bukti, dan evaluasi. ## Kapan Tidak Memakai AI Agent (dan Apa Gantinya) https://aiagentdevelopment.info/id/guides/kapan-tidak-pakai-ai-agent Diperbarui 2026-08-04 · Dasar agent - Urutan tetap membutuhkan pipeline dengan satu langkah model, bukan agent. - Aritmetika, pencocokan persis, dan latensi di bawah sedetik semuanya tak cocok. - Tanpa set evaluasi Anda tak akan tahu apakah perubahan menolong: buat dua puluh contoh dulu. - Tindakan tak terbalikkan bernilai tinggi ada di balik gerbang manusia; agent menyusun draf. Kami membangun agent untuk hidup, dan justru karena itulah halaman ini ada. Cara tercepat merusak kepercayaan tim pada teknologi ini adalah menaruh agent pada tugas yang tak membutuhkannya, menontonnya benar 94% di tempat skrip benar 100%, lalu menghabiskan kuartal berikutnya membelanya. Di bawah ini enam situasi di mana kami menjawab tidak, beserta saran gantinya. Tidak satu pun soal kemampuan model; semuanya soal di mana ketidakpastian menjadi biaya alih-alih keunggulan. ### 1. Langkahnya tidak pernah berubah Kalau urutannya tetap — ambil berkas, validasi kolom, ubah, muat, beri tahu — Anda tak butuh apa pun untuk memutuskan langkah berikutnya, karena tidak ada yang memutuskan. Tulis pipeline-nya. Kalau satu langkah butuh pertimbangan, panggil model untuk langkah itu saja dan biarkan sisanya deterministik. Ini pembangunan berlebihan yang paling sering kami lihat. Panggilan model di dalam pipeline bukan sesuatu yang lebih rendah dari agent; itu justru yang benar. ### 2. Tugasnya aritmetika atau pencocokan persis Total, rekonsiliasi, pajak, aturan kelayakan dengan ambang terbit: semuanya punya jawaban benar dan implementasi yang sudah ada. Model bisa menjelaskan perhitungan dengan indah dan tetap sesekali salah, dan sesekali adalah bencana di keuangan. Hitung di kode, lalu biarkan model menjelaskan. ### 3. Anggaran latensi di bawah satu detik Agent yang merencana, memanggil dua alat, lalu menjawab tidak bisa melakukannya andal di bawah satu detik. Kalau Anda ada di dalam checkout, pencarian saat mengetik, atau perutean panggilan, keluarkan pekerjaan dari jalur kritis atau pakai klasifier dan lookup. ### 4. Tak ada yang bisa mengatakan seperti apa eksekusi yang benar Kalau tim tak bisa menghasilkan dua puluh contoh tugas yang dikerjakan benar, Anda tak punya set evaluasi — dan tanpa itu tak ada cara tahu apakah sebuah perubahan menolong. Bangun contohnya dulu. Sering kali menuliskannya menunjukkan bahwa ini sebenarnya tiga tugas. Dua puluh contoh berlabel adalah palang yang sengaja rendah. Kalau tak tercapai, tugasnya belum cukup dipahami untuk diotomatiskan. ### 5. Setiap tindakan tak terbalikkan dan bernilai tinggi Transfer bank, tanda tangan kontrak, penghapusan di produksi. Anda boleh menaruh agent di depannya — sebagai penyusun draf yang merangkai berkas lalu menyerahkannya ke manusia. Yang tidak boleh: memberi lingkar otonom akses tulis tanpa pengawasan atas sesuatu yang tak bisa dibatalkan. ### 6. Data yang dibutuhkan tidak dapat diakses Agent hanya sekuat alatnya, dan alat hanya sekuat API Anda. Kalau informasinya ada di sistem tanpa API baca atau di spreadsheet yang disunting tiga orang secara manual, agent akan tereduksi jadi menebak. Perbaiki aksesnya dulu. Pekerjaan itu tak menarik dan justru di situlah sebagian besar nilainya. Q: Jadi kapan agent jelas alat yang tepat? A: Saat langkah berikutnya benar-benar bergantung pada apa yang dikembalikan langkah sebelumnya, saat beberapa alat mungkin dibutuhkan dalam urutan yang tak bisa dipatok, dan saat hari ini seseorang melakukannya dengan mencari lalu memutuskan. Q: Kami sudah terlanjur membuat agent untuk pipeline tetap. Dibongkar? A: Belum tentu — ukur dulu. Kalau andal dan biayanya wajar, biarkan. Ganti saat Anda bisa menunjuk rasa sakit yang konkret. Q: Bisakah agent jadi bagian sistem deterministik? A: Bisa, dan sering itu desain terbaik. Jaga tulang punggung tetap deterministik dan beri agent satu wilayah terbatas tempat pertimbangan dibutuhkan. ## Jenis-Jenis AI Agent: Lima Bentuk yang Mencakup Hampir Semuanya https://aiagentdevelopment.info/id/guides/jenis-jenis-ai-agent Diperbarui 2026-07-28 · Dasar agent - Lima bentuk: penjawab, lingkar tunggal, perencana–pelaksana, router, agent berkolaborasi. - Setiap anak tangga membeli kemampuan dengan keterlacakan dan biaya. - Sebagian besar agent produksi adalah lingkar dengan tiga sampai enam alat. - Naik hanya dengan jejak yang membuktikan kegagalan struktural bentuk sederhana. Taksonomi akademis — refleks, berbasis model, berbasis tujuan, berbasis utilitas — berguna untuk ujian dan nyaris tak berguna saat memilih apa yang dibangun Senin pagi. Yang penting dalam praktik adalah bentuk alur kendali, karena itu menentukan biaya, latensi, dan sulitnya proses debug. Lima bentuk mencakup hampir semua agent yang pernah kami kirim atau tinjau. Bentuk-bentuk itu menyusun tangga kerumitan, dan kesalahan mahal yang paling umum adalah memulai dua anak tangga terlalu tinggi. ### Lima bentuk, dari murah ke sulit | Penjawab berbekal alat | Satu panggilan, mungkin satu alat | Pencarian, pengayaan, klasifikasi | Nyaris bukan agent; tidak apa-apa | | Agent lingkar tunggal | Model berputar di set alat kecil | Dukungan, riset, triase | Melantur pada tugas panjang | | Perencana–pelaksana | Rencana, jalankan, rencana ulang bila gagal | Operasi banyak langkah, migrasi | Rencana basi setelah langkah tiga | | Router dengan spesialis | Router memilih sub-agent sempit | Domain luas dengan keahlian berbeda | Galat perutean menumpuk | | Agent berkolaborasi | Beberapa agent bertukar hasil | Riset atau tinjauan yang benar-benar paralel | Biaya, latensi, kegagalan tak terlacak | ### Mulailah satu anak tangga lebih rendah dari yang terasa benar Agent lingkar tunggal menyelesaikan jauh lebih banyak masalah nyata daripada yang disiratkan reputasinya, dan punya satu keunggulan besar: jejak linear yang bisa dibaca manusia dari atas ke bawah. Setiap anak tangga di atasnya membeli kemampuan dengan membelanjakan keterlacakan. Sebelum naik, sebutkan kasus konkret di mana bentuk sederhana gagal, dengan jejak sebagai bukti. ### Anak tangga mana yang sebenarnya Anda butuhkan - Satu pencarian dan satu keputusan: penjawab berbekal alat. - Alat sedikit dan urutannya berubah: satu lingkar. - Manusia akan menulis daftar periksa dulu: perencana–pelaksana. - Pekerjaan terbelah rapi ke keahlian berbeda dengan alat berbeda: router. - Dua subtugas benar-benar tak saling bergantung dan sama-sama lambat: kolaborasi bisa terbayar. ### Jebakan spesialis Router terlihat rapi di diagram dan berperilaku buruk di tepian. Router hanya melihat permintaan, bukan apa yang akan ditemukan spesialis, jadi ia harus menebak. Dua penawarnya: biarkan spesialis mengembalikan `bukan bidang saya` dan rutekan ulang sekali, dan jaga jumlah spesialis cukup sedikit sehingga prompt router bisa menjelaskan masing-masing dalam satu kalimat. Ukur akurasi perutean terpisah. Router 90% di depan spesialis 95% menghasilkan 85% ujung ke ujung. ### Bentuk dan biaya, sejujurnya Biaya tumbuh lebih cepat daripada yang disiratkan diagram. Lingkar tunggal menghabiskan segelintir panggilan. Perencana–pelaksana menambah satu panggilan perencanaan dan sering satu perencanaan ulang. Router menambah satu panggilan sebelum ada hal berguna terjadi. Agent berkolaborasi mengalikan semuanya. Q: Apakah sistem multi-agent lebih baik daripada satu agent? A: Hanya kalau subtugasnya benar-benar mandiri dan masing-masing butuh alat atau tingkat model berbeda. Kalau tidak, Anda membayar latensi, token, dan permukaan kegagalan yang jauh lebih sulit dilacak. Q: Bentuk apa yang paling umum di produksi? A: Agent lingkar tunggal dengan tiga sampai enam alat dan gerbang manusia di depan tindakan tak terbalikkan. Q: Kapan naik satu anak tangga? A: Saat Anda punya jejak kegagalan nyata yang secara struktural tak bisa diperbaiki bentuk sederhana — bukan kasus yang salah sekali, tapi satu kelas kasus. ## Cara Kerja AI Agent: Lingkarnya, Langkah demi Langkah https://aiagentdevelopment.info/id/guides/cara-kerja-ai-agent Diperbarui 2026-07-28 · Dasar agent - Satu giliran: susun konteks, putuskan, validasi, jalankan, catat, periksa syarat berhenti. - Model hanya melihat yang Anda letakkan kembali — pemangkasan menyebabkan sebagian besar keanehan. - Tulis galat alat sebagai instruksi yang bisa ditindaklanjuti. - Jejak adalah alat debug utama; bangun sebelum fitur kedua. 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 | 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. Q: Berapa langkah sebelum berhenti? A: 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. Q: Merencana dulu atau memutuskan sambil jalan? A: Tugas pendek baik-baik saja sambil jalan. Begitu tugas rutin melewati lima langkah, rencana eksplisit membuat eksekusi bisa diaudit dan kemajuan bisa ditunjukkan. Q: Kenapa agent saya mengulang panggilan gagal yang sama? A: Hampir selalu karena pesan galatnya tidak memuat informasi yang bisa ditindaklanjuti. Kembalikan galat singkat dan jelas, lalu tambahkan deteksi pengulangan. ## AI Agent atau Chatbot: Mana yang Sebenarnya Dibutuhkan Masalah Anda https://aiagentdevelopment.info/id/guides/ai-agent-atau-chatbot Diperbarui 2026-07-21 · Dasar agent - Chatbot menjawab; agent mengubah sistem di luar percakapan. - Perbedaannya menetapkan anggaran, pengujian, dan lingkar persetujuan. - Sebagian besar build yang sukses adalah hibrida: retrieval plus dua atau tiga alat. - Catat yang diminta pengguna tapi tak bisa dilakukan chatbot — itu peta jalan alat Anda. Kebanyakan tim yang meminta agent sebenarnya menggambarkan chatbot, dan cukup banyak yang meminta chatbot sebenarnya menggambarkan agent. Labelnya penting karena di luar kotak teks keduanya nyaris tak punya kesamaan: mode kegagalan berbeda, pengujian berbeda, persetujuan berbeda, kurva biaya berbeda. Garis pemisahnya sederhana. Apakah perangkat lunak perlu mengubah sesuatu di luar percakapan? Jika tidak — ia menjelaskan, merangkum, menyusun draf, mengambil informasi — Anda ingin chatbot, mungkin dengan retrieval, dan bisa tayang dalam hitungan minggu. Jika ya — ia memesan, mengembalikan dana, memperbarui, mengirim — Anda ingin agent dan harus merencanakan dalam hitungan bulan, karena pekerjaan yang menarik ada pada izin dan jalur pemulihan, bukan pada jawaban. ### Perbandingan jujurnya | Apa yang dihasilkan | Teks untuk dibaca | Perubahan di sistem, plus teks | | Kegagalan terburuk yang realistis | Jawaban salah yang ditindaklanjuti | Tindakan salah yang sudah terjadi | | Pengujian | Kualitas jawaban atas set pertanyaan | Kebenaran hasil sepanjang eksekusi | | Waktu bangun khas | 2–6 minggu | 2–4 bulan sampai produksi | | Siapa yang menyetujui | Konten dan dukungan | Ditambah keamanan, data, pemilik sistem | | Pendorong biaya berjalan | Token dan perawatan konten | Pergeseran integrasi dan perawatan evaluasi | ### Tanda Anda sebenarnya ingin chatbot - Keluaran bergunanya adalah penjelasan, rangkuman, atau draf yang akan ditinjau orang. - Pengetahuan Anda berubah lebih sering daripada prosesnya. - Tidak ada API yang Anda rela biarkan ditulisi perangkat lunak. - Nilainya adalah pengalihan: makin sedikit tiket mudah sampai ke manusia. ### Tanda Anda sebenarnya ingin agent - Orang yang membaca jawaban lalu melakukan lima klik di sistem lain. - Harus mencari sesuatu dulu sebelum tahu apa langkah berikutnya. - Sukses diukur sebagai transaksi selesai, bukan pembaca puas. - Seseorang sudah mengikuti daftar periksa, dan daftar itu bercabang. ### Hibrida yang biasanya menang Yang bertahan setelah bertemu pengguna nyata jarang murni: chatbot yang bisa memanggil dua atau tiga alat pilihan, dengan gerbang manusia di depan segala yang tak bisa dibatalkan. Anda dapat jalur cepat menuju nilai lewat jawaban berbasis retrieval, lalu menambahkan persis tindakan yang paling banyak menghapus klik. Instrumentasikan chatbot lebih dulu: catat apa yang diminta orang tapi tak bisa dilakukannya. Catatan itulah peta jalan alat Anda, diurutkan menurut permintaan. ### Bukan hanya kode yang berubah, tim juga Agent memindahkan tanggung jawab. Jawaban chatbot yang salah adalah masalah konten. Tindakan agent yang salah adalah insiden operasional milik pemilik sistem yang tersentuh — dan mereka wajar meminta jejak audit, cara membatalkan, dan batas seberapa banyak yang bisa keliru per jam. Anggarkan percakapan itu sejak awal. Q: Bisakah chatbot dinaikkan jadi agent nanti? A: Bisa, dan biasanya itu jalur termurah. Pisahkan lapisan retrieval, log, dan aset prompt dari lingkar jawaban, lalu tambahkan alat satu per satu dengan gerbang manusia. Q: Apakah chatbot selalu lebih murah? A: Per permintaan hampir selalu ya. Per hasil sering tidak: kalau agent menyelesaikan tugas yang menghabiskan delapan menit waktu staf, token tambahan tak berarti. Q: Mana yang lebih berisiko di bisnis teregulasi? A: Jelas agent, karena ia bertindak. Itu tidak menggugurkannya: artinya gerbang persetujuan, audit, dan jalur pembatalan adalah bagian pembangunan, bukan fase belakangan. ## Apa Itu AI Agent? Definisi yang Berguna untuk Pembangun https://aiagentdevelopment.info/id/guides/apa-itu-ai-agent Diperbarui 2026-07-21 · Dasar agent - AI agent memutuskan, bertindak lewat alat nyata, mengamati, lalu memutuskan lagi. - Enjiniringnya ada di lingkar dan kontrak alat; model hanyalah satu komponen. - Urutan tetap adalah alur kerja — lebih murah, lebih terduga, dan sering kali jawabannya. - Otonomi ditentukan per tindakan: hanya draf, hanya yang bisa dibatalkan, kotak pasir, atau bebas. Kata agent sudah ditarik sedemikian rupa sampai mencakup apa saja: dari sebuah prompt bernama bagus hingga sistem terdistribusi dengan jadwal jaganya sendiri. Ini bukan masalah kosakata, melainkan masalah anggaran: tim menyetujui satu hal dan menerima hal lain. Inilah definisi yang kami pakai saat menyusun ruang lingkup, dan sengaja dibuat sempit. AI agent adalah perangkat lunak di mana model bahasa memilih langkah berikutnya, memanggil alat nyata untuk melakukannya, membaca apa yang kembali, lalu memilih lagi — sampai tujuan tercapai atau sebuah batas menghentikannya. Jika tidak ada yang memanggil alat di sistem Anda, yang Anda punya adalah penghasil teks yang sangat baik. Jika urutannya sudah dipatok di awal, yang Anda punya adalah alur kerja dengan model di salah satu kotaknya. Keduanya sah. Keduanya tidak butuh anggaran agent. ### Produknya adalah lingkar, bukan model Setiap agent adalah tiga gerakan yang sama, diulang: memutuskan, bertindak, mengamati. Model hanya menyumbang bagian memutuskan. Selebihnya — alat apa yang ada, bagaimana kegagalannya dirumuskan, keadaan apa yang bertahan antar iterasi, kapan lingkar harus berhenti — adalah perangkat lunak biasa yang Anda tulis dan pertanggungjawabkan. Tim yang mengira produknya adalah model menghabiskan waktu pada prompt lalu heran hasilnya tidak andal. Tim yang memperlakukan lingkar sebagai produk mengerjakan kontrak alat dan syarat berhenti, dan mendapat sesuatu yang bisa di-debug pada sore yang buruk. Uji sederhana: jika model dicabut dan diganti orang yang membaca informasi sama, apakah sisa sistemnya masih masuk akal? Kalau tidak, perangkat lunak di sekitarnya terlalu tipis. ### Yang memisahkan agent dari hal-hal yang tertukar dengannya | Chatbot | Tidak ada — ia menjawab | Tidak | Jawaban salah atau karangan | | Alur kerja dengan langkah LLM | Pengembang, di awal | Ya, urutan tetap | Patah pada masukan di luar alur | | Agent | Model, saat berjalan | Ya, dipilih saat berjalan | Melantur, berputar, bertindak atas data buruk | | Sistem multi-agent | Beberapa model dan koordinator | Ya | Semua di atas, lebih sulit dilacak | ### Empat bagian yang dimiliki setiap agent nyata Lepaskan nama framework: setiap agent produksi yang pernah kami tangani punya empat bagian yang sama. - Tujuan yang bisa diperiksa. Bukan kesan: satu kalimat yang bisa ditandai benar atau salah. - Permukaan alat: fungsi konkret yang boleh dipanggil, dengan argumen bertipe dan galat yang jujur. - Pembawa keadaan: apa yang boleh dilihat iterasi berikutnya dari yang sebelumnya. - Syarat berhenti: batas langkah, batas belanja, dan aturan menyerahkan kendali ke manusia. ### Otonomi itu tombol putar, bukan sakelar Keputusan desain yang menarik bukan apakah memakai agent, melainkan seberapa panjang talinya. Dalam praktik ada empat setelan, dan proyek yang berhasil mulai lebih ke kiri daripada yang disarankan demo: agent menyusun draf dan manusia mengirim; agent bertindak pada yang bisa dibatalkan dan bertanya untuk yang tidak; agent bebas di kotak pasir dengan batas belanja; agent bebas di sistem produksi. Setiap langkah ke kanan mengalikan nilai sekaligus radius kerusakan. ### Di mana definisi ini menghasilkan uang Bersikap ketat menghemat di tiga titik. Saat menyusun ruang lingkup: lima panggilan API tetap dengan satu langkah rangkuman adalah alur kerja, dan membangunnya sebagai agent menambah ketidakpastian yang tak Anda perlukan. Saat mengestimasi: agent lebih mahal karena permukaan kegagalannya lebih luas. Saat mengevaluasi: agent hanya bisa diuji benar setelah Anda menerima bahwa masukan yang sama bisa menempuh jalur berbeda — artinya menguji hasil, bukan transkrip. Kalau ada yang meminta agent, tanyakan keputusan apa yang harus diambil perangkat lunak itu sendiri. Kalau tidak ada, Anda baru saja menghemat tiga bulan. Q: Apakah chatbot itu AI agent? A: Menurut definisi ini, bukan. Chatbot menjawab di dalam percakapan; agent bertindak di sistem di luarnya. Bot dukungan yang membaca basis data pesanan, menerbitkan pengembalian dana, dan mengirim email adalah agent — tindakannyalah yang mengubah kategorinya. Q: Haruskah agent otonom? A: Ia harus memilih langkah berikutnya sendiri, yang tidak sama dengan bertindak tanpa pengawasan. Agent yang merencanakan lima langkah, menjalankan empat, dan berhenti minta persetujuan di langkah kelima tetap agent. Q: Perlukah framework? A: Tidak. Agent berguna paling kecil adalah sebuah lingkar, daftar definisi alat, dan satu syarat berhenti — mungkin seratus baris. Framework baru berguna saat butuh state tahan lama, alur bercabang, atau koordinasi antar agent.