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

スキルのリビジョンを管理する

Agent Registry のスキルリビジョンを使用すると、アクティブなエージェントを中断することなく、スタンドアロンスキルを不変のスナップショットとしてバージョン管理できます。各スキルにはデフォルトのリビジョンがあり、複数のバージョンのスキルリビジョンを含めることができます。スキルの指示またはオプションのスクリプトを更新すると、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 のロールと権限をご覧ください。

スキルリビジョンを作成する

新しいリビジョンを作成すると、新しい ZIP ペイロードが既存のスキルコンテナにアップロードされます。検証が成功すると、リビジョンはアクティブ状態になります。新しいリビジョンをスキルのデフォルトリビジョンとして提供するには、新しいアクティブなリビジョンを指すようにスキルのデフォルトリビジョンを更新します。ダウンロードできるのは、アクティブ状態のリビジョンのみです。

スキルの料金と機能の費用については、Agent Registry の料金をご覧ください。

スキルリビジョンの ZIP ファイルの最大サイズは 500 KB です。

コンソール

Google Cloud コンソールで、[Agent Registry] ページに移動します。
Agent Registry に移動
[スキル] タブを選択し、スキルの名前をクリックします。
[スキルの詳細] ページで、[変更履歴] テーブルを見つけます。
[ バージョンを追加] をクリックします。
[バージョンを追加] パネルで、次のいずれかのオプションを選択します。
- ファイル: SKILL.md 手順ファイルとオプションのスクリプトを含むパッケージまたは ZIP ファイルをアップロードします。[参照] をクリックして、ローカル環境でファイルを見つけることができます。
- バケット: 有効な ZIP バンドルを含む gs://... Cloud Storage URI を指定します。[参照] をクリックして、Cloud Storage バケット内のファイルを見つけることができます。
  
  重要: Agent Registry がスキルファイルにアクセスできるようにするには、Cloud Storage バケット内の ZIP アーカイブへのアクセス権をサービスエージェントに付与する必要があります。Agent Registry サービスエージェントは、service-PROJECT_NUMBER@gcp-sa-agentregistry.iam.gserviceaccount.com の形式を使用します。このサービスエージェントがプロジェクトに存在しない場合は、Agent Registry API 用に作成します。手順については、ロールを作成してサービスエージェントに付与するをご覧ください。サービスエージェントには、ZIP アーカイブを含む Cloud Storage バケットに対する storage.objects.get 権限が必要です。バケットリソースに Identity and Access Management（IAM）権限を付与する手順については、Cloud Storage の IAM をご覧ください。
[作成] をクリックします。

[スキルの詳細] ページの [バージョン履歴] テーブルに、スキルのリビジョンが表示されます。

gcloud

スキルリビジョンを作成するには、ローカル ZIP ファイルをアップロードするか、Cloud Storage に保存されているパッケージをインポートします。

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

REVISION_ID: スキルリビジョンに割り当てる ID。
SKILL_ID: リビジョンに使用しているスキルの ID。手動で登録されたスキルの場合は、private- 接頭辞（private-my-skill など）を含めます。
PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。
ローカル ZIP ファイルをアップロードする: ローカル ZIP ペイロードを使用してスキルリビジョンを作成するには、gcloud alpha agent-registry skills revisions create コマンドを実行します。
```
gcloud alpha agent-registry skills revisions create REVISION_ID \
    --skill=SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --payload="LOCAL_ZIP_PATH"
```
LOCAL_ZIP_PATH は、ローカルマシン上のパッケージ化されたスキルアーカイブのパスに置き換えます。
Cloud Storage バケットからインポートする: Cloud Storage バケットでホストされている ZIP アーカイブを使用してスキルリビジョンを作成するには、gcloud alpha agent-registry skills revisions create コマンドを実行します。
```
gcloud alpha agent-registry skills revisions create REVISION_ID \
    --skill=SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --gcs-source-uri="gs://BUCKET_NAME/SKILL_PACKAGE.zip"
```
重要: Agent Registry がスキルファイルにアクセスできるようにするには、Cloud Storage バケット内の ZIP アーカイブへのアクセス権をサービスエージェントに付与する必要があります。Agent Registry サービスエージェントは、service-PROJECT_NUMBER@gcp-sa-agentregistry.iam.gserviceaccount.com の形式を使用します。このサービスエージェントがプロジェクトに存在しない場合は、Agent Registry API 用に作成します。手順については、ロールを作成してサービスエージェントに付与するをご覧ください。サービスエージェントには、ZIP アーカイブを含む Cloud Storage バケットに対する storage.objects.get 権限が必要です。バケットリソースに IAM 権限を付与する手順については、Cloud Storage の IAM をご覧ください。
次のように置き換えます。
- BUCKET_NAME: ZIP バンドルを含む Cloud Storage バケット名。
- SKILL_PACKAGE: スキルリビジョンを含むスキルパッケージの名前。

