Memanggil Agent Lain

Buka di CMS

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

Nilai
Agent AndaAtlas, asisten operasional Kirana Group
Agent yang Anda hubungkanLedger, asisten keuangan Kirana Group untuk pembayaran vendor
Share linkhttps://api.qlar.ai/dialog/a2a/ledger-finance/card
KeyMain key yang dibuat pemilik Ledger untuk "Atlas (Kirana operations)"
TujuanSaat 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.

Halaman Other Agents milik Atlas dengan pengantar Agents Atlas can call for help, notice This is the outbound direction yang menautkan ke Channels โ€บ Agent-to-Agent, field Search agents, menu More ways to connect, tombol Connect agent, dan tabel dengan kolom Agent, Description, dan Type yang berisi Ledger

Langkah 2: Ambil card Ledger

  1. Klik Connect agent. Drawer Connect agent terbuka di sebelah kanan. Bagian Agent card-nya menjelaskan bahwa Anda terhubung melalui standar A2A.
  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 "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.

Drawer Connect agent yang sudah terisi: bagian Agent card dengan Agent card URL https://api.qlar.ai/dialog/a2a/ledger-finance/card dan tombol Fetch card, bagian Agent details dengan Name Ledger, Description tentang pembayaran vendor Kirana Group, dan skill Ledger, bagian Connection dengan Authentication type Bearer dan Key yang disamarkan, kotak teks Usage rules, serta tombol Cancel dan Add agent

Langkah 3: Tinjau detailnya

Setelah card berhasil diambil, periksa field berikut:

FieldYang dilakukanNilai untuk Ledger
NameNama yang ditampilkan untuk agent ini. Biarkan, atau ganti dengan nama yang dikenali tim Anda.Ledger
DescriptionApa 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)
SkillsDaftar 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

  1. Klik Add agent di footer drawer, di sebelah Cancel. Ledger muncul di tabel dengan chip A2A pada kolom Type.
  2. Klik Save all changes di bar yang muncul di bagian bawah halaman, lalu konfirmasi. Anda seharusnya melihat Connected agents saved.
Tabel Other Agents dengan kolom Agent, Description, dan Type: Ledger, deskripsinya tentang pembayaran vendor Kirana Group, chip A2A di kolom Type dan menu Row actions, serta di bawah tabel catatan bahwa classic connections adalah tautan lama berbasis key

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

  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.

Preview Atlas: untuk pertanyaan tentang invoice USD 72,000 untuk baja gudang Surabaya, Atlas menjawab bahwa Finance membayar dengan Net 30 sejak invoice lengkap diterima lewat payment run setiap Selasa dan Jumat, bahwa Finance Controller harus memberi sign-off untuk invoice USD 72,000 ini, dan mendaftar dokumen yang harus diserahkan: nomor purchase order, delivery note atau service acceptance yang ditandatangani, faktur pajak vendor (Faktur Pajak), dan sign-off Finance Controller

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:

FieldYang diisi
NameNama pendek yang unik, misalnya ask_ledger
Agent codeKode agent lain
Agent keyKey yang dibuat di halaman Channels โ†’ Agent Keys milik agent lain
DescriptionApa yang dikerjakan agent lain dan kapan memanggilnya
Loading messageCara pesan "mohon tunggu" dihasilkan selama panggilan berjalan
Rules dan Response promptCara memakai dan menyajikan balasan

Tambahkan di drawer dengan Add connection, lalu klik Save all changes dan publish, sama seperti koneksi A2A.


Periksa hasilnya

  1. Di Tools โ†’ Other Agents, Ledger tercantum dengan chip 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