Memanggil Agent Lain

Dalam 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

Langkah 1: Buka Other Agents

Di sidebar kiri Atlas, buka Tools → Other Agents.

Halaman diawali dengan "Agents Atlas can call for help." Di bawahnya, kotak biru bertuliskan This is the outbound direction: di sini Anda menghubungkan agent yang bisa dimintai bantuan oleh Atlas. Untuk membuat agent lain bisa menjangkau Atlas, kotak itu menautkan ke Channels › Agent-to-Agent. Jika belum ada agent yang terhubung, Anda melihat No agents connected yet.

Langkah 2: Ambil card Ledger

1. Klik Connect agent. Panel Connect agent terbuka di sebelah kanan, dengan judul Connect over the A2A standard.
2. Tempelkan share link Ledger ke Agent card URL: https://api.qlar.ai/dialog/a2a/ledger-finance/card. Link harus diawali http:// atau https://.
3. Klik Fetch card.

qlar membaca card Ledger dan mengisi sisa form untuk Anda. Jika ada yang salah, pesan error muncul di bawah field, misalnya "Could not 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:

Langkah 4: Tambahkan key

Buka bagian Authentication jika masih tertutup. Auth Type 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 Auth Type lalu isi field yang muncul. Pilihannya sama dengan pada API tool, lihat Mengatur Autentikasi.

Langkah 5: Tulis usage rules (opsional)

Gunakan Usage rules (optional) 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

1. Klik Add agent di bagian bawah panel. Ledger muncul di daftar dengan badge A2A dan ikon hapus.
2. Klik Save all changes di bagian bawah halaman lalu konfirmasi. Anda seharusnya melihat Connected agents successfully updated!

Untuk mengubah agent yang terhubung di kemudian hari, klik barisnya; untuk menghapusnya, klik ikon hapus. Lalu klik Save all changes lagi.

Langkah 7: Uji di Preview, lalu publish

1. 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?
   

2. 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).

3. 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)

Di bawah daftar A2A, baris yang bisa dibuka-tutup bernama Classic connections (manual key) berisi koneksi lama berbasis key. Baris ini menampilkan jumlahnya, misalnya · 0. Koneksi ini masih berfungsi, tetapi metode classic akan segera dihentikan: gunakan Connect agent untuk semua yang baru.

Jika terpaksa menambahkannya, klik Add classic lalu isi:

Tambahkan dari panel, lalu klik Save all changes dan publish, sama seperti koneksi A2A.

Periksa hasilnya

1. Di Tools → Other Agents, Ledger tercantum dengan badge A2A.
2. 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.
3. 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.