手動登録を使用する

でホストされていないエージェントの場合は、Agent Registry で手動登録が必要です Google Cloud。このドキュメントでは、Agent Registry でエージェントを手動で登録する方法について説明します。

始める前に

始める前に、Agent Registry を設定します。これらのタスクを行うには、 プロジェクト ID が必要です。

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

必要なロール

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

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

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

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

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

コンソール

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

    Agent Registry に移動

  2. プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを 選択します。

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

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

  5. [エージェントの詳細] パネルで、表示名と説明を入力し、地理的リージョンを選択します。

  6. エージェント タイプとして [A2A] を選択します。

  7. [エージェント仕様] セクションで、[JSON を貼り付け] タブを選択し、agent-card.json ファイルの内容全体を貼り付けます。

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

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

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

  • AGENT_NAME: エージェントに付ける名前（my-support-agent など）。
  • PROJECT_ID: プロジェクト ID。
  • REGION: レジストリ リージョン。
  • DISPLAY_NAME: エージェントに付ける人間が読める名前（Support Agent など）。

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

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

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

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

コンソール

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

    Agent Registry に移動

  2. プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを 選択します。

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

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

  5. [エージェントの詳細] パネルで、表示名と説明を入力し、地理的リージョンを選択します。

  6. エージェント タイプとして、仕様がないことを示すオプション（[Non-A2A] など）を選択します。

  7. エージェントがホストされているエンドポイントを入力し、必要に応じてプロトコル バインディング（HTTP_JSON など）を選択します。

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

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: エージェント サービス エンドポイント URL（https://api.remote-service.com/v1/agents/1234 など）。
  • PROTOCOL: エンドポイントのプロトコル バインディング。 有効な値は HTTP_JSON、GRPC、JSONRPC です。

登録を確認する

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

コンソール

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

    Agent Registry に移動

  2. プロジェクト選択ツールから、Agent Registry を設定した 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: レジストリ リージョン。
  • FILTER_EXPRESSION: フィルタするエージェントのフィルタ式。たとえば、表示名でフィルタするには、 を使用できますdisplayName='DISPLAY_NAME'。グローバルに一意の識別子（URN）でフィルタするには、agentId='urn:agent:AGENT_URN' を使用します。