Menelusuri agen dan alat

Seiring berkembangnya ekosistem agen Anda, menemukan agen atau alat yang tepat menjadi sangat penting. Agent Registry menyediakan kemampuan penelusuran untuk memungkinkan Anda melakukan penelusuran kata kunci dan awalan lanjutan di seluruh agen dan server Model Context Protocol (MCP).

Dokumen ini menjelaskan cara membuat kueri penelusuran untuk menemukan kemampuan dalam lingkungan Anda.

Sebelum memulai

Sebelum Anda menelusuri agen atau alat di Registry Agen, daftarkan agen atau server MCP. 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 menelusuri agen dan alat 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.

Anda dapat melakukan penelusuran kata kunci untuk menemukan resource yang cocok dengan istilah tertentu di seluruh kemampuannya, seperti keterampilan agen atau alat server MCP. Untuk memahami cara kemampuan ini disusun dalam registry, lihat Skema JSON. Untuk mengetahui daftar lengkap kolom yang dapat ditelusuri, lihat referensi API.

Untuk menelusuri berdasarkan kata kunci, berikan tanda --search-string. Parameter ini menerima kueri teks bebas dan mendukung operator logis: AND, OR, dan NOT.

Misalnya, telusuri agen yang dapat menangani pemesanan penerbangan:

gcloud alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="flight OR booking"

Anda juga dapat menelusuri server MCP berdasarkan alat tertentu yang ditawarkannya atau deskripsinya. Misalnya, cari server MCP yang menyediakan alat database:

gcloud alpha agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="database"

Ganti kode berikut:

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

Penelusuran awalan sangat dioptimalkan untuk latensi, sehingga aplikasi Anda dapat mengambil agen dan alat yang relevan secara dinamis saat pengguna mengetik.

Jika Anda membuat antarmuka orkestrator atau fitur pelengkapan otomatis, Anda dapat melakukan penelusuran awalan di Agent Registry untuk mendapatkan hasil yang cocok dengan awal string kueri. Penelusuran awalan menggunakan simbol karakter pengganti akhiran (*) untuk mencocokkan awal kata.

Misalnya, telusuri agen yang nama tampilannya dimulai dengan awalan tertentu, seperti Best_A2A_*:

gcloud alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Best_A2A_*"

Demikian pula, Anda dapat menelusuri server MCP yang nama tampilannya diawali dengan awalan tertentu, seperti Prod_Server_*:

gcloud alpha agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Prod_Server_*"

Ganti kode berikut:

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