Mengizinkan Agent Lain Memanggil Agent Anda

Dalam 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.

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

1. Di sidebar kiri Ledger, buka Channels → Agent-to-Agent. Sebuah kotak biru bertuliskan This is the inbound direction.
2. 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

Tab Agent card (judul Configure Ledger's 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.

Tambahkan setidaknya satu contoh pertanyaan. Tanpa itu, sebuah peringatan muncul di tab dan agent lain tidak dapat menemukan agent Anda. Penghitung di samping label menunjukkan jumlahnya, misalnya · 2 questions.

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

Buka tab 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 tab 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, tab ini mendaftarnya dan header-nya menunjukkan berapa tool yang diizinkan, misalnya 1 of 4 allowed:

1. Gunakan Search tools atau filter All, Allowed, dan Not allowed untuk menemukan sebuah tool.
2. Nyalakan setiap tool yang boleh dipakai pemanggil. Tool dikelompokkan menjadi Built-in (misalnya Web search), Your custom tools, MCP tools, dan Plugins.

Bagian tetap di paling bawah berisi tool yang tidak bisa Anda ubah. Knowledge base selalu menyala (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

Klik Save all changes di bagian bawah halaman lalu konfirmasi.

Langkah 6: Buat key untuk Atlas

Setiap agent yang terhubung membutuhkan key dari Anda. Tanpa key, tidak bisa masuk.

1. Buka Channels → Agent Keys. Halaman Agent-to-Agent menautkannya di bawah Manage API keys.
2. Di bawah Make a key for another agent, isi kedua kotak:
   • 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.
3. Klik Create key. CMS bertanya Are you sure to add this agent key? Konfirmasi.
4. Key baru terbuka di daftar Keys you've handed out, bertanda Active dan Expires in 1 year. Salin Main key lalu kirimkan, bersama share link dari Langkah 2, kepada pemilik Atlas.

Setiap entri key punya dua nilai: Main key untuk dibagikan dan Backup key untuk disiapkan, sehingga Anda bisa mengganti key tanpa downtime. Di setiap entri Anda juga bisa:

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

1. Di Atlas, hubungkan Ledger dengan share link dan key, seperti dijelaskan di Memanggil Agent Lain.
2. 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.
3. Di halaman Agent Keys milik Ledger, klik Turn off untuk key "Atlas (Kirana operations)" 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.