手動登録を使用する

Google Cloud の外部でホストされているエージェントや、サポートされていないランタイムで実行されているエージェントの場合は、エージェント レジストリに手動で登録する必要があります。このドキュメントでは、エージェント レジストリにエージェントを手動で登録する方法について説明します。

始める前に

開始する前に、エージェント レジストリを設定します。これらのタスクを実行するには、プロジェクト ID が必要です。

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

必要なロール

エージェント レジストリにエージェントを手動で登録するために必要な権限を取得するには、プロジェクトに対する Agent Registry API 編集者 （roles/agentregistry.editor）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

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

A2A 準拠のエージェントを登録する

リモート エージェントが Agent2Agent（A2A）仕様を実装している場合は、エージェントの agent-card.json ペイロードにエージェント レジストリを転送します。レジストリは、エージェント カードを自動的に同期し、検出用にエージェントの利用可能なスキルをインデックスに登録します。

エージェントを登録する手順は次のとおりです。

コンソール

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

    Agent Registry に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

  3. [エージェント] タブを選択します。

  4. [エージェントを追加] をクリックします。

  5. [エージェントの詳細] パネルで、次の詳細を入力します。

    • タイプ: [A2A] を選択します。
    • リージョン: エージェントを登録する地理的位置を選択します。

  6. 次のいずれかのオプションを選択します。

    • リソース URI を使用してエージェントを登録するには、[URI から] タブを選択し、[URI] フィールドに有効な URL を入力します。次に、[インポート] をクリックして、URL からエージェント カードを取得します。
    • エージェント カードのコンテンツをコピーして貼り付けるには、[JSON を貼り付け] タブを選択し、agent-card.json ファイルの内容全体を貼り付けます。

  7. [保存] をクリックします。

gcloud

A2A エージェントを登録するには、エージェントのエージェント カードをローカル JSON ファイル（agent-card.json など）として保存し、次の操作を行います。

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=a2a-agent-card \
  --agent-spec-content=agent-card.json

仕様ファイルの最大ファイルサイズは 10 KB です。

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

  • AGENT_NAME: エージェントに付ける名前（例: my-support-agent）。
  • PROJECT_ID: プロジェクト ID。
  • REGION: エージェントを登録するリージョン。特定のリージョンを使用しない場合は、値 global を使用します。
  • DISPLAY_NAME: エージェントに付ける人間が読める名前（Support Agent など）。

標準 REST エージェントを登録する

標準の REST エージェントは名前と説明で検出できますが、A2A プロトコルを採用しない限り、検索可能なスキルはありません。

標準の REST エンドポイントや SaaS API エンドポイントなど、A2A 仕様を実装していないリモート エージェントを登録する場合は、Agent Registry API によって、エージェント プロトコル仕様のない Service リソースが作成されます。

エージェントを登録する手順は次のとおりです。

コンソール

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

    Agent Registry に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

  3. [エージェント] タブを選択します。

  4. [エージェントを追加] をクリックします。

  5. [エージェントの詳細] パネルで、次の詳細を入力します。

    • Type: [Non-A2A] を選択します。
    • 名前: エージェントの人間が読める表示名（Travel Agent など）を入力します。
    • 説明: エージェントの機能の説明を入力します（A test agent that plans travel itineraries. など）。
    • リージョン: エージェントを登録する地理的位置を選択します。
    • エンドポイント: エージェントがホストされているエンドポイントを入力します。

  6. [保存] をクリックします。

gcloud

必要に応じて、定義された HTTP/JSON エンドポイント インターフェースを --interfaces フラグで指定して、レジストリがエージェントとの接続を確立するようにできます。

標準の REST エージェントを登録する手順は次のとおりです。

gcloud alpha agent-registry services create AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --agent-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

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

  • AGENT_NAME: エージェントに付ける名前（例: my-remote-rest-agent）。
  • PROJECT_ID: プロジェクト ID。
  • REGION: レジストリ リージョン。
  • DISPLAY_NAME: エージェントに付ける人間が読める名前（Remote REST Agent など）。
  • ENDPOINT_URL: エージェントの API エンドポイント URL（例: https://api.remote-service.com/v1/agents/1234）。
  • PROTOCOL: エンドポイントのプロトコル バインディング。有効な値は HTTP_JSON、GRPC、JSONRPC です。

登録を確認する

エージェントを登録したら、Agent Registry が Service を正常に処理し、対応する Agent リソースを作成したことを確認します。

コンソール

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

    Agent Registry に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

  3. [エージェント] タブを選択します。

    このページには、登録されているすべてのエージェントとその詳細のリストが表示されます。

gcloud

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION

複数のエージェントがある場合や、単一のエージェントの登録を確認する場合は、エージェントのメタデータでリストをフィルタできます。

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

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

  • PROJECT_ID: プロジェクト ID。
  • REGION: エージェントを登録するリージョン。特定のリージョンを使用しない場合は、値 global を使用します。
  • FILTER_EXPRESSION: フィルタするエージェントのフィルタ式。たとえば、表示名でフィルタリングするには、displayName='DISPLAY_NAME' を使用します。グローバルに一意の識別子（URN）でフィルタするには、agentId='urn:agent:AGENT_URN' を使用します。

次のステップ

  • 登録代理人を管理する方法を確認する。
  • マネージド ランタイムにデプロイされたエージェントを登録する場合に推奨される方法である自動登録について学習する。