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

Agent Registry では、スキル リビジョンは、スキル パッケージの不変のバージョン付きスナップショットを表します。スキルのコードや手順を更新すると、新しいリビジョンが作成されます。この分離されたアーキテクチャにより、スキルのバージョン管理が可能になります。

このドキュメントでは、スキル リビジョンを作成して管理する方法について説明します。特定のスキルのデフォルト リビジョンを更新する方法については、スキル メタデータまたはデフォルト リビジョンを更新するをご覧ください。

始める前に

始める前に、Agent Registry を設定し、スタンドアロン スキルを登録します。これらのタスクを実行するには、プロジェクト ID が必要です。

このドキュメントの Google Cloud CLI コマンドを使用するには、gcloud CLI 環境を設定していることを確認してください。

必要なロール

エージェント レジストリでスキル リビジョンを管理するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

  • スキル リビジョンを一覧表示、表示、ダウンロードする: Agent Registry API 閲覧者 （roles/agentregistry.viewer）
  • スキル リビジョンの作成、更新、削除: Agent Registry User （roles/agentregistry.user）
  • スキル リビジョンやその他の Agent Registry リソースを管理する: Agent Registry API 編集者 （roles/agentregistry.editor）

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

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

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

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

新しいリビジョンを作成すると、新しい ZIP ペイロードが既存のスキルコンテナにアップロードされます。スキルのリビジョンを作成すると、そのリビジョンが自動的にスキルのアクティブ バージョンになります。ただし、スキルのデフォルト リビジョンはいつでも更新できます。ダウンロードできるのは、アクティブなリビジョンのみです。

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

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

コンソール

  1. Google Cloud コンソールで、[エージェント レジストリ] ページに移動します。

    Agent Registry に移動

  2. [スキル] タブを選択し、スキルの名前をクリックします。
  3. [スキル詳細] ページで、[変更履歴] テーブルを見つけます。
  4. [ バージョンを追加] をクリックします。

  5. [バージョンを追加] パネルで、次のいずれかのオプションを選択します。

    • ファイル: コードまたはプロンプト指示（SKILL.md）ファイルを含むパッケージまたは ZIP ファイルをアップロードします。[参照] をクリックして、ローカル環境でファイルを見つけることができます。

    • バケット: 有効な ZIP バンドルを含む Cloud Storage URI（gs://...）を指定します。[参照] をクリックして、Cloud Storage バケット内のファイルを見つけることができます。

  6. [作成] をクリックします。

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

gcloud

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

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

  • REVISION_ID: スキル リビジョンに割り当てる ID。
  • SKILL_ID: リビジョンに使用するスキルの ID。
  • PROJECT_ID: プロジェクト ID。

  • LOCATION: レジストリのロケーション。

  • ローカル ZIP ファイルをアップロードする: ローカル ZIP ペイロードを使用してスキル リビジョンを作成するには:

    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 REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --gcs-source-uri="gs://BUCKET_NAME/SKILL_PACKAGE.zip"

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

    • BUCKET_NAME: ZIP バンドルを含む Cloud Storage バケット名。
    • SKILL_PACKAGE: スキル リビジョンを含むスキル パッケージの名前。

REST

スキル リビジョンを作成するには、リビジョン コレクションに 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"

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

  • PROJECT_ID: プロジェクト ID。
  • LOCATION: レジストリのロケーション。
  • SKILL_ID: スキル コンテナの ID。
  • REVISION_ID: このリビジョンに割り当てる ID。
  • BUCKET_NAME: ZIP ファイルを含む Cloud Storage バケットの名前。
  • SKILL_PACKAGE: ZIP パッケージの名前。

リビジョンを一覧表示して説明を取得する

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

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

コンソール

  1. Google Cloud コンソールで、[エージェント レジストリ] ページに移動します。

    Agent Registry に移動

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

gcloud

スキルのすべてのリビジョンを一覧表示するには:

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

特定のリビジョンのメタデータを記述するには:

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

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"

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

ローカルでの検証やデバッグ用に、特定のリビジョンのコンパイル済み ZIP ファイル ペイロードをダウンロードできます。

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

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

コンソール

  1. Google Cloud コンソールで、[エージェント レジストリ] ページに移動します。

    Agent Registry に移動

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

gcloud

リビジョンのアーカイブ ペイロードをダウンロードするには、--alt=media フラグを指定して describe コマンドを実行し、出力をファイルにリダイレクトします。

gcloud alpha agent-registry skills revisions describe REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --flags="alt=media" > skill_payload.zip

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"

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

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

通常、個々のリビジョンの削除は管理者に制限されています。スキルのデフォルト リビジョンとして設定されているリビジョンは削除できません。スキルのデフォルト リビジョンを更新するには、スキルのメタデータまたはデフォルト リビジョンを更新するをご覧ください。

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

コンソール

  1. Google Cloud コンソールで、[エージェント レジストリ] ページに移動します。

    Agent Registry に移動

  2. [スキル] タブを選択し、スキルの名前をクリックします。
  3. [スキル詳細] ページで、[変更履歴] テーブルを見つけます。
  4. 削除するリビジョンを見つけます。
  5. [アクション] 列で [削除] をクリックし、操作を確定します。

gcloud

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

REST

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"

次のステップ