Alat

Alat digunakan untuk menghubungkan agen Anda ke sistem eksternal atau kode inline yang disediakan untuk agen. Dengan demikian, agen Anda dapat berinteraksi dengan sistem lain untuk mengambil, memperbarui, memformat, atau menganalisis informasi. Bagian di halaman ini menjelaskan berbagai jenis alat yang didukung.

Membuat alat

Untuk membuat alat:

1. Klik ikon alat di sisi kanan pembuat agen.
2. Pilih jenis alat (lihat deskripsi jenis alat dalam dokumen ini).
3. Berikan informasi yang diminta untuk alat tersebut.
4. Gunakan snake case untuk nama alat.
5. Deskripsi alat diberikan ke model agen.

Menggunakan alat di agen

Setelah membuat alat, Anda perlu menginstruksikan agen tertentu untuk menggunakan alat tersebut.

1. Arahkan kursor ke agen.
2. Klik Tambahkan alat.
3. Pilih alat.
4. Jelaskan cara penggunaan alat tersebut dalam petunjuk agen Anda.

Menguji alat

Sebelum menggunakan alat di agen Anda, Anda dapat menguji alat di konsol:

1. Buka panel alat.
2. Klik tombol Alat Pengujian di bagian atas panel.

3. Berikan input untuk alat sebagaimana ditentukan oleh skema alat. Misalnya, jika skemanya adalah JSON dengan properti place dan city, Anda dapat menggunakan input berikut:

   {
     "place": "automobile repair center",
     "city": "austin texas"
   }
   

4. Klik Kirim. Alat dijalankan dengan input, dan output diisi.

Setelah menguji alat secara langsung, Anda juga dapat menguji alat dengan menggunakan Preview agent.

Alat yang tersedia

Alat berikut tersedia:

Alat	Deskripsi
A2A Protocol	Hubungkan agen Anda ke agen eksternal menggunakan standar pesan A2A. (Pratinjau)
Agen sebagai alat	Menggunakan kembali kemampuan agen tanpa menyerahkan ke agen lain.
Alat fungsi klien	Alat kode yang dieksekusi di sisi klien, bukan oleh agen.
Alat Confluence	Hubungkan agen Anda ke instance Confluence.
Alat penyimpanan data	Memberikan respons agen yang dihasilkan AI berdasarkan konten situs dan data yang diupload.
Alat penelusuran file	Mengupload file atau menyediakan pusat informasi RAG ke agen.
Alat Google Maps	Hubungkan agen Anda ke Google Maps. (Pratinjau)
Alat Google Penelusuran	Hubungkan agen Anda dengan kecanggihan perujukan dengan Google Penelusuran.
Alat Integration Connector	Buat alat yang menggunakan Koneksi yang telah Anda konfigurasi.
Alat Jira	Menghubungkan agen Anda ke instance Jira.
Alat MCP	Terhubung ke server MCP.
Alat OpenAPI	Terhubung ke API eksternal menggunakan skema OpenAPI.
Alat kode Python	Menyediakan kode Python sebagai alat untuk agen Anda.
Alat Salesforce	Hubungkan agen Anda ke instance Salesforce.
Alat Service Now	Hubungkan agen Anda ke instance Service Now.
Alat SharePoint	Hubungkan agen Anda ke instance SharePoint.
Alat sistem	Alat bawaan yang dapat digunakan oleh agen untuk melakukan tugas umum.
Alat widget	Alat widget yang fleksibel untuk menciptakan interaksi pengguna yang kaya.

Jenis eksekusi

Alat mendukung dua jenis eksekusi: asinkron (tidak memblokir) dan sinkron (memblokir). Memilih jenis eksekusi yang sesuai bergantung pada latensi alat dan pengalaman agen yang diinginkan. Setelan ini tersedia di tab Lanjutan pada konfigurasi alat.

Jenis eksekusi sinkron

Jenis ini harus digunakan saat eksekusi alat harus memblokir pembuatan respons agen hingga respons alat tersedia. Agen tidak akan membuat respons apa pun hingga respons alat tersedia. Idealnya, alat ini memiliki latensi rendah (kurang dari 5 detik) untuk menjaga latensi respons keseluruhan agen tetap rendah.

Jenis eksekusi asinkron

Jenis ini harus digunakan untuk eksekusi alat yang tidak memblokir. Saat panggilan alat dipicu, agen akan melanjutkan dengan respons "tertunda". Agen dapat terus berbicara dengan pengguna saat respons alat sedang diambil. Setelah respons tersedia, respons tersebut ditambahkan ke konteks saat respons agen berikutnya dibuat. Idealnya digunakan untuk alat dengan latensi respons 5-60 detik.

Alur percakapan untuk jenis eksekusi asinkron:

1. Agen memicu panggilan fungsi: Agen memicu panggilan fungsi dan menunggu respons. Misalnya, panggil alat status pesanan.
2. Respons alat tertunda: Alat ini akan segera menampilkan function_response yang berisi status tertunda, seperti "status": "pending".
3. Agen menangani alat yang tertunda: Agen harus diberi petunjuk untuk menangani respons yang tertunda sesuai keinginan. Contoh petunjuk: "Tanyakan kepada pengguna apakah ada pertanyaan lain saat Anda mengambil status pesanan". Contoh respons agen: "Ada hal lain yang dapat kami lakukan untuk Anda saat kami mengambil status pesanan Anda?".

4. Agen menangani respons akhir: Respons alat yang sebenarnya tersedia untuk agen. Hal ini akan disertakan sebagai tag konteks. Contoh:

   <context>function [<tool_name>] completed with response <response JSON></context>
   

Praktik terbaik

Gunakan praktik terbaik berikut untuk alat:

• Selalu tulis nama alat yang bermakna secara semantik dan relevan dengan tugas yang mereka lakukan.
• Selalu berikan deskripsi berkualitas tinggi tentang alat Anda dan tugas yang dapat diselesaikan oleh alat tersebut.
• Untuk alat asinkron, sertakan petunjuk mendetail untuk skenario berikut:
  • Beri tahu agen bahwa adalah alat asinkron dan awalnya akan menampilkan respons tertunda.
  • Sertakan petunjuk tentang cara agen harus merespons saat alat menampilkan "tertunda".
  • Sertakan petunjuk tentang cara agen harus merespons saat respons alat yang sebenarnya tersedia.
  • Sertakan petunjuk tentang cara agen harus merespons jika alat menampilkan error.