在代理程式註冊資料庫中,發布者可讓您驗證已註冊獨立技能的授權,防止發布者名稱遭到未經授權的使用。每位發布者都會為技能 ID 建立已驗證的網域或 ID 前置字元,例如 Google 代管技能的 cloud.google.com,或手動註冊技能的 private-。
Google 會控管發布商的建立、更新和刪除作業。您建立的技能會自動指派給預設的 private 發布者,並使用 private- 前置字元。您可以在代理儲存庫中列出及檢查發布者詳細資料,驗證已註冊技能的擁有權。
事前準備
- 設定 Agent Registry。
如果是單一專案設定,請取得已啟用 Agent Registry 的管理專案ID。如果您為多個專案設定了管理邊界,請使用管理專案的 ID 進行邊界範圍的探索和註冊,或指定成員專案 ID 進行單一專案作業。
如要使用本文件中的 Google Cloud CLI 指令,請設定 gcloud CLI 環境。
必要的角色
如要取得在 Agent Registry 中查看技能發布者詳細資料所需的權限,請要求管理員在已啟用 Agent Registry 的管理專案中,授予您 Agent Registry API 檢視者 (roles/agentregistry.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
其他 Agent Registry 角色也可能具備查看代理程式發布者詳細資料所需的權限。詳情請參閱「Agent Registry 角色和權限」。
發布商層級
發布商會依驗證層級分類:
- Google 代管 (
FIRST_PARTY):由 Google 管理的已驗證發布商,例如cloud.google.com和discoveryengine.googleapis.com。 - 私人 (
PRIVATE):預設的private發布者,會自動指派給您或其他使用者在專案中建立的技能。
列出發布商
您可以列出位置中設定的所有發布商:
控制台
- 前往 Google Cloud 控制台的「Agent Registry」頁面:
- 選取「技能」分頁標籤。頁面會顯示所有已註冊技能的清單。
- 在所有已註冊技能的「Publisher」(發布者) 欄中,您可以瀏覽與各項技能相關聯的所有可用已驗證發布者。
gcloud
如要列出某個位置的所有已驗證發布者,請執行 gcloud alpha agent-registry publishers list 指令:
gcloud alpha agent-registry publishers list \
--project=PROJECT_ID \
--location=LOCATION
更改下列內容:
PROJECT_ID:專案 ID。LOCATION:登錄檔位置。
REST
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers"
更改下列內容:
PROJECT_ID:專案 ID。LOCATION:登錄檔位置。
查看發布商詳細資料
您可以查看特定發布商的詳細資料:
控制台
- 前往 Google Cloud 控制台的「Agent Registry」頁面:
- 選取「技能」分頁標籤。
- 按一下技能名稱,開啟詳細資料頁面。
在「Skill details」(技能詳細資料) 部分,找出技能的技能 ID。
使用這個技能 ID 欄位,即可找出特定發布商的素材資源。舉例來說,Google 代管技能的格式為
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID。
gcloud
如要查看特定發布者的詳細資料,請執行 gcloud alpha agent-registry publishers describe 指令:
gcloud alpha agent-registry publishers describe PUBLISHER_ID \
--project=PROJECT_ID \
--location=LOCATION
更改下列內容:
PUBLISHER_ID:要查看的發布者 ID。PROJECT_ID:專案 ID。LOCATION:登錄檔位置。
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"
更改下列內容:
PROJECT_ID:專案 ID。LOCATION:登錄檔位置。PUBLISHER_ID:要查看的發布者 ID。
後續步驟
- 瞭解如何註冊獨立技能。