Mengizinkan Agent Lain Memanggil Agent Anda
Buka di CMSDalam tutorial ini Anda membuat agent Anda bisa dijangkau oleh agent lain. Anda akan menyalakan Agent-to-Agent, mengisi card agent Anda agar agent lain tahu apa yang bisa ditanyakan kepadanya, memilih tool mana yang boleh mereka pakai, dan membuat key untuk setiap agent yang Anda izinkan masuk.
Hanya untuk service agent. Agent lain tidak bisa menghubungi personal agent: Reachable by other agents dan pembuatan API key baru dinonaktifkan, dan mengubah agent menjadi Personal akan mematikan A2A serta mencabut API key-nya.
Sebelum memulai
- Baca Bekerja dengan Agent Lain untuk memahami arah outbound dan inbound.
- Agent Anda sudah menjawab pertanyaan spesialisnya dengan baik di Preview. Agent lain akan mengandalkan jawaban tersebut.
- Anda tahu cara publish perubahan. Lihat Preview dan Publish Perubahan.
- Anda punya akses Owner atau Contributor ke agent tersebut.
Tutorial ini dikerjakan di Ledger, asisten keuangan Kirana Group. Ledger menjawab pertanyaan tentang pembayaran vendor berdasarkan aturan pembayaran Kirana:
- Termin standar adalah Net 30 sejak invoice lengkap diterima.
- Payment run berlangsung setiap Selasa dan Jumat.
- Sebuah invoice membutuhkan nomor purchase order, delivery note atau service acceptance yang ditandatangani, dan Faktur Pajak dari vendor.
- Invoice di atas USD 50,000 juga membutuhkan sign-off Finance Controller.
Asisten operasional Kirana, Atlas, perlu bisa menanyakan hal-hal ini ke Ledger. Di sini Anda membuka Ledger untuk Atlas; setelah itu, di Atlas, Anda menghubungkan Ledger lewat Memanggil Agent Lain.
Langkah 1: Nyalakan Agent-to-Agent
- Di sidebar kiri Ledger, buka Channels โ Agent-to-Agent. Sebuah notice bertuliskan This is the inbound direction.
- Nyalakan Reachable by other agents.
Switch ini mati secara default. Switch ini terpisah dari pengaturan halaman chat publik: agent lain terhubung lewat link yang aman, bukan lewat halaman chat publik Anda. Bagian lain halaman ini baru muncul setelah switch dinyalakan.
Langkah 2: Salin share link
Di bawah Share Ledger terlihat link Ledger beserta tombol salin:
https://api.qlar.ai/dialog/a2a/ledger-finance/card
Link inilah yang Anda berikan kepada siapa pun yang ingin menghubungkan agent mereka. Mereka juga membutuhkan key dari Anda, yang Anda buat lewat Manage API keys (Langkah 6). Jika halaman bertuliskan "Save this agent first to get its link.", simpan halaman terlebih dahulu.
Catatan di bawah link menyebutkannya dengan jelas: "The link starts working once Ledger is published." Anda melakukan publish di Langkah 7.

Langkah 3: Isi agent card
Bagian Agent card menjelaskan agent Anda kepada agent lain, seperti kartu nama: siapa dia, apa keahliannya, dan cara menghubunginya.
Anda bisa meminta qlar membuatkan drafnya: klik Auto-fill with AI, atau klik Add suggestions pada banner "We can suggest questions, topics, and a description from Ledger's profile." Dismiss menyembunyikan banner. Tinjau dan edit hasil isiannya. Jika kolomnya sudah berisi, Auto-fill with AI meminta konfirmasi sebelum menggantinya.
| Field | Yang ditulis | Contoh Ledger |
|---|---|---|
| Example questions | Klik Add question untuk setiap pertanyaan. Agent lain membacanya untuk mengetahui apa yang bisa dikirim ke sini. Pertanyaan nyata yang dijawab dengan baik oleh agent Anda paling efektif. | When will Finance pay a vendor invoice? What does an invoice need before Kirana can pay it? |
| Topics | Opsional. Ketik sebuah topik lalu tekan Enter. Topik membantu agent lain menemukan agent Anda. | vendor-payments, invoices, payment-runs |
| Description | Opsional. Yang dilihat agent lain saat menemukan agent Anda. Awalnya diisi dari mission agent; edit seperlunya. | "Answers questions about Kirana Group vendor payments: payment terms, the Tuesday and Friday payment runs, and what an invoice needs before Finance can pay it." |
Tambahkan setidaknya satu contoh pertanyaan. Tanpa itu, sebuah notice di bawah daftar meminta Anda menambahkannya, dan agent lain tidak dapat menemukan agent Anda.
Tulis deskripsi untuk agent yang akan memanggil Anda. Atlas membacanya saat memutuskan apakah sebuah pertanyaan termasuk urusan Ledger, jadi sebutkan topik yang ditangani Ledger.
Buka Advanced technical details untuk melihat protokol (A2A, JSON-RPC 2.0), endpoint, dan batasan saat ini: agent Anda hanya membalas dalam bentuk teks, satu balasan lengkap per request, dan bisa berhenti sejenak untuk bertanya kepada agent pemanggil bila membutuhkan informasi tambahan.
Langkah 4: Pilih tool yang boleh dipakai pemanggil
Gulir ke bagian Tool access.
Agent lain selalu bisa mengajukan pertanyaan ke agent Anda. Selain itu, semuanya mati sampai Anda mengizinkannya. Nyalakan hanya yang Anda rela dipakai oleh agent milik tim lain.
Ledger menjawab dari knowledge-nya dan tidak punya tool, jadi bagian ini hanya bertuliskan: "Ledger has no tools yet. When you add tools, you can choose which ones other agents may use here." Tidak ada yang perlu dinyalakan. Atlas tetap bisa mengajukan pertanyaan ke Ledger.

