Merancang agen di Agent Studio

Pratinjau

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

Hubungan dengan Ketentuan Lainnya. Fitur agen desain di Agent Studio membantu Pelanggan mendesain "Agen AI" sebagaimana didefinisikan dalam Ketentuan Khusus Layanan dan dengan demikian Ketentuan Khusus Layanan "Layanan AI Agentic" berlaku. Saat menggunakan Google Penelusuran sebagai alat di Agent Studio, bagian berjudul "Grounding with Google Search" dalam Ketentuan Khusus Layanan juga berlaku, kecuali bahwa referensi pertama ke 'Gemini Enterprise atau Agentspace' di subbagian (iv) dari bagian "Layanan AI Agentic" diganti dengan 'Gemini Enterprise Agent Platform'. Pastikan Anda meninjau ketentuan 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 Google Cloud konsol.

Agent Studio adalah visual designer low-code dalam Google Cloud konsol 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 tentang 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, siapkan Google Cloud.

Mendapatkan peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menggunakan Agent Studio, minta administrator Anda untuk memberi Anda peran IAM Pengguna Platform Agen (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.

Membuat 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 Google Cloud konsol, buka halaman Agen.
   

   Buka Agen

2. Klik Create agent untuk membuka kanvas Agent Studio untuk agen baru.

3. Desain dan simpan agen Anda di kanvas Agent Studio. Anda dapat beralih di antara tab berikut:

   • Flow: Buat agen utama dan subagen menggunakan representasi visual alur kerja dan logika kontrol agen Anda.

     1. Klik agen untuk membuka panel Details untuk agen tersebut. Anda juga dapat mengklik Add a subagent (+) untuk menambahkan subagen.

     2. Konfigurasi agen utama dan subagen Anda di panel Details:

        1. Name: Tambahkan nama untuk membantu mengidentifikasi agen.

        2. Description: Ringkasan tujuan agen Anda.

        3. Instructions: Tambahkan petunjuk untuk memandu agen Anda.

        4. Model: Pilih model untuk mendukung agen Anda.

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

     3. Untuk menyimpan agen Anda, klik Save di header kanvas dan ikuti perintahnya. Untuk mengetahui detailnya, lihat Menyimpan agen.

   • Tab pratinjau: Chat dengan agen Anda di panel pratinjau untuk menguji kemampuan dan responsnya.

4. Klik Get code untuk melihat kode agen Anda. Jika ingin melanjutkan pengembangan agen di tempat lain, Anda dapat menyalin kode dan menempelkannya ke editor kode pilihan Anda.

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

Menyimpan agen

Anda harus menyimpan agen sebelum dapat melihat pratinjau atau men-deploy-nya, karena agen yang belum disimpan belum memiliki identitas. Untuk menyimpan agen untuk pertama kalinya:

1. Di kanvas Agent Studio, klik Save.

2. Dalam dialog Save Agent, masukkan Agent name.

3. Klik Save.

Setelah penyimpanan pertama, Agent Studio akan otomatis menyimpan perubahan lebih lanjut yang Anda buat. Jika Anda mencoba keluar dari kanvas sebelum menyimpan agen baru, Agent Studio akan meminta Anda untuk menyimpannya terlebih dahulu.

Menyiapkan dan menambahkan alat di Agent Studio

Anda dapat mengonfigurasi alat berikut untuk agen Anda:

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

• URL context: Memungkinkan model menganalisis URL dari perintah yang dikirim ke agen. Diaktifkan secara default.

• Agent Platform Search Data Store: Klik Add (+) untuk mengizinkan agen Anda 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: Lokasipenyimpanan data Anda.

  • Data Store ID: ID Firestore dalam mode Datastore (Datastore) dari data yang akan disertakan. Lihat daftar penyimpanan data dan ID Anda.

  • Collection ID: ID Koleksi data yang akan disertakan. Lihat daftar penyimpanan data dan ID koleksi Anda. Jika penyimpanan data Anda tidak memiliki ID Koleksi, masukkan default_collection.

  Jika Anda tidak memiliki penyimpanan data yang ada, lihat Memulai penelusuran kustom untuk membuatnya. Kemudian, berikan akses akun layanan ke Agent Platform Search:

  1. Di Google Cloud konsol, 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 + Add roles. Telusuri dan pilih Discovery Engine User. Klik Apply , lalu Save.

• MCP Server: Hubungkan server Model Context Protocol (MCP) secara langsung.

  1. Untuk menambahkan alat MCP dengan menghubungkan ke server MCP, klik Add (+) di samping MCP Server.
  2. MCP display name: Masukkan nama untuk server MCP Anda.
  3. Endpoint URL: Masukkan URL endpoint untuk server MCP.
  4. Authentication: Diisi otomatis sebagai None. 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 Agents, klik agen yang ingin Anda deploy. Halaman detail Agen akan muncul untuk agen yang dipilih.
2. Klik Deploy untuk membuka dialog Deploy to an Agent Runtime instance.

3. (Opsional) Edit Display name atau Description untuk agen Anda.

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

5. Klik Deploy.

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

Melihat agen yang di-deploy

Untuk melihat agen yang di-deploy:

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

   Buka Platform Agen

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.

5. Pilih tab Playground untuk menguji agen Anda.

6. Masukkan kueri pengujian di panel chat untuk memverifikasi bahwa agen berjalan dengan sukses.

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