Merancang agen di Agent Studio

Pratinjau

Fitur agen desain di Agent Studio tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Hubungan dengan Persyaratan Lainnya. Fitur agen desain di Agent Studio membantu Pelanggan mendesain "Agen AI" sebagaimana didefinisikan dalam Persyaratan Khusus Layanan dan dengan demikian Persyaratan Khusus Layanan "Layanan AI Agentik" berlaku. Saat menggunakan Google Penelusuran sebagai alat di Agent Studio, bagian yang berjudul "Grounding with Google Search" dalam Persyaratan Khusus Layanan juga berlaku, kecuali bahwa referensi pertama ke 'Gemini Enterprise atau Agentspace' di subpasal (iv) bagian "Layanan AI agentic" diganti dengan 'Gemini Enterprise Agent Platform'. Pastikan Anda meninjau persyaratan alat lain yang digunakan di Agent Studio dan memverifikasi bahwa agen Anda sesuai untuk deployment di Agent Runtime sebelum menggunakan fitur tersebut.

Halaman ini memberikan ringkasan tentang cara menggunakan Agent Studio di konsol Google Cloud .

Agent Studio adalah visual designer low-code dalam konsol Google Cloud yang menyederhanakan pengembangan agen. Anda dapat memetakan alur kerja agen secara visual, menguji respons secara real time, dan bereksperimen dengan berbagai konfigurasi sebelum men-deploy atau beralih ke kode.

Dokumen ini memberikan ringkasan Agent Studio dan menjelaskan cara menyiapkan lingkungan, membuat dan menguji agen, serta men-deploy-nya langsung ke runtime produksi.

Menyiapkan lingkungan Anda

Sebelum menggunakan Agent Studio, lakukan penyiapan dengan Google Cloud.

Mendapatkan peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menggunakan Agent Studio, minta administrator Anda untuk memberi Anda peran IAM Agent Platform User (roles/aiplatform.user) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Buat agen

Catatan: Semua file konfigurasi untuk agen yang dibuat disimpan di region us-west1. Jika organisasi Anda memiliki kebijakan yang mencegah Anda menggunakan region ini, Anda mungkin tidak dapat membuat agen. Untuk mengetahui informasi selengkapnya, lihat Membatasi lokasi resource.

Gunakan langkah-langkah berikut untuk mendesain dan menguji agen di Agent Studio:

1. Di konsol Google Cloud , buka halaman Agen.
   

   Buka Agen

2. Klik Buat agen untuk membuka kanvas Agent Studio bagi agen baru.

3. Rancang agen Anda di kanvas Agent Studio. Anda dapat beralih di antara tab berikut:

   • Alur: Buat agen utama dan sub-agen menggunakan representasi visual alur kerja dan logika kontrol agen Anda.

     1. Klik agen untuk membuka panel Detail untuk agen tersebut. Anda juga dapat mengklik Tambahkan subagen (+) untuk menambahkan subagen.

     2. Konfigurasi agen utama dan sub-agen Anda di panel Details:

        1. Nama: Tambahkan nama untuk membantu mengidentifikasi agen.

        2. Deskripsi: Ringkasan tujuan agen Anda.

        3. Petunjuk: Tambahkan petunjuk untuk memandu agen Anda.

        4. Model: Pilih model untuk mendukung agen Anda.

        5. Alat: Klik Tambahkan alat (+) untuk menambahkan alat yang memungkinkan agen menyelesaikan tugas. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan dan menambahkan alat.

   • Pratinjau: Uji kemampuan dan respons agen saat Anda membangun agen. Mulai chat dengan agen Anda untuk menguji kemampuannya.

4. Klik Dapatkan kode untuk melihat kode agen Anda. Jika ingin melanjutkan pengembangan agen di tempat lain, Anda dapat menyalin kode dan menempelkannya ke editor kode pilihan Anda. Lihat tutorial ADK untuk mengetahui opsi lainnya guna melanjutkan pengembangan agen Anda.