Bila agent Anda punya tool, bagian ini mendaftarnya dan header-nya menunjukkan berapa tool yang diizinkan, misalnya 1 of 4 allowed:
- Gunakan Search tools atau filter All, Allowed, dan Not allowed untuk menemukan sebuah tool.
- Nyalakan setiap tool yang boleh dipakai pemanggil. Tool dikelompokkan menjadi Built-in (misalnya Web search), Your custom tools, MCP tools, dan Plugins. Klik judul grup untuk membukanya atau menutupnya.
Grup Always off di paling bawah berisi tool yang tidak bisa Anda ubah. Knowledge base bertanda Always on (read-only). Hand over to a person dan tool yang memanggil agent lain tidak pernah bisa diizinkan, sehingga pemanggil tidak dapat menjangkau supervisor Anda atau berantai ke agent Anda yang lain.
Contoh: misalkan nanti tim Finance memberi Ledger sebuah API read-only untuk mengecek status pembayaran invoice, dan API lain untuk menjadwalkan pembayaran. Izinkan hanya API pengecekan. Atlas lalu bisa memberi tahu project manager posisi sebuah invoice, tetapi tidak pernah bisa menjadwalkan pembayaran.
Langkah 5: Simpan
Bar di bagian bawah halaman berisi Save all changes dan Cancel. Tombolnya nonaktif sampai ada yang Anda ubah. Klik Save all changes lalu konfirmasi. Cancel membuang perubahan yang belum disimpan.
Langkah 6: Buat key untuk Atlas
Setiap agent yang terhubung membutuhkan key dari Anda. Tanpa key, tidak bisa masuk.
- Buka Channels โ Agent Keys. Halaman Agent-to-Agent menautkannya di bawah Manage API keys.
- Di Make a key for another agent, isi kedua field:
- Who is this key for?: beri nama sesuai pemanggilnya. Untuk Ledger, isi
Atlas (Kirana operations). - How long should it work?: 7, 14, 30, 90, atau 365 hari. Pilih 365 days. Key berhenti berfungsi dengan sendirinya saat waktunya habis.
- Who is this key for?: beri nama sesuai pemanggilnya. Untuk Ledger, isi
- Klik Create key. CMS bertanya Add this agent key? Konfirmasi.
- Setelah pesan sukses, key baru terbuka di side drawer, bertanda Active. Salin Main key lalu kirimkan, bersama share link dari Langkah 2, kepada pemilik Atlas. Tabel Keys you've handed out mencantumkan key itu dengan Status dan Expiry (Expires in 1 year).

Klik sebuah baris di tabel untuk membuka key di side drawer. Setiap key punya dua nilai: Main key untuk dibagikan dan Backup key untuk disiapkan, sehingga Anda bisa mengganti key tanpa downtime. Di drawer Anda juga bisa:
| Action | Fungsinya |
|---|---|
| Replace | Membuat nilai baru untuk main key atau backup key. Nilai lama langsung berhenti berfungsi, dan Anda memilih berapa lama nilai baru berlaku (New key lasts). |
| Turn off / Turn back on | Memblokir kedua nilai key seketika, atau mengizinkannya lagi. Kolom Status menampilkan Turned off atau Active. Anda juga bisa memakai menu baris di tabel. |
| Rename | Mengganti nama key di Key name. Tombol nonaktif sampai nama berubah. |
| Delete key | Menghapus key secara permanen. Kedua nilainya berhenti berfungsi. |
Langkah 7: Publish
Klik Publish di bagian atas CMS. Share link Ledger baru berfungsi setelah Ledger di-publish, dan agent lain selalu berbicara dengan versi yang sudah di-publish.
Agent Keys dan protokol classic
Key di Channels โ Agent Keys melayani dua jenis pemanggil:
- Pemanggil A2A, seperti dijelaskan di atas. Key yang dimatikan atau kedaluwarsa akan ditolak.
- Pemanggil classic, yang memakai koneksi lama berbasis key: pemilik agent lain memasukkan kode agent Anda dan salah satu key Anda di bawah Classic connections (manual key) pada halaman Tools โ Other Agents mereka.
Protokol classic akan segera dihentikan. Saat dihentikan, halaman Agent Keys akan digabung ke Agent-to-Agent. Sampai saat itu, biarkan key milik pemanggil classic tetap ada, dan berikan share link plus key kepada pemanggil baru agar mereka terhubung lewat A2A.
Periksa hasilnya
- Di Atlas, hubungkan Ledger dengan share link dan key, seperti dijelaskan di Memanggil Agent Lain.
- Di Preview Atlas, tanyakan "When will Finance pay a vendor invoice?". Atlas seharusnya mendapat jawaban dari Ledger: Net 30 sejak invoice lengkap diterima, pada payment run hari Selasa atau Jumat.
- Di halaman Agent Keys milik Ledger, buka key "Atlas (Kirana operations)", klik Turn off, lalu tanyakan lagi. Atlas seharusnya tidak lagi bisa menjangkau Ledger. Klik Turn back on setelah selesai.
Langkah berikutnya
- Berikutnya dalam alur: Mengajarkan Skill ke Agent, untuk memberi agent Anda prosedur tertulis bagi situasi tertentu.
- Memanggil Agent Lain: arah outbound, dikerjakan di Atlas.
- Referensi: Agent-to-Agent dan Agent Keys.