Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

スキルを管理する

Agent Registry を使用すると、スタンドアロンスキルを検査、更新、管理して、エージェントが使用できるスキルバージョンとライフサイクル状態を制御できます。スタンドアロンスキルを登録すると、その詳細の表示、説明やデフォルトリビジョンの更新、ライフサイクル状態の移行、Agent Registry からの削除を行うことができます。Google が管理するスキルを一覧表示して確認することもできます。これらのスキルは、Agent Registry を設定するとすぐに使用できます。

始める前に

Agent Registry を設定する。
Agent Registry が有効になっているガバナンスプロジェクトのプロジェクト ID を取得します。
スタンドアロンスキルを登録する。
このドキュメントの Google Cloud CLI コマンドを使用するには、gcloud CLI 環境を設定します。

必要なロール

Agent Registry でスキルを管理するために必要な権限を取得するには、Agent Registry が有効になっているガバナンスプロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

スキルの一覧表示と表示: Agent Registry API 閲覧者（roles/agentregistry.viewer）
スキルの更新、ライフサイクル状態の移行、削除: Agent Registry ユーザー（roles/agentregistry.user）
スキルやその他の Agent Registry リソースを管理する: Agent Registry API 編集者（roles/agentregistry.editor）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

他の Agent Registry ロールには、スキルの表示、更新、削除に必要な権限が含まれている場合もあります。詳細については、Agent Registry のロールと権限をご覧ください。

スキルの一覧表示と確認

登録されているすべてのスキルを閲覧することも、特定の機能を検索することもできます。

コンソール

Google Cloud コンソールで、[Agent Registry] ページに移動します。
Agent Registry に移動
[スキル] タブを選択します。
スキルのリストを確認します。[ロケーション] メニューまたは [ステータス] メニューを使用して、表示をフィルタリングできます。
スキル名をクリックして [スキルの詳細] ページを開きます。このページには、名前、説明、アクティブバージョン、スキル識別子、最終更新日、カスタムメタデータ、変更履歴が表示されます。

gcloud

ロケーション内のすべてのスキルを一覧表示するには、gcloud alpha agent-registry skills list コマンドを使用します。

gcloud alpha agent-registry skills list \
    --project=PROJECT_ID \
    --location=LOCATION

特定のスキルの詳細を表示するには、gcloud alpha agent-registry skills describe コマンドを使用します。

gcloud alpha agent-registry skills describe SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

次のように置き換えます。

SKILL_ID: 確認するスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。
PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。

REST

すべてのスキルのリストを取得するには、GET リクエストを送信します。

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills"

1 つのスキルコンテナを取得するには、GET リクエストを送信します。

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"

次のように置き換えます。

PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。
SKILL_ID: 確認するスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。

スキルのメタデータまたはデフォルトのリビジョンを更新する

スキルの表示名や説明を変更したり、デフォルトのリビジョンポインタを手動で変更して別のバージョンをデプロイしたりできます。新しいスキルリビジョンを作成するには、スキルリビジョンを管理するをご覧ください。

スキルのメタデータまたは特定のスキルのデフォルトリビジョンを更新する手順は次のとおりです。

コンソール

Google Cloud コンソールで、[Agent Registry] ページに移動します。
Agent Registry に移動
[スキル] タブを選択します。
スキルのリストを確認します。[ロケーション] メニューまたは [ステータス] メニューを使用して、表示をフィルタリングできます。
スキル名をクリックして [スキルの詳細] ページを開きます。このページには、名前、説明、アクティブバージョン、スキル識別子、最終更新日、カスタムメタデータ、変更履歴が表示されます。
次のいずれかのオプションを選択します。
- スキルメタデータを更新する:
  1. [ 編集] をクリックします。
  2. [スキルを編集] パネルで、スキルの表示名または説明を更新します。
  3. [保存] をクリックします。
- デフォルトのリビジョンを更新する:
  1. [変更履歴] の表を見つけます。
  2. アクティブに設定するリビジョンを見つけます。
  3. [アクション] 列で [バージョンを有効にする] をクリックします。

gcloud

スキルのメタデータを更新するには、gcloud alpha agent-registry skills update コマンドを使用します。

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

スキルのデフォルトのサービングリビジョンを更新するには、gcloud alpha agent-registry skills update コマンドを使用し、ターゲットリビジョンのリソース名を指定します。

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --default-revision="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

次のように置き換えます。

SKILL_ID: 更新するスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。
PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。
DISPLAY_NAME: 更新された表示名。
DESCRIPTION: 更新された説明。
REVISION_ID: デフォルトとして設定するスキルリビジョンの ID。

REST

更新するフィールドを指定して PATCH リクエストを送信します。

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "displayName": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        "defaultRevision": "projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=displayName,description,defaultRevision"

次のように置き換えます。

DISPLAY_NAME: スキルの更新された表示名。
DESCRIPTION: スキルの更新された説明。
PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。
SKILL_ID: 更新するスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。
REVISION_ID: 有効にするスキルリビジョンの ID。

スキルライフサイクルの状態を管理する

実行時にスキルがどのように解決されるかを制御するには、スキルのターゲット状態を変更します。

有効: スキルが提供され、完全に解決可能です。スキルを有効に設定するには、defaultRevision フィールドが有効なスキルリビジョンを指している必要があります。
無効: スキルが作成されたときのデフォルトの初期状態。スキルは実行時に提供されず、スキルの解決はすぐに失敗し、ペイロードのダウンロードはブロックされます。defaultRevision ポインタがクリアされた場合、またはデフォルトのリビジョンが削除された場合も、スキルは無効状態になります。廃止状態とは異なり、有効な defaultRevision を設定してターゲット状態をアクティブに更新することで、無効なスキルを有効にできます。
非推奨: スキルは引き続き読み込み可能でダウンロード可能ですが、廃止されることを示します。
廃止: スキルは完全に無効化され、提供されなくなります。有効やその他の状態に戻すことはできません。スキルを廃止できるのは、すでに非推奨になっている場合のみです。スキルを廃止する前に、移行に十分な時間を確保してください。この状態はターミナルであるため、注意して使用してください。

スキルのライフサイクル状態を移行するには:

コンソール

Google Cloud コンソールで、[Agent Registry] ページに移動します。
Agent Registry に移動
[スキル] タブを選択します。
スキルのリストを確認します。[ロケーション] メニューまたは [ステータス] メニューを使用して、表示をフィルタリングできます。
スキル名をクリックして [スキルの詳細] ページを開きます。このページには、名前、説明、アクティブバージョン、スキル識別子、最終更新日、カスタムメタデータ、変更履歴が表示されます。
ステータスコントロールボタンを使用して、ターゲットの状態を移行します。ページに表示されるボタンは、スキルの現在の状態（[有効にする]、[無効にする]、[非推奨にする]、[廃止する] など）によって異なります。

gcloud

gcloud alpha agent-registry skills update コマンドと --target-state フラグを使用して、スキルコンテナを更新します。

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --target-state=DISABLED

次のように置き換えます。

SKILL_ID: 更新するスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。
PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。

ターゲット状態に指定できる値は次のとおりです。

ACTIVE
DISABLED
DEPRECATED
DECOMMISSIONED

REST

リクエストの本文と更新マスクに targetState を指定して、PATCH リクエストを送信します。

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "targetState": "TARGET_STATE_DISABLED"
    }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=targetState"

次のように置き換えます。

PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。
SKILL_ID: 更新するスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。

ターゲット状態に指定できる値は次のとおりです。

TARGET_STATE_ACTIVE
TARGET_STATE_DISABLED
TARGET_STATE_DEPRECATED
TARGET_STATE_DECOMMISSIONED

スキルを削除する

スキルコンテナを削除すると、Skill リソースと、関連付けられているすべての不変の SkillRevision リソースが完全に削除されます。削除されたスキル識別子を解決しようとするエージェントは、実行時に失敗します。

コンソール

Google Cloud コンソールで、[Agent Registry] ページに移動します。
Agent Registry に移動
[スキル] タブを選択します。
スキルのリストを確認します。[ロケーション] メニューまたは [ステータス] メニューを使用して、表示をフィルタリングできます。
削除するスキルの名前をクリックします。
[スキルの詳細] ページで、 [削除] をクリックします。
確認ダイアログで「DELETE」と入力し、[削除] をクリックします。

gcloud

スキルを削除するには、gcloud alpha agent-registry skills delete コマンドを使用します。

gcloud alpha agent-registry skills delete SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

次のように置き換えます。

SKILL_ID: 削除するスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。
PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。

REST

スキルを削除するには、DELETE リクエストを送信します。

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?force=true"

次のように置き換えます。

PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。
SKILL_ID: 削除するスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。

次のステップ

新しいリビジョンをアップロードしてパッケージをダウンロードする方法を確認する。
スキルを管理するためのロールと権限を理解する。

スキルを管理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

必要なロール

スキルの一覧表示と確認

コンソール

gcloud

REST

スキルのメタデータまたはデフォルトのリビジョンを更新する

コンソール

gcloud

REST

スキル ライフサイクルの状態を管理する

コンソール

gcloud

REST

スキルを削除する

コンソール

gcloud

REST

次のステップ

スキルを管理する

スキルライフサイクルの状態を管理する