- Panduan yang menyatukan 6 protokol agen AI seperti MCP, A2A, UCP, AP2, A2UI, dan AG-UI dalam satu skenario agen rantai pasok restoran, lalu menjelaskan masalah yang diselesaikan tiap protokol langkah demi langkah beserta kode praktiknya
- Dengan memanfaatkan Agent Development Kit (ADK) dari Google, struktur ini dimulai dari LLM kosong lalu menambahkan protokol satu per satu hingga mencakup pengecekan inventaris, penawaran harga, pemesanan, pembayaran, dan rendering dashboard
- MCP menangani koneksi alat/data, A2A komunikasi antargen, UCP standardisasi perdagangan, AP2 otorisasi pembayaran, A2UI komposisi UI, dan AG-UI pengiriman streaming
- Setiap protokol berbagi pola umum seperti discovery berbasis URL yang sudah dikenal, skema bertipe, dan aliran event standar untuk memastikan kompatibilitas ekosistem
- Tidak perlu mengadopsi keenamnya sejak hari pertama; pendekatan yang disarankan adalah menambahkan secara bertahap sesuai kebutuhan
MCP (Model Context Protocol) — koneksi alat dan data
- Protokol ini menyelesaikan hambatan pertama saat menghubungkan agen ke sistem dan data, dengan menghilangkan pekerjaan manual menulis kode integrasi kustom untuk setiap API
- Saat server MCP mengiklankan (advertise) alatnya sendiri, agen dapat melakukan discovery secara otomatis, sehingga menyediakan satu pola koneksi standar untuk ratusan server
- Karena server MCP dipelihara oleh tim yang membuat sistem tersebut, sisi agen selalu mendapatkan definisi alat terbaru tanpa perlu menulis atau memperbarui kode integrasi
- Di ADK, protokol ini didukung sebagai fitur kelas satu melalui McpToolset; dalam contoh, diterapkan untuk kueri database PostgreSQL (MCP Toolbox for Databases), pengambilan resep melalui Notion MCP, dan pengiriman email pemasok melalui Mailgun MCP
- Hubungkan DB inventaris dengan
ToolboxToolset
- Hubungkan layanan eksternal seperti Notion dan Mailgun dengan
McpToolset
- Pola yang ringkas: jalankan server MCP dengan perintah
npx dan langsung hubungkan ke agen tanpa kode tambahan
A2A (Agent2Agent Protocol) — komunikasi antaragen
- Setelah MCP menyelesaikan akses data, protokol ini menangani masalah keahlian (expertise) yang tersisa dengan menyediakan metode discovery dan komunikasi standar antaragen jarak jauh yang dijalankan oleh tim, framework, dan server yang berbeda
- Setiap agen A2A menerbitkan Agent Card di
/.well-known/agent-card.json untuk mengekspos nama, kemampuan, dan endpoint; agen manajer dapur mengambilnya dan merutekan kueri saat runtime ke agen yang tepat
- Saat menambahkan agen jarak jauh baru, cukup tambahkan URL-nya saja, tanpa perubahan kode manual atau redeploy
RemoteA2aAgent di ADK merutekan ke satu agen jarak jauh per giliran; jika perlu mengueri beberapa agen jarak jauh secara bersamaan, gunakan a2a-sdk secara langsung- Dengan fungsi
to_a2a(), semua agen ADK dapat diubah menjadi layanan A2A
- Meski data mentah seperti cek harga, grade kualitas, atau jendela pengiriman tidak diekspos sebagai API, data itu tetap bisa diakses melalui antarmuka agentic
UCP (Universal Commerce Protocol) — standardisasi perdagangan
- Protokol ini menyatukan proses pemesanan yang sebelumnya memiliki API berbeda di tiap pemasok, dengan menstandarkan siklus hidup belanja menjadi kemampuan modular
- Konsistensi dijaga melalui skema request/response bertipe kuat, dan pola kerjanya tetap sama terlepas dari lapisan transport bawahnya, apakah REST, MCP, A2A, atau EP (protokol embedded berbasis browser)
- Seperti A2A, discovery katalog pemasok dapat dilakukan melalui pola URL
/.well-known/ucp
- Tidak memerlukan SDK proprietari; bisa langsung terhubung ke REST API standar menggunakan klien HTTP yang sudah ada
- Dalam contoh,
CheckoutCreateRequest digunakan untuk memesan 10 pon salmon dan 3 botol minyak zaitun, lalu PaymentCreateRequest digunakan untuk menyusun permintaan pembayaran
- Repositori contoh UCP mencakup contoh asisten belanja berbasis AI yang menggabungkan ADK dan A2A
AP2 (Agent Payments Protocol) — otorisasi pembayaran dan jejak audit
- Jika UCP menangani apa yang dipesan dan dari pemasok mana, AP2 menangani siapa yang menyetujui pembelian serta jejak auditnya
- Mandate bertipe memberikan non-repudiatable proof of intent, dan setiap transaksi dapat diberi guardrail yang bisa dikonfigurasi
- Alur lengkapnya:
IntentMandate → PaymentMandate (ditandatangani) → PaymentReceipt
- IntentMandate: menetapkan guardrail seperti merchant yang diizinkan, batas pengeluaran, apakah auto-approve diaktifkan, kebutuhan dapat direfund, waktu kedaluwarsa, dan lain-lain
- PaymentMandate: mandat pembayaran yang terikat ke keranjang dan jumlah tertentu; jika melebihi batas, statusnya tetap belum ditandatangani sampai ada persetujuan eksplisit dari manajer
- PaymentReceipt: kuitansi yang melengkapi jejak audit
- Protokol ini bekerja sebagai extension dari UCP dengan menambahkan bukti otorisasi terenkripsi ke alur checkout
- Saat ini masih di tahap v0.1, belum tertanam di inti ADK, dan menyediakan tipe melalui paket terpisah
A2UI (Agent-to-User Interface Protocol) — komposisi UI dinamis
- Protokol ini memungkinkan agen menyusun secara dinamis dashboard, formulir pemesanan, tabel perbandingan pemasok, dan lainnya alih-alih hanya mengembalikan teks biasa
- Layout baru dikombinasikan dalam format JSON deklaratif dari katalog tetap berisi 18 primitif komponen yang aman seperti row, column, dan text field
- Struktur UI dan data dipisahkan, sehingga hanya data yang bisa diperbarui tanpa mengirim ulang komponen
- Komponen dikirim sebagai daftar datar yang saling mereferensikan lewat ID
- Data dikirim melalui
dataModelUpdate yang terpisah
- Renderer di sisi klien mengubah JSON menjadi UI native seperti Lit, Flutter, Angular
- Agen yang sama dapat menghasilkan antarmuka yang sepenuhnya berbeda seperti checklist inventaris, formulir pesanan, dan perbandingan pemasok hanya dengan 18 primitif yang sama
- Di antarmuka web ADK (
adk web), komponen A2UI dapat dirender secara native, jadi tidak perlu membangun renderer terpisah saat pengembangan
- Dengan A2UI Widget Builder, layout dapat disusun secara interaktif
AG-UI (Agent-User Interaction Protocol) — pengiriman streaming
- Tidak seperti REST API tradisional, agen memiliki pola interaksi yang kompleks: men-streaming teks secara bertahap, memanggil alat di tengah respons, atau berhenti sementara sambil menunggu input manusia
- AG-UI bekerja sebagai middleware yang mengubah event mentah spesifik framework menjadi aliran SSE yang terstandar
- Frontend cukup menerima event bertipe seperti
TEXT_MESSAGE_CONTENT dan TOOL_CALL_START, tanpa perlu tahu framework agen mana yang menghasilkannya
- ADK memang menyediakan endpoint native
/run_sse, tetapi AG-UI menyelesaikan masalah parsing boilerplate dan kerentanan saat format event berubah
- Cukup bungkus dengan paket
ag_ui_adk lalu mount ke aplikasi FastAPI untuk menyiapkan endpoint streaming AG-UI
Alur kerja integrasi secara keseluruhan
- Saat pengguna meminta “cek stok salmon, lihat harga grosir dan grade kualitas hari ini, lalu jika stok kurang pesan 10 pon dari Example Wholesale dan otorisasi pembayarannya”, keenam protokol bekerja bertahap
- Tahap 1 — pengumpulan informasi: kueri DB inventaris dengan MCP (
check_inventory) → kueri ke agen harga dan kualitas jarak jauh dengan A2A (ask_agent)
- Tahap 2 — penyelesaian transaksi: permintaan checkout dengan UCP (
place_order) → perolehan mandate pembayaran dalam guardrail yang telah ditetapkan dengan AP2 (authorize_payment)
- Tahap 3 — menampilkan hasil: menyusun widget interaktif dengan A2UI → men-streaming pemanggilan alat dan respons teks secara real-time dengan AG-UI
Tips memanfaatkan protokol
- Arsitektur akan tetap rapi jika masalah yang diselesaikan tiap protokol dipahami dengan tepat
- Tidak semua dari keenam protokol dibutuhkan sejak awal; kebanyakan kasus dimulai dari MCP, lalu ditambah bertahap sesuai kebutuhan seperti komunikasi multiagen, perdagangan, pembayaran, rich UI, dan streaming
- Sebelum membangun langsung dengan protokol, periksa dulu integrasi ADK, SDK resmi, dan contoh kode agar tidak mengimplementasikan ulang sendiri
- Meski protokol-protokol ini masih terus matang, mengadopsi lebih awal pola seperti discovery URL yang sudah dikenal, skema bertipe, dan aliran event standar membantu menjaga kompatibilitas dengan ekosistem alat, layanan, dan agen
1 komentar
Kalau dikumpulkan begini, ternyata protokol terkait AI banyak sekali ya.