Service リソースを作成して Agent Registry にエージェントまたは Model Context Protocol(MCP)サーバーを手動で登録する場合は、その機能を宣言する JSON 構成ファイルを提供します。Agent Registry は、これらのファイルをインデックスに登録する前にオープンソース仕様に照らして検証し、コンシューマがエージェントの A2A スキルと MCP ツールを検出できるようにします。次の JSON 構造と例を使用して、エージェント カードと MCP ツール仕様をフォーマットします。
エージェント カードのスキーマ
A2A 準拠のエージェントを登録する場合、agent-card.json ペイロードは公式の Agent2Agent(A2A)仕様に準拠している必要があります。仕様ファイルの最大ファイルサイズは 150 KB です。skills 配列フィールドは、キーワード検索インデックスをサポートしています。
エージェント レジストリは、A2A エージェント カードのバージョン 1.0 と 0.3 をサポートしています。バージョンを選択して、JSON スキーマとフィールド定義を表示します。
バージョン 1.0(推奨)
A2A エージェント カードのバージョン 1.0 の場合、ペイロードは公式の A2A v1.0 仕様に準拠している必要があります。この仕様では、supportedInterfaces 配列内にトランスポート エンドポイントを宣言します。
{
"name": "string",
"description": "string",
"version": "string",
"supportedInterfaces": [
{
"url": "string",
"protocolBinding": "string",
"protocolVersion": "string",
"tenant": "string"
}
],
"capabilities": {
"streaming": false,
"pushNotifications": false,
"extendedAgentCard": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
],
"skills": [
{
"id": "string",
"name": "string",
"description": "string",
"tags": [
"string"
],
"examples": [
"string"
]
}
]
}
フィールドの定義
name: 人が読める形式のエージェント名。description: エージェントの目的の概要。version: エージェントのバージョン(例:1.0.0)。supportedInterfaces: サポートされているトランスポートと URL の組み合わせの配列。各インターフェースには次のものが含まれます。url: このインターフェースに到達するエンドポイント URL。protocolBinding: この URL でサポートされているプロトコル バインディング(HTTP+JSON、JSONRPC、GRPCなど)。protocolVersion: このインターフェースが公開する A2A プロトコル バージョン(例:1.0.0)。tenant(省略可): エージェント オーナーの識別子。
capabilities(省略可): 次のようなサポートされている運用機能を指定します。extensions(省略可): プロトコル拡張機能の配列。streaming(省略可): エージェントがストリーミング レスポンスをサポートしているかどうかを示すブール値。pushNotifications(省略可): タスクの更新でプッシュ通知がサポートされているかどうかを示すブール値。extendedAgentCard(省略可): 認証時にエージェントが拡張エージェント カードを提供するかどうかを示すブール値。
defaultInputModes(省略可): 入力として受け入れられる MIME タイプの配列。defaultOutputModes(省略可): 出力として生成される MIME タイプの配列。skills: エージェントが持つ A2A スキルの配列。id: A2A スキルの一意のプログラム識別子。name: A2A スキルの人が読める形式の名前。description: A2A スキルの機能の詳細な説明。tags: A2A スキルの分類に使用されるキーワード文字列の配列。examples: この A2A スキルが処理するプロンプトまたはシナリオの例の配列。
バージョン 0.3
A2A エージェント カードのバージョン 0.3 の場合、ペイロードは v0.3.0 仕様に準拠している必要があります。この仕様では、プライマリ推論 URL とプロトコル バージョンが最上位フィールドとして宣言されています。
{
"name": "string",
"description": "string",
"version": "string",
"protocolVersion": "string",
"url": "string",
"skills": [
{
"id": "string",
"name": "string",
"description": "string",
"tags": [
"string"
],
"examples": [
"string"
]
}
],
"capabilities": {
"streaming": false,
"pushNotifications": false,
"stateTransitionHistory": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
]
}
フィールドの定義
name: 人が読める形式のエージェント名。description: エージェントの目的の概要。version: エージェントのバージョン(例:1.0.2)。protocolVersion: エージェントが実装する A2A プロトコルのバージョン。バージョン1.0ではこの最上位フィールドが非推奨になっているため、このスキーマの値は0.3または0.3パッチ バージョン(0.3.1など)にする必要があります。url: エージェントにアクセスできるエンドポイント URL。capabilities(省略可): エージェントがサポートする運用機能(streaming、pushNotifications、stateTransitionHistoryなど)を指定するオブジェクト。defaultInputModes(省略可): エージェントが入力として受け入れるデフォルトの MIME タイプを定義する文字列の配列(例:["text/plain"])。defaultOutputModes(省略可): エージェントが出力として生成するデフォルトの MIME タイプを定義する文字列の配列(例:["text/plain"])。skills: エージェントが持つ A2A スキルの配列。id: A2A スキルの一意のプログラム識別子。name: A2A スキルの人が読める形式の名前。description: A2A スキルの機能の詳細な説明。tags: A2A スキルの分類に使用されるキーワード文字列の配列。examples: この A2A スキルが処理するプロンプトまたはシナリオの例の配列。
MCP ツールのスキーマ
MCP サーバーを登録するときは、toolspec.json ペイロードに、MCP Tool オブジェクト スキーマに準拠するツールのリストを含める必要があります。
想定されるペイロードは、標準の MCP ツールまたはリスト リクエストから返されるとおり、単一の tools フィールドを含む JSON オブジェクトです。この仕様ファイルの最大ファイルサイズは 150 KB です。
{
"tools": [
{
"name": "string",
"description": "string",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "string",
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": true
},
"_meta": {
"com.googleapis.iap/PolicyHints": {
"authorization": {
"toolDisabled": false,
"hitlMode": "HITL_MODE_ALWAYS"
}
}
}
}
]
}
フィールドの定義
tools: サーバーから提供されるツールの配列。name: ツールのプログラム識別子。description: ツールの目的を人が読める形式で説明したもの。inputSchema: ツールに想定されるパラメータを定義する JSON スキーマ オブジェクト。annotations: オーケストレーター エージェントがツールとやり取りする方法をガイドする動作ヒント。title: 人が読める形式のツールのタイトル。readOnlyHint:trueの場合、ツールはデータを取得するだけで、環境を変更しません。デフォルトはfalseです。destructiveHint:trueの場合、ツールは永続的な変更を引き起こす可能性のあるオペレーションを実行します。デフォルトはtrueです。idempotentHint:trueの場合、ツールを繰り返し呼び出しても追加の効果はありません。デフォルトはfalseです。openWorldHint:trueの場合、ツールは外部システムとやり取りします。デフォルトはtrueです。
_meta(省略可): 構造化メタデータをツールにアタッチするための Model Context Protocol(MCP)仕様に準拠したプロトコルレベルのメタデータ。標準のannotationsは、事前定義されたヒントに限定されたクローズド オブジェクトであるため、_metaは、標準の MCP クライアントとの互換性を維持しながら、追加のメタデータ用の拡張可能なコンテナを提供します。プロバイダ間での名前の競合を回避するため、
_meta内の最上位キーには逆ドメイン表記を使用します。Agent Registry は、apphub.googleapis.com/McpServer拡張メタデータ スキーマに照らして_metaを検証し、次の名前空間をサポートします。com.googleapis.iap/PolicyHints(省略可): Identity-Aware Proxy(IAP)と Agent Gateway によって評価されるポリシーヒント。ツールの認可と人間参加型(HITL)制御を適用します。authorization(省略可): ツールの認可構成。toolDisabled(省略可): ツールが呼び出しに対して無効になっているかどうかを示すブール値。ツールを無効にするには、trueに設定します。デフォルトはfalseです。つまり、このフィールドを省略すると、ツールが有効になります。hitlMode(省略可): ツールの人間参加型(HITL)実行モードを指定する文字列。HITL_MODE_UNSPECIFIED: HITL モードが指定されていません。HITL_MODE_DISABLED: ツールは、インタラクティブな人間の承認を必要とせずに実行されます。HITL_MODE_ALWAYS: ツールは、実行前に常にインタラクティブな人間の承認を必要とします。HITL_MODE_IF_UNSAFE: ツールは、オペレーションが安全でないと評価された場合にのみ、インタラクティブな人間の承認を必要とします。