Menggunakan pendaftaran manual

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda memerlukan pendaftaran manual di Agent Registry untuk agen yang dihosting di luar Google Cloud. Dokumen ini menunjukkan cara mendaftarkan agen secara manual di Agent Registry.

Catatan: Pendaftaran manual tidak didukung di lokasi multi-region us dan eu. Anda harus mendaftarkan resource di wilayah yang didukung atau lokasi global. Untuk mengetahui informasi selengkapnya, lihat Lokasi Agent Registry.

Sebelum memulai

Sebelum memulai, siapkan Agent Registry. Anda memerlukan project ID 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 mendaftarkan agen secara manual di Agent Registry, minta administrator untuk memberi Anda peran IAM Agent Registry API Editor (roles/agentregistry.editor) 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.

Mendaftarkan agen yang kompatibel dengan A2A

Jika agen jarak jauh Anda menerapkan spesifikasi Agent2Agent (A2A), arahkan Agent Registry ke payload agent-card.json agen. Registry otomatis menyinkronkan Kartu Agen dan mengindeks keterampilan yang tersedia untuk penemuan agen.

Ikuti langkah-langkah berikut untuk mendaftarkan 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.

4. Klik Tambahkan agen.

5. Di panel Detail agen, masukkan nama tampilan, deskripsi, dan pilih wilayah geografis.

6. Untuk jenis agen, pilih A2A.

7. Di bagian spesifikasi agen, pilih tab Tempel JSON, lalu tempelkan seluruh konten file agent-card.json Anda.

8. Klik Simpan.

gcloud

Untuk mendaftarkan agen A2A, simpan Kartu Agen agen sebagai file JSON lokal, misalnya, agent-card.json, lalu lakukan hal berikut:

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=@agent-card.json

Catatan: Ukuran file spesifikasi agen yang Anda upload tidak boleh lebih dari 10 KB.

Ganti kode berikut:

• AGENT_NAME: Nama yang ingin Anda berikan untuk agen, misalnya, my-support-agent.
• PROJECT_ID: Project ID.
• REGION: Region registri.
• DISPLAY_NAME: Nama yang mudah dibaca yang ingin Anda berikan ke agen, misalnya, Support Agent.

Mendaftarkan agen REST standar

Agen REST standar dapat ditemukan berdasarkan nama dan deskripsi, tetapi tidak memiliki keterampilan yang dapat ditelusuri kecuali jika mereka mengadopsi protokol A2A.

Jika Anda ingin mendaftarkan agen jarak jauh yang tidak menerapkan spesifikasi A2A, seperti endpoint REST atau SaaS API standar, Agent Registry API akan membuat resource Service tanpa spesifikasi protokol agen.

Ikuti langkah-langkah berikut untuk mendaftarkan 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.

4. Klik Tambahkan agen.

5. Di panel Detail agen, masukkan nama tampilan, deskripsi, dan pilih wilayah geografis.

6. Untuk jenis agen, pilih opsi yang menunjukkan tidak ada spesifikasi, seperti Non-A2A.

7. Masukkan endpoint tempat agen dihosting dan pilih pengikatan protokol jika diperlukan, seperti HTTP_JSON.

8. Klik Simpan.

gcloud

Anda dapat secara opsional menyediakan antarmuka endpoint HTTP/JSON yang ditentukan dengan tanda --interfaces sehingga registry membuat koneksi dengan agen.

Untuk mendaftarkan agen REST standar, lakukan hal berikut:

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Ganti kode berikut:

• AGENT_NAME: Nama yang ingin Anda berikan untuk agen, misalnya, my-remote-rest-agent.
• PROJECT_ID: Project ID.
• REGION: Region registri.
• DISPLAY_NAME: Nama yang mudah dibaca yang ingin Anda berikan ke agen, misalnya, Remote REST Agent.
• ENDPOINT_URL: URL endpoint layanan agen, misalnya, https://api.remote-service.com/v1/agents/1234.
• PROTOCOL: Pengikatan protokol untuk endpoint. Nilai yang valid adalah HTTP_JSON, GRPC, atau JSONRPC.

Verifikasi pendaftaran

Setelah mendaftarkan agen, verifikasi bahwa Agent Registry berhasil memproses Service dan membuat resource Agent yang sesuai:

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 harus menampilkan daftar semua agen terdaftar dan detailnya.

gcloud

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

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

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'.