Setelah agen Anda selesai, Anda dapat men-deploy-nya langsung dari Agent Studio. Untuk mengetahui informasi selengkapnya, lihat Men-deploy Agen dari Agent Studio.

Menyiapkan dan menambahkan alat di Agent Studio

Anda dapat mengonfigurasi alat berikut untuk agen Anda:

• Google Penelusuran: Memungkinkan agen melakukan penelusuran web menggunakan Google Penelusuran. Diaktifkan secara default.

• Konteks URL: Izinkan model menganalisis URL dari perintah yang dikirim ke agen. Diaktifkan secara default.

• Penyimpanan Data Penelusuran Agent Platform: Klik Tambahkan (+) agar agen Anda dapat mengakses informasi yang telah diindeks di penyimpanan data Agent Search Anda.

  • Nomor Project: Nomor project yang terkait dengan penyimpanan data Agent Search Anda. Google Cloud Lihat nomor project Anda.

  • Lokasi: Lokasi penyimpanan data Anda.

  • ID Penyimpanan Data: ID data Firestore dalam mode Datastore (Datastore) yang akan disertakan. Melihat daftar penyimpanan data dan ID Anda.

  • ID Kumpulan: ID Kumpulan data yang akan disertakan. Lihat daftar penyimpanan data dan ID kumpulan Anda. Jika penyimpanan data Anda tidak memiliki ID Kumpulan, masukkan default_collection.

  Jika Anda belum memiliki penyimpanan data, lihat Mulai menggunakan penelusuran kustom untuk membuatnya. Kemudian, beri akses akun layanan ke Agent Platform Search:

  1. Di konsol Google Cloud , buka halaman IAM.
     

     Buka Identity and Access Management (IAM)

  2. Klik Grant access.

  3. Di kolom New principals, masukkan informasi akun layanan berikut: [e-mail].

  4. Pilih + Tambahkan peran. Telusuri dan pilih Pengguna Discovery Engine. Klik Terapkan, lalu Simpan.

• Server MCP: Klik Tambahkan (+) untuk menambahkan alat MCP dengan menghubungkan ke server MCP.

  1. Nama tampilan MCP: Masukkan nama untuk server MCP Anda.

  2. URL Endpoint: Masukkan URL endpoint untuk server MCP.

  3. Autentikasi: Diisi otomatis sebagai Tidak ada. Agent Studio hanya mendukung server MCP yang tidak memerlukan autentikasi.

  Agen Anda dapat menggunakan semua alat di server MCP yang terhubung.

Men-deploy Agen dari Agent Studio

Setelah membuat dan melihat pratinjau agen, Anda dapat men-deploy-nya ke produksi. Gunakan langkah-langkah berikut untuk men-deploy agen dari Agent Studio:

1. Dari halaman daftar Agen, klik agen yang ingin Anda deploy. Halaman detail Agen akan muncul untuk agen yang dipilih.

2. Klik Deploy untuk membuka dialog Deploy ke instance Agent Runtime.

3. (Opsional) Edit Nama tampilan atau Deskripsi untuk agen Anda.

4. Pilih region deployment dari daftar region yang tersedia, lalu klik OKE.

5. Klik Deploy.

Deployment membuat instance runtime baru dan dapat memerlukan waktu hingga lima menit untuk selesai. Jika berhasil, pesan akan muncul di tab Flow pada kanvas Agent Studio. Agen Anda kini tersedia dalam produksi dan dapat berintegrasi secara aman dengan aplikasi eksternal Anda.

Melihat agen yang di-deploy

Untuk melihat agen yang di-deploy:

1. Di konsol Google Cloud , buka halaman Agent Platform
   .

   Buka Agent Platform

2. Gunakan daftar Region untuk memfilter menurut region deployment.

3. Agen yang di-deploy yang merupakan bagian dari project yang dipilih akan muncul dalam daftar.

4. Klik nama agen yang ditentukan. Halaman Metrics untuk agen akan terbuka.

Untuk mengetahui informasi selengkapnya tentang metrik yang tersedia untuk agen Anda, lihat Melihat metrik untuk agen yang di-deploy.