スキル パブリッシャーの詳細を確認する

エージェント レジストリでは、パブリッシャーが登録済みのスタンドアロン スキルの背後にある権限を確認できるようにすることで、パブリッシャー名の不正使用を防止できます。各パブリッシャーは、スキル識別子の確認済みドメインまたは ID プレフィックスを確立します。たとえば、Google が管理するスキルの場合は cloud.google.com、手動で登録されたスキルの場合は private- です。

パブリッシャーの作成、更新、削除は Google が管理します。作成したスキルは、private- 接頭辞を使用するデフォルトの private パブリッシャーに自動的に割り当てられます。Agent Registry でパブリッシャーの詳細を一覧表示して検査し、登録済みのスキルの所有権を確認できます。

始める前に

  1. Agent Registry を設定する。

  2. 単一プロジェクトの設定の場合は、Agent Registry が有効になっているガバナンス プロジェクトのプロジェクト ID を取得します。複数のプロジェクトに管理境界を構成した場合は、境界全体の検出と登録に管理プロジェクトの ID を使用するか、単一プロジェクトのオペレーションにメンバー プロジェクト ID を指定します。

  3. スタンドアロン スキルを登録する。

  4. このドキュメントの 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 パブリッシャー。

パブリッシャーを一覧表示する

ロケーションに構成されているすべてのパブリッシャーを一覧表示できます。

コンソール

  1. Google Cloud コンソールで、[Agent Registry] ページに移動します。

    [Agent Registry] に移動

  2. [スキル] タブを選択します。このページには、登録済みのスキルがすべて表示されます。
  3. 登録済みのすべてのスキルの [パブリッシャー] 列で、各スキルに関連付けた、利用可能なすべての検証済みパブリッシャーを確認できます。

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: レジストリのロケーション。

ニュース メディアの詳細を表示

特定のパブリッシャーの詳細を確認するには、次の操作を行います。

コンソール

  1. Google Cloud コンソールで、[Agent Registry] ページに移動します。

    [Agent Registry] に移動

  2. [スキル] タブを選択します。
  3. スキルの名前をクリックして、詳細ページを開きます。

  4. [Skill details] セクションで、スキルのスキル識別子を見つけます。

    このスキル識別子フィールドを使用して、特定のパブリッシャーのアセットを検索します。たとえば、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。

次のステップ