基本的なコンセプト

このドキュメントでは、Agent Registry に関連する主な用語とコンセプトについて説明します。

エージェント

AI エコシステムの自律的なアクター。 識別子と、そのアクターが持つ特定の スキルによって定義されます。

エージェント識別子

エージェントのグローバルに一意の不変の名前。この論理識別子は、基盤となるインフラストラクチャの変更に関係なく、コンシューマーがエージェントを呼び出すための安定した参照を提供します。

エージェント識別子は、取り込み時に Agent Registry によって自動的に生成され、Uniform Resource Name（URN）形式に従います。正確な形式は、エージェントがデプロイされている場所によって異なります。次に例を示します。

  • Vertex AI Agent Engine: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID
  • Cloud Run サービス: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME
  • GKE の Deployment: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME
  • Gemini Enterprise: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root
  • Google Workspace: urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a
  • 手動で登録されたエージェント: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID

エージェント プリンシパル

エージェントに割り当てられた一意の IAM 識別子。これにより、エージェントは権限を保持し、監査を受けることができます。エージェントまたはサーバーにバインドされた、検証可能なサービス アカウントまたはマネージド Workload Identity（SPIFFE ID など）の形式になります。 Google Cloud

この ID はエージェントのランタイムのコンピューティング リソースに直接バインドされるため、プリンシパル文字列には、その基盤となるリソースへの正確なパスが組み込まれます。たとえば、Vertex AI Agent Engine デプロイのエージェント プリンシパルは次のようになります。

principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID

Agent Registry では、エージェントの詳細を 表示すると、この ID が出力専用属性として表示されます。

エージェント ワークフロー

AI エージェントがタスクを完了するために、ツールの使用、推論、実行パスを独自に決定する一連のステップ。

Auth provider（認証プロバイダ）

エージェントを特定の外部ツールやアプリケーションに接続し、認証タイプを定義するために、API キーや OAuth トークンなどの認証情報を保存、取得、管理する Agent Identity 認証マネージャー 内の構成。

バインディング

ソース エージェントとターゲット リソース（ 別のエージェント、MCP サーバー、エンドポイントなど）の間の接続。バインディングを作成することで、オーケストレータ エージェントがダウンストリーム機能とやり取りできる明示的な関係を確立できます。バインディングは、委任された権限をサポートするために、エージェントを認証プロバイダに関連付けるためにも 使用されます。

データリソース

エージェントがレスポンスの根拠にしたり、アクションを通知したりするためにアクセスできる、MCP サーバーによって公開される特定のデータ コンテキストまたはデータセット。

調査

説明、タグ、またはスキルに基づいて既存のエージェントまたは MCP ツールを検索するためにレジストリにクエリを実行するプロセス。スキルによる調査は、Agent2Agent（A2A）プロトコルを実装するエージェントなど、エージェント カードを通じて機能を公開するエージェントで使用できます。

エンドポイント

Agent Registry API の場合、エージェントがアクセスするターゲット URL（通常は REST API）を表すリソース。これらの宛先を管理可能なリソースに抽象化することで、Agent Registry では、エージェントがアクセスできる外部サービスを一元的に管理できます。

Model Context Protocol（MCP）

AI モデルをデータソースやツールに接続するために使用されるオープン スタンダード。カスタム プラグインに代わるものです。

MCP サーバー（またはサーバー）

Model Context Protocol（MCP）を実装して、標準化されたツールとデータリソースを AI エージェントに提供するサービス。

MCP サーバー識別子

MCP サーバーのグローバルに一意の不変の Uniform Resource Name（URN）。エージェント識別子と同様に、この 名前は特定のツールセットを検出するための安定した参照を提供します。

形式は、組み込みの Google サービスか、登録済みの外部サーバーかによって異なります。次に例を示します。

  • Google Cloud リモート MCP サーバー: urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME
  • 手動で登録された MCP サーバー: urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID

登録

エージェント コンポーネントをレジストリに追加するプロセス。Agent Registry には、次の登録メカニズムが用意されています。

リソースの URI

エージェントまたはMCP サーバーをホストする物理ランタイムの場所またはインフラストラクチャ。Uniform Resource Identifier（URI）は、このランタイム リソースを識別する一意の文字列です。たとえば、リソース URI は、Vertex AI エンドポイント、GKE Deployment、Cloud Run サービスなどです。

リソース URI は、エージェント識別子または MCP サーバー識別子とは異なります。これらの値は、レジストリ内のエージェントと MCP サーバーを識別する URN 形式の一意の名前です。 一方、リソース URI は、エージェントまたはサーバーが実行される実際のコンピューティング リソースを指します。

エージェントのリソース URI へのパスは、エージェント プリンシパル文字列に埋め込まれており、 IAM ポリシーでそのワークロードを一意に識別します。

Agent Registry では、エージェントの詳細を 表示すると、この URI が出力専用属性として表示されます。

リソース URI を使用して、トポロジ グラフでクエリを作成し、 特定のエージェントのトラフィック フローと関係を可視化できます。Agent Registry API では、この値は agentregistry.googleapis.com/system/RuntimeReference 属性で表されます。

サービス

Agent Registry API の場合、カスタム ワークロードまたは外部ワークロードをレジストリに手動で登録するために使用される書き込み可能なリソース。Service は、レジストリに手動で追加されたエージェント、MCP サーバー、またはエンドポイントを表します。Agent Registry が自動的に取り込まないワークロードのエンドポイントとメタデータを定義するには、Service リソースを作成して管理します。

指定した仕様に応じて、Agent Registry はこの Service を読み取り専用の Agent、McpServer、または Endpoint リソースとしてコンシューマー側に自動的に投影し、検出します。

レジストリ エントリの作成、編集、削除には、常に Service リソースを使用します。ただし、これらのエントリを取得、一覧表示、検索するには、読み取り専用の Agent、McpServer、または Endpoint リソースにクエリを実行します。

スキル

A2A エージェントが持つ高度な機能。スキルは A2A エージェント カードから抽出され、エージェントの検出の主要なデータポイントとして機能します。

ツール

エージェントが呼び出すことができる、MCP サーバーによって提供される決定論的な関数。