Lesson 9 / 12 · 10 min
Menghubungkan ke sistem Anda: API, webhook, dan MCP
Cara agent menjangkau sistem nyata Anda dengan aman: panggilan API, webhook masuk, MCP, dan aturan akses serta privasi yang menjaganya waras.
Agent yang hanya bisa bicara adalah demo. Agent yang bisa membaca katalog Anda, mengecek kalender, dan membuat lead adalah pekerja. Menghubungkannya ke sistem Anda adalah tempat nilai diciptakan, dan tempat risiko berada, jadi sepadan untuk memahami tiga cara hal itu terjadi.
API: jangkauan agent
Tools memanggil sistem Anda lewat API, CRM Anda, katalog Anda, kalender booking Anda. Agent meminta tool, kode Anda membuat panggilan API terautentikasi dan mengembalikan hasilnya. Beri tiap tool akses paling sempit yang dibutuhkan: tool lookup harga harus membaca katalog, bukan bisa menghapusnya.
Webhook: event yang masuk
Webhook adalah arah sebaliknya: sistem Anda memanggil agent saat sesuatu terjadi, pelanggan mengirim pesan, order dibuat, form dikirim. Webhook adalah pemicu yang memulai pekerjaan agent. Sebagian besar agent live memulai hidupnya sebagai handler untuk satu webhook masuk.
MCP: colokan standar
Model Context Protocol (MCP) adalah standar terbuka, diperkenalkan pada 2024 dan kini didukung berbagai tool AI besar, untuk membuka tools dan data ke agent secara seragam. Alih-alih menyambungkan tiap agent ke tiap sistem secara manual, Anda membuka satu sistem sekali lewat MCP dan agent kompatibel mana pun bisa memakainya. Anggap saja adapter universal antara agent dan tools Anda, seperti USB menstandarkan mencolok perangkat.
Akses, idempotensi, privasi
- Least privilege: read-only sebisa mungkin, tulis hanya field persis yang dibutuhkan.
- Idempotensi: desain aksi supaya retry tidak menagih ganda atau booking ganda.
- Privasi: putuskan data apa yang boleh keluar dari sistem Anda dan ke mana, sebelum menghubungkan apa pun.
- Audit: catat tiap aksi yang diambil agent, supaya Anda bisa menjawab apa yang dilakukannya dan kapan.
Yang Anda dapatkan
- API adalah cara tools menjangkau sistem Anda; batasi tiap tool ke akses paling sempit
- Webhook adalah pemicu masuk; sebagian besar agent mulai sebagai satu handler webhook
- MCP adalah colokan standar supaya Anda menyambung sistem sekali dan banyak agent memakainya
- Terapkan least privilege, aksi idempoten, keputusan privasi, dan audit log
Sumber terkurasi
Referensi pilihan untuk mendalami lebih jauh, direview oleh tim kami.