Memanggil Agent Lain
Buka di CMSDalam tutorial ini Anda menghubungkan agent lain ke agent Anda, sehingga agent Anda bisa menyerahkan sebuah pertanyaan kepadanya dan memakai balasannya dalam jawaban sendiri. Anda akan menempelkan share link agent lain, meninjau kemampuannya, menambahkan key-nya, dan menguji penyerahannya di Preview.
Anda bekerja di Atlas, asisten operasional Kirana Group, dan menghubungkan Ledger, asisten keuangan Kirana Group. SOP milik Atlas menyebutkan siapa yang menyetujui pembelian, tetapi tidak menyebutkan kapan Finance membayar vendor. Ledger mengetahuinya, jadi Atlas bertanya ke Ledger.
Sebelum memulai
-
Baca Bekerja dengan Agent Lain untuk memahami arah outbound dan inbound.
-
Anda punya dua hal dari pemilik agent lain tersebut:
- share link-nya (URL agent card), dan
- sebuah key yang memungkinkan agent Anda terhubung.
Jika agent lain itu adalah agent qlar, pemiliknya menemukan share link di Channels โ Agent-to-Agent dan membuat key di Channels โ Agent Keys. Pada contoh Kirana, tim Finance melakukannya di Ledger lewat Mengizinkan Agent Lain Memanggil Agent Anda. Jika Anda memiliki kedua agent, ikuti halaman itu pada agent lain terlebih dahulu.
-
Anda punya akses Owner atau Contributor ke agent Anda.
Skenario yang dipakai dalam tutorial ini
| Nilai | |
|---|---|
| Agent Anda | Atlas, asisten operasional Kirana Group |
| Agent yang Anda hubungkan | Ledger, asisten keuangan Kirana Group untuk pembayaran vendor |
| Share link | https://api.qlar.ai/dialog/a2a/ledger-finance/card |
| Key | Main key yang dibuat pemilik Ledger untuk "Atlas (Kirana operations)" |
| Tujuan | Saat seseorang bertanya ke Atlas kapan sebuah invoice vendor dibayar, Atlas bertanya ke Ledger lalu meneruskan jawabannya |
Langkah 1: Buka Other Agents
Di sidebar kiri Atlas, buka Tools โ Other Agents.
Halaman diawali dengan "Agents Atlas can call for help." Di bawahnya, notice berjudul This is the outbound direction menjelaskan bahwa di sini Anda menghubungkan agent yang bisa dimintai bantuan oleh Atlas. Untuk membuat agent lain bisa menjangkau Atlas, notice itu menautkan ke Channels โบ Agent-to-Agent. Toolbar berisi kotak pencarian, tombol Connect agent, dan menu More ways to connect (โฎ). Jika belum ada agent yang terhubung, Anda melihat No agents connected yet.

Langkah 2: Ambil card Ledger
- Klik Connect agent. Drawer Connect agent terbuka di sebelah kanan. Bagian Agent card-nya menjelaskan bahwa Anda terhubung melalui standar A2A.
- Tempelkan share link Ledger ke Agent card URL:
https://api.qlar.ai/dialog/a2a/ledger-finance/card. Link harus diawalihttp://atauhttps://. - Klik Fetch card.
qlar membaca card Ledger dan mengisi sisa form untuk Anda. Jika ada yang salah, pesan error muncul di bawah field, misalnya "Couldn't reach that card URL. Check it and try again." Periksa link tersebut bersama pemilik agent lain. Untuk agent qlar, link baru berfungsi setelah agent itu menyalakan Reachable by other agents dan sudah di-publish.

Langkah 3: Tinjau detailnya
Setelah card berhasil diambil, periksa field berikut:
| Field | Yang dilakukan | Nilai untuk Ledger |
|---|---|---|
| Name | Nama yang ditampilkan untuk agent ini. Biarkan, atau ganti dengan nama yang dikenali tim Anda. | Ledger |
| Description | Apa yang dikerjakan agent ini. Agent Anda membacanya untuk memutuskan kapan memanggilnya, jadi pastikan deskripsinya spesifik. | "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." (dari card Ledger) |
| Skills | Daftar read-only dari card agent lain. Bila jumlahnya banyak, klik Show N more untuk melihat semuanya, lalu Show fewer untuk menciutkannya. | Satu skill, Ledger, dengan deskripsi yang sama |
Langkah 4: Tambahkan key
Di bagian Connection, blok Authentication menampilkan Authentication type yang sudah terpilih sesuai yang diiklankan card. Untuk agent qlar nilainya Bearer: tempelkan key yang Anda terima dari pemilik Ledger ke Key.
Jika agent lain memakai metode berbeda, pilih metodenya di Authentication type lalu isi field yang muncul. Pilihannya sama dengan pada API tool, lihat Mengatur Autentikasi.
Langkah 5: Tulis usage rules (opsional)
Gunakan Usage rules (opsional) untuk memberi tahu agent Anda kapan harus memanggil agent ini, atau bagaimana memakai balasannya. Untuk Atlas, isi:
Ask Ledger about vendor payments, invoices and payment runs. Do not ask Ledger about project approvals or site safety; answer those yourself from the SOPs.
Kalimat kedua penting: Atlas sudah menjawab pertanyaan approval dan keselamatan dari SOP-nya sendiri, jadi Atlas tidak perlu membuang satu lompatan ke Ledger untuk pertanyaan itu.
Langkah 6: Tambahkan agent dan simpan
- Klik Add agent di footer drawer, di sebelah Cancel. Ledger muncul di tabel dengan chip A2A pada kolom Type.
- Klik Save all changes di bar yang muncul di bagian bawah halaman, lalu konfirmasi. Anda seharusnya melihat Connected agents saved.

Untuk mengubah agent yang terhubung di kemudian hari, klik barisnya. Untuk menghapusnya, buka Row actions pada barisnya lalu pilih Delete. Kemudian klik Save all changes lagi.
Langkah 7: Uji di Preview, lalu publish
-
Di panel preview, klik tombol reload untuk memulai percakapan baru, lalu tanyakan sesuatu yang hanya bisa dijawab Ledger:
A vendor sent a USD 72,000 invoice for the Surabaya warehouse steel. When will Finance pay it, and what does the invoice need? -
Atlas memanggil Ledger dan menjawab dengan aturan pembayaran Kirana: Finance membayar dengan termin Net 30 sejak invoice lengkap diterima, dalam payment run setiap Selasa dan Jumat. Karena nilai invoice di atas USD 50,000, Finance Controller harus memberi sign-off sebelum invoice bisa masuk payment run. Invoice membutuhkan nomor purchase order yang sesuai, delivery note atau service acceptance yang sudah ditandatangani, dan faktur pajak vendor (Faktur Pajak).
-
Bila sudah puas, klik Publish di bagian atas CMS agar user live mendapatkan koneksi baru tersebut. Lihat Preview dan Publish Perubahan.

Semua informasi ini tidak ada di knowledge Atlas sendiri. Jika Atlas menjawab tanpa memanggil Ledger, atau mengatakan tidak tahu, buat Description dan Usage rules lebih spesifik tentang kapan Ledger harus dipakai.
Classic connections (manual key)
Classic connections adalah koneksi lama berbasis key. Koneksi ini tampil di tabel yang sama dengan chip Classic. Koneksi ini masih berfungsi, tetapi metode classic akan segera dihentikan: gunakan Connect agent untuk semua yang baru.
Jika terpaksa menambahkannya, buka menu More ways to connect (tombol โฎ di sebelah Connect agent), pilih Add classic connection, lalu isi:
| Field | Yang diisi |
|---|---|
| Name | Nama pendek yang unik, misalnya ask_ledger |
| Agent code | Kode agent lain |
| Agent key | Key yang dibuat di halaman Channels โ Agent Keys milik agent lain |
| Description | Apa yang dikerjakan agent lain dan kapan memanggilnya |
| Loading message | Cara pesan "mohon tunggu" dihasilkan selama panggilan berjalan |
| Rules dan Response prompt | Cara memakai dan menyajikan balasan |
Tambahkan di drawer dengan Add connection, lalu klik Save all changes dan publish, sama seperti koneksi A2A.
Periksa hasilnya
- Di Tools โ Other Agents, Ledger tercantum dengan chip A2A.
- Di percakapan Preview yang baru, pertanyaan tentang invoice USD 72,000 mendapat jawaban berisi Net 30, payment run Selasa dan Jumat, sign-off Finance Controller, dan tiga dokumen yang dibutuhkan.
- Ajukan pertanyaan approval, misalnya "Who has to approve a project worth $2.5 million?". Atlas seharusnya menjawab sendiri dari SOP-FIN-007, tanpa bertanya ke Ledger.
Langkah berikutnya
- Berikutnya dalam langkah ini: Mengizinkan Agent Lain Memanggil Agent Anda, untuk melihat bagaimana Ledger dibuka untuk Atlas.
- Referensi Other Agents: setiap field di layar ini.
- Berikutnya dalam alur: Mengajarkan Skill ke Agent.