Di Agent Registry, publisher mewakili otoritas terverifikasi yang memublikasikan keterampilan agen. Penayang menentukan awalan yang dapat digunakan skill untuk mencegah perebutan nama dan menerapkan verifikasi identitas. Misalnya, awalan google- dicadangkan untuk skill Google terverifikasi.
Dokumen ini menjelaskan cara meninjau dan memeriksa detail penayang terverifikasi untuk skill terdaftar Anda.
Membuat, memperbarui, atau menghapus penayang, dan mengelola alokasi imbuhan terverifikasi, dibatasi untuk administrator internal Google. Keterampilan yang Anda atau pengguna lain buat akan otomatis ditetapkan ke penayang private
default, sehingga ID yang dipublikasikan dari keterampilan tertentu akan diawali dengan
private-. Anda tidak dapat mendaftarkan resource penerbit kustom.
Sebelum memulai
Sebelum memulai, siapkan Agent Registry dan daftarkan skill mandiri. Anda memerlukan project ID untuk melakukan tugas ini.
Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan gcloud CLI.
Peran yang diperlukan
Untuk mendapatkan izin yang
diperlukan guna meninjau detail penayang skill di Agent Registry,
minta administrator Anda untuk memberi Anda
peran IAM Agent Registry User (roles/agentregistry.user) di project tersebut.
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.
Tingkat penayang
Penayang dikategorikan ke dalam tingkat yang mencerminkan level verifikasi mereka:
- Pihak pertama (
FIRST_PARTY): Penerbit global terverifikasi yang diseleksi Google. Misalnya,publishers/cloud.google.comdanpublishers/discoveryengine.googleapis.com. - Pribadi (
PRIVATE): Penayangprivatedefault otomatis ditetapkan ke skill yang Anda atau pengguna lain buat dalam project.
Mencantumkan penayang
Anda dapat mencantumkan semua penayang yang dikonfigurasi di lokasi Anda:
Konsol
- Di konsol Google Cloud , buka halaman Agent Registry:
- Pilih tab Keterampilan. Halaman ini menampilkan daftar semua keterampilan terdaftar Anda.
- Di kolom Publisher dari semua skill terdaftar, Anda dapat menjelajahi semua publisher terverifikasi yang tersedia yang Anda kaitkan dengan setiap skill Anda.
gcloud
gcloud alpha agent-registry publishers list \
--project=PROJECT_ID \
--location=LOCATION
Ganti kode berikut:
PROJECT_ID: Project ID.LOCATION: Lokasi registri.
REST
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers"
Ganti kode berikut:
PROJECT_ID: Project ID.LOCATION: Lokasi registri.
Melihat detail penayang
Anda dapat memeriksa detail untuk penayang tertentu:
Konsol
- Di konsol Google Cloud , buka halaman Agent Registry:
- Pilih tab Keterampilan.
- Klik nama skill untuk membuka halaman detailnya.
Di bagian Detail skill, temukan Uniform Resource Name (URN) skill.
Gunakan kolom URN skill ini untuk menemukan aset penayang tertentu. Misalnya, format untuk skill buatan Google adalah
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID
gcloud
gcloud alpha agent-registry publishers describe PUBLISHER_ID \
--project=PROJECT_ID \
--location=LOCATION
Ganti kode berikut:
PUBLISHER_ID: ID penayang yang ingin Anda tinjau.PROJECT_ID: Project ID.LOCATION: Lokasi registri.
REST
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers/PUBLISHER_ID"
Ganti kode berikut:
PROJECT_ID: Project ID.LOCATION: Lokasi registri.PUBLISHER_ID: ID penayang yang ingin Anda tinjau.
Langkah berikutnya
- Pelajari cara mendaftarkan kemampuan mandiri.