REST

スキルリビジョンを作成するには、revisions コレクションに POST リクエストを送信します。ZIP ペイロードを直接アップロードするか、Cloud Storage パスを指定できます。

ローカル ZIP ファイルをアップロードする: リクエスト本文に、base64 でエンコードされた ZIP バイトを含む archiveUploadSource を指定します。curl でインライン base64 コマンドを使用できます。

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "archiveUploadSource": {
          "archiveContent": "'"$(base64 -w0 local_skill.zip)"'"
        }
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions?skillRevisionId=REVISION_ID"

Cloud Storage バケットからインポートする: リクエスト本文で、バケットパスを指す gcsSource を指定します。

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "gcsSource": {
          "uri": "gs://BUCKET_NAME/SKILL_PACKAGE.zip"
        }
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions?skillRevisionId=REVISION_ID"

重要: Agent Registry がスキルファイルにアクセスできるようにするには、Cloud Storage バケット内の ZIP アーカイブへのアクセス権をサービスエージェントに付与する必要があります。Agent Registry サービスエージェントは、service-PROJECT_NUMBER@gcp-sa-agentregistry.iam.gserviceaccount.com の形式を使用します。このサービスエージェントがプロジェクトに存在しない場合は、Agent Registry API 用に作成します。手順については、ロールを作成してサービスエージェントに付与するをご覧ください。サービスエージェントには、ZIP アーカイブを含む Cloud Storage バケットに対する storage.objects.get 権限が必要です。バケットリソースに IAM 権限を付与する手順については、Cloud Storage の IAM をご覧ください。

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

PROJECT_ID: プロジェクト ID。
LOCATION: レジストリのロケーション。
SKILL_ID: スキルコンテナの ID。手動で登録されたスキルの場合は、private-my-skill などの private- 接頭辞を含めます。
REVISION_ID: このリビジョンに割り当てる ID。
BUCKET_NAME: ZIP を含む Cloud Storage バケット名。
SKILL_PACKAGE: ZIP パッケージの名前。

リビジョンの一覧表示と説明

スキルのすべてのリビジョンのリストを表示し、メタデータを検査できます。スキルのデフォルトリビジョンを更新する場合は、スキルのメタデータまたはデフォルトリビジョンを更新するをご覧ください。

リビジョンを一覧表示して詳細を確認する手順は次のとおりです。

コンソール

Google Cloud コンソールで、[Agent Registry] ページに移動します。
Agent Registry に移動
[スキル] タブを選択し、スキルの名前をクリックします。
[スキルの詳細] ページで、[変更履歴] テーブルを見つけます。
バージョン ID、作成日時、リビジョンの状態、使用可能なアクションを確認します。

gcloud

スキルのすべてのリビジョンを一覧表示するには、gcloud alpha agent-registry skills revisions list コマンドを実行します。

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

特定のリビジョンのメタデータを記述するには、gcloud alpha agent-registry skills revisions describe コマンドを実行します。

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

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

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

REST

リビジョンを一覧表示するには:

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

単一のリビジョンのメタデータを取得するには:

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

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

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

リビジョンペイロードをダウンロードする

特定のバージョンの ZIP ファイルペイロードをダウンロードして、ローカルで検証またはデバッグできます。

ペイロードをダウンロードするには、次の両方の条件を満たす必要があります。

スキル: スキルは、有効または非推奨の状態である必要があります。スキルのターゲット状態を変更するには、スキルのライフサイクル状態を管理するをご覧ください。
スキルリビジョン: リビジョンは有効状態である必要があります。失敗または作成中の状態のリビジョンはダウンロードできません。スキルリビジョンの状態を確認するには、リビジョンを一覧表示して説明します。

アクティブなリビジョンのリビジョンペイロードをダウンロードする手順は次のとおりです。

コンソール

Google Cloud コンソールで、[Agent Registry] ページに移動します。
Agent Registry に移動
[スキル] タブを選択し、スキルの名前をクリックします。
[スキルの詳細] ページで、[変更履歴] テーブルを見つけます。
ダウンロードするリビジョンを見つけます。
[アクション] 列で [ダウンロード] をクリックします。ZIP ペイロードがローカルマシンにダウンロードされます。

gcloud

リビジョンのアーカイブペイロードをダウンロードするには、gcloud alpha agent-registry skills revisions download コマンドを実行して、宛先パスを指定します。

gcloud alpha agent-registry skills revisions download REVISION_ID \
    --skill=SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --destination="./skill_payload.zip"

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

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

REST

クエリパラメータ alt=media を追加して、リビジョンのリソース URL に GET リクエストを送信します。HTTP リダイレクトストリームをフォローするには、curl とともに -L フラグを使用する必要があります。

curl -L -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -o skill_payload.zip \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID?alt=media"

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

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

特定のリビジョンを削除する

特定のリビジョンを削除すると、その ZIP ペイロードとメタデータの履歴が Agent Registry から削除されます。

個々のリビジョンの削除は、通常、管理者に制限されています。スキルのデフォルトリビジョンとして設定されているリビジョンを削除すると、Agent Registry は defaultRevision ポインタをクリアし、アクティブなスキルを無効状態に移行します。スキルを有効なままにするには、以前のデフォルトリビジョンを削除する前に、スキルのデフォルトリビジョンを更新して、別のアクティブなリビジョンを指すようにします。

特定のリビジョンを削除する手順は次のとおりです。

コンソール

Google Cloud コンソールで、[Agent Registry] ページに移動します。
Agent Registry に移動
[スキル] タブを選択し、スキルの名前をクリックします。
[スキルの詳細] ページで、[変更履歴] テーブルを見つけます。
削除するリビジョンを見つけます。
[アクション] 列で [削除] をクリックし、操作を確定します。

gcloud

リビジョンを削除するには、gcloud alpha agent-registry skills revisions delete コマンドを実行します。

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

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

REVISION_ID: 削除するスキルリビジョンの ID。
SKILL_ID: スキルコンテナの ID。手動で登録されたスキルの場合は、private-my-skill などの private- 接頭辞を含めます。
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/revisions/REVISION_ID"

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

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

次のステップ

詳しくは、確認済みのパブリッシャーを検索する方法をご覧ください。
スキルリビジョンの割り当てと上限について理解する。

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

始める前に

必要なロール

スキル リビジョンを作成する

コンソール

gcloud

REST

リビジョンの一覧表示と説明

コンソール

gcloud

REST

リビジョン ペイロードをダウンロードする

コンソール

gcloud

REST

特定のリビジョンを削除する

コンソール

gcloud

REST

次のステップ

スキルのリビジョンを管理する

スキルリビジョンを作成する

リビジョンペイロードをダウンロードする