Panduan memulai: Menemukan agen

Penemuan adalah mekanisme inti untuk mempercepat pengembangan dengan workload agentic. Dengan menelusuri dalam Agent Registry, Anda dapat menemukan agen yang sudah ada dengan keterampilan yang Anda butuhkan, seperti "Agen Kebijakan Perusahaan" atau "Agen Pemesanan Penerbangan" yang sudah ada, alih-alih membuat integrasi duplikat dari awal.

Panduan memulai ini menunjukkan cara menemukan agen yang terdaftar di Agent Registry.

Sebelum memulai

Sebelum memulai panduan memulai ini, daftarkan agen di Agent Registry. Anda juga memerlukan project ID Anda untuk melakukan tugas ini.

Untuk menggunakan perintah gcloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan Google Cloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menemukan agen di Agent Registry, minta administrator untuk memberi Anda peran IAM Agent Registry API Viewer (roles/agentregistry.viewer) di project. 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.

Mencantumkan agen yang tersedia

Melihat daftar lengkap semua agen yang terdaftar dan diindeks dalam registri:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Agen.

    Halaman ini menampilkan daftar semua agen terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

  4. Untuk melihat detail lengkap agen, klik nama agen.

gcloud

Untuk mencantumkan semua agen di lokasi tertentu, gunakan perintah agents list:

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION

Ganti kode berikut:

  • PROJECT_ID: Project ID.
  • REGION: Region registri.

Outputnya akan terlihat seperti contoh berikut:

- name: projects/1234567890/locations/us-central1/agents/my-travel-agent
  displayName: Travel Orchestrator Agent
  description: 'Decomposes natural language travel requests into sub-tasks.'
  version: 1.0.0
  protocols:
    - type: A2A_AGENT
      protocolVersion: "0.3"
      interfaces:
        - url: https://api.example.com/.well-known/agent-card.json
          protocolBinding: HTTP_JSON
  attributes:
    agentregistry.googleapis.com/system/Framework:
      framework: "google-adk"
    agentregistry.googleapis.com/system/RuntimeIdentity:
      identity: "principal://..."
  card:
    type: A2A_AGENT_CARD
    content: {...}

Kolom card berisi konten lengkap Kartu Agen A2A jika tersedia.

Memfilter agen terdaftar

Jika Anda memiliki beberapa agen, atau jika Anda ingin mengonfirmasi pendaftaran agen tertentu, Anda dapat memfilter daftar menurut metadata agen:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Agen.

    Halaman ini menampilkan daftar semua agen terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

  4. Memfilter daftar menurut lokasi agen atau resource runtime-nya:

    • Untuk memfilter menurut lokasi, klik menu Lokasi, pilih lokasi yang ingin Anda filter, lalu klik Terapkan.
    • Untuk memfilter menurut runtime, klik menu Runtime, pilih runtime yang ingin Anda filter, lalu klik Terapkan.

    Halaman ini menampilkan daftar agen terdaftar yang difilter untuk kondisi yang Anda pilih.

gcloud

Filter daftar agen Anda untuk hanya menampilkan resource yang cocok dengan pasangan nilai kunci tertentu, menggunakan tanda --filter:

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Ganti kode berikut:

  • PROJECT_ID: Project ID.
  • REGION: Region registri.
  • FILTER_EXPRESSION: Ekspresi filter untuk agen yang ingin Anda filter. Misalnya, untuk memfilter menurut nama tampilan, Anda dapat menggunakan displayName='DISPLAY_NAME'. Untuk memfilter menurut ID unik secara global (URN), Anda dapat menggunakan agentId='urn:agent:AGENT_URN'.

Melihat detail agen

Jika Anda telah mengidentifikasi agen yang ingin digunakan, Anda dapat mengambil metadata lengkapnya, termasuk endpoint runtime dan daftar lengkap kemampuannya:

Konsol

  1. Di konsol Google Cloud , buka Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

  3. Pilih tab Agen.

    Halaman ini menampilkan daftar semua agen terdaftar dan detailnya, seperti nama, ID, deskripsi, runtime, dan lokasi.

  4. Klik nama agen yang ingin Anda lihat.

    Halaman detail mencakup tab untuk detail agen.

  5. Klik tab yang sesuai untuk melihat detail agen tertentu.

    Ketersediaan fitur bergantung pada runtime Anda. Tab seperti Sesi, Playground, Memori, dan Evaluasi adalah kemampuan khusus yang ditampilkan untuk agen yang dibangun di runtime terkelola, seperti Vertex AI Agent Engine:

    • Ringkasan: Detail inti dari agen, termasuk nama, ID, lokasi, deskripsi, dan runtime agen. Ringkasan ini juga menampilkan keterampilan dan URI resource, yang Anda perlukan untuk membuat kueri dalam grafik topologi.
    • Kemampuan observasi: Insight yang berfokus pada aplikasi seperti latensi, traffic, error, dan pembelanjaan token. Tab ini terintegrasi dengan alat Google Cloud Observability untuk menampilkan metrik performa real-time dan pemanfaatan tingkat sistem guna membantu Anda mengelola biaya dan pengalaman pengguna. Untuk mengetahui informasi selengkapnya, lihat Ringkasan kemampuan pengamatan.
    • Tracer: Jalur persis percakapan langkah demi langkah, termasuk pemformatan mendetail pesan input dan asisten untuk men-debug loop penalaran multi-agen yang kompleks atau error pemanggilan alat secara real time. Untuk mengetahui informasi selengkapnya, lihat Melihat rekaman aktivitas agen.
    • Keamanan: Temuan dari Model Armor dan Security Command Center, termasuk pelanggaran kebijakan konten, risiko kebocoran data, dan penilaian kepatuhan. Untuk mengetahui informasi selengkapnya tentang keamanan, lihat Melihat temuan keamanan.
    • Topologi: Peta visual hubungan dan alur traffic antara agen, Agent Gateway yang ditetapkan untuknya, dan server MCP yang berinteraksi dengannya. Untuk mengetahui informasi selengkapnya tentang Agent Gateway, lihat Ringkasan Agent Gateway. Untuk mengetahui informasi selengkapnya tentang topologi, lihat Melihat grafik untuk agen terdaftar.
    • Identitas: Principal agen yang digunakan untuk penegakan kebijakan. Anda menggunakan identitas ini, misalnya, untuk mengonfigurasi binding penyedia auth untuk autentikasi ke alat dan resource.
    • Sesi: Histori percakapan persisten dan pelacakan interaksi aktif dengan agen.
    • Playground: Antarmuka chat langsung untuk menguji perilaku agen.
    • Memori: Fitur personalisasi jangka panjang yang membuat atau mengingat detail dari percakapan sebelumnya dengan agen untuk mempertahankan konteks di seluruh interaksi.
    • Evaluasi: Detail semua tugas evaluasi agen. Tab ini memungkinkan Anda membuat tugas evaluasi baru, mengupload metrik, dan mengevaluasi performa kognitif agen serta keandalan model terhadap traffic aktif atau simulasi sintetis.

gcloud

Untuk melihat metadata mendetail dari agen tertentu, gunakan perintah agents describe:

gcloud alpha agent-registry agents describe AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION

Ganti kode berikut:

  • AGENT_NAME: Nama agen Anda, misalnya, my-travel-agent.
  • PROJECT_ID: Project ID.
  • REGION: Region registri.

Dengan endpoint agen, definisi skill, dan metadata hanya output, seperti framework pokok, identitas runtime, dan payload Kartu Agen A2A lengkap, Anda dapat mengikat agen dengan aman ke alur kerja pengorkestrasi menggunakan Agent Development Kit (ADK) atau permintaan API standar.

Langkah berikutnya