Package a2a.v1

インデックス

• A2AService（インターフェース）
• APIKeySecurityScheme（メッセージ）
• AgentCapabilities（メッセージ）
• AgentCard（メッセージ）
• AgentCardSignature（メッセージ）
• AgentExtension（メッセージ）
• AgentInterface（メッセージ）
• AgentProvider（メッセージ）
• AgentSkill（メッセージ）
• Artifact（メッセージ）
• AuthenticationInfo（メッセージ）
• AuthorizationCodeOAuthFlow（メッセージ）
• CancelTaskRequest（メッセージ）
• ClientCredentialsOAuthFlow（メッセージ）
• CreateTaskPushNotificationConfigRequest（メッセージ）
• DataPart（メッセージ）
• DeleteTaskPushNotificationConfigRequest（メッセージ）
• FilePart（メッセージ）
• GetAgentCardRequest（メッセージ）
• GetTaskPushNotificationConfigRequest（メッセージ）
• GetTaskRequest（メッセージ）
• HTTPAuthSecurityScheme（メッセージ）
• ImplicitOAuthFlow（メッセージ）
• ListTaskPushNotificationConfigRequest（メッセージ）
• ListTaskPushNotificationConfigResponse（メッセージ）
• Message（メッセージ）
• MutualTlsSecurityScheme（メッセージ）
• OAuth2SecurityScheme（メッセージ）
• OAuthFlows（メッセージ）
• OpenIdConnectSecurityScheme（メッセージ）
• Part（メッセージ）
• PasswordOAuthFlow（メッセージ）
• PushNotificationConfig（メッセージ）
• Role（列挙型）
• Security（メッセージ）
• SecurityScheme（メッセージ）
• SendMessageConfiguration（メッセージ）
• SendMessageRequest（メッセージ）
• SendMessageResponse（メッセージ）
• StreamResponse（メッセージ）
• StringList（メッセージ）
• Task（メッセージ）
• TaskArtifactUpdateEvent（メッセージ）
• TaskPushNotificationConfig（メッセージ）
• TaskState（列挙型）
• TaskStatus（メッセージ）
• TaskStatusUpdateEvent（メッセージ）
• TaskSubscriptionRequest（メッセージ）

A2AService

A2AService は、A2A プロトコルの gRPC バージョンを定義します。これは、必要に応じて AIP-127 に準拠するように、JSONRPC バージョンとは少し異なる形状になっています。名詞は AgentCard、Message、Task、TaskPushNotificationConfig です。

• メッセージは標準リソースではないため、get、delete、update、list インターフェースはなく、send と stream のカスタム メソッドのみがあります。
• タスクには、get インターフェースとカスタムの cancel メソッドと subscribe メソッドがあります。
• TaskPushNotificationConfig は、親がタスクであるリソースです。get、list、create メソッドがあります。
• AgentCard は、get メソッドのみを持つ静的リソースです。

CancelTask
rpc CancelTask(CancelTaskRequest) returns (Task) エージェントからタスクをキャンセルします。サポートされている場合、タスクの更新はこれ以上行われません。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

CreateTaskPushNotificationConfig
rpc CreateTaskPushNotificationConfig(CreateTaskPushNotificationConfigRequest) returns (TaskPushNotificationConfig) タスクのプッシュ通知構成を設定します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

DeleteTaskPushNotificationConfig
rpc DeleteTaskPushNotificationConfig(DeleteTaskPushNotificationConfigRequest) returns (Empty) タスクのプッシュ通知構成を削除します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

GetAgentCard
rpc GetAgentCard(GetAgentCardRequest) returns (AgentCard) GetAgentCard は、エージェントのエージェント カードを返します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

GetTask
rpc GetTask(GetTaskRequest) returns (Task) エージェントからタスクの現在の状態を取得します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

GetTaskPushNotificationConfig
rpc GetTaskPushNotificationConfig(GetTaskPushNotificationConfigRequest) returns (TaskPushNotificationConfig) タスクのプッシュ通知構成を取得します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

ListTaskPushNotificationConfig
rpc ListTaskPushNotificationConfig(ListTaskPushNotificationConfigRequest) returns (ListTaskPushNotificationConfigResponse) タスクに構成されているプッシュ通知のリストを取得します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

SendMessage
rpc SendMessage(SendMessageRequest) returns (SendMessageResponse) エージェントにメッセージを送信します。これは、タスクが完了するとタスクを返すブロッキング呼び出しです。LRO がリクエストされた場合は LRO を返します。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

SendStreamingMessage
rpc SendStreamingMessage(SendMessageRequest) returns (StreamResponse) SendStreamingMessage は、タスクが中断状態または終了状態になるまで、タスク更新イベントのストリームを返すストリーミング呼び出しです。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

TaskSubscription
rpc TaskSubscription(TaskSubscriptionRequest) returns (StreamResponse) TaskSubscription は、タスク更新イベントのストリームを返すストリーミング呼び出しです。これにより、ストリームが既存のインプロセス タスクに関連付けられます。タスクが完了すると、ストリームは完了したタスク（GetTask など）を返し、ストリームを閉じます。 認可スコープ 次の OAuth スコープが必要です。 https://www.googleapis.com/auth/cloud-platform 詳細については、Authentication Overview をご覧ください。

APIKeySecurityScheme

フィールド
description	string このセキュリティ スキームの説明。
location	string API キーの場所。有効な値は「query」、「header」、「cookie」です。
name	string 使用するヘッダー、クエリ、Cookie パラメータの名前。

AgentCapabilities

エージェントでサポートされる A2A 機能セットを定義します。

フィールド
streaming	bool エージェントがストリーミング レスポンスをサポートするかどうか
push_notifications	bool エージェントがクライアントの Webhook にプッシュ通知を送信できる場合
extensions[]	AgentExtension このエージェントでサポートされている拡張機能。

AgentCard

AgentCard には、次の重要な情報が表示されます。- 全体的な詳細（バージョン、名前、説明、用途）- スキル: エージェントが実行できる一連のアクション/ソリューション - エージェントがサポートするデフォルトのモダリティ/コンテンツ タイプ。- 認証の要件 Next ID: 19

フィールド
protocol_version	string このエージェントがサポートする A2A プロトコルのバージョン。
name	string 人が読める形式のエージェントの名前。例: 「レシピ エージェント」
description	string エージェントの行動範囲/ソリューション スペースの説明。例: 「レシピや料理についてユーザーをサポートするエージェント。」
url	string エージェントがホストされているアドレスへの URL。これは、エージェントによって宣言された優先エンドポイントを表します。
preferred_transport	string 優先エンドポイントのトランスポート。空の場合、デフォルトで JSONRPC になります。
additional_interfaces[]	AgentInterface サポート対象のトランスポートの追加に関するお知らせ。クライアントはサポートされているトランスポートのいずれかを使用できます。
provider	AgentProvider エージェントのサービス プロバイダ。
version	string エージェントのバージョン。例: 「1.0.0」
documentation_url	string エージェントに関する追加のドキュメントを提供する URL。
capabilities	AgentCapabilities エージェントがサポートする A2A 機能セット。
security_schemes	map<string, SecurityScheme> このエージェントでの認証に使用されるセキュリティ スキームの詳細。
security[]	Security protolint:disable REPEATED_FIELD_NAMES_PLURALIZED エージェントに連絡するためのセキュリティ要件。このリストは、AND の OR と見なすことができます。リスト内の各オブジェクトは、リクエストに存在する必要があるセキュリティ要件の可能なセットを 1 つ記述します。これにより、「呼び出し元は OAuth または API キーと mTLS のいずれかを使用する必要がある」などの指定が可能になります。例: security { schemes { key: "oauth" value { list: ["read"] } } } security { schemes { key: "api-key" } schemes { key: "mtls" } }
default_input_modes[]	string protolint:enable REPEATED_FIELD_NAMES_PLURALIZED エージェントがすべてのスキルでサポートするインタラクション モードのセット。これはスキルごとにオーバーライドできます。MIME タイプとして定義されます。
default_output_modes[]	string このエージェントの出力としてサポートされている MIME タイプ。
skills[]	AgentSkill スキルは、エージェントが実行できる能力の単位を表します。これはやや抽象的ですが、エージェントが成功する可能性が高い、より焦点を絞った一連のアクションを表しています。
supports_authenticated_extended_card	bool ユーザーが認証されたときにエージェントが拡張エージェント カードを提供するかどうか（つまり、.well-known のカードが GetAgentCard のカードと異なるかどうか）。
signatures[]	AgentCardSignature この AgentCard に対して計算された JSON Web Signature。
icon_url	string エージェントのアイコンへの URL（省略可）。

AgentCardSignature

AgentCardSignature は、AgentCard の JWS 署名を表します。これは、RFC 7515 JSON Web Signature（JWS）の JSON 形式に準拠しています。

フィールド
protected	string 必須。署名の保護された JWS ヘッダー。これは常に base64url エンコードされた JSON オブジェクトです。必須。
signature	string 必須。計算された署名（base64url でエンコード）。必須。
header	Struct 保護されていない JWS ヘッダー値。

AgentExtension

エージェントでサポートされている拡張機能の宣言。

フィールド
uri	string 拡張機能の URI。例: "https://developers.google.com/identity/protocols/oauth2"
description	string このエージェントがこの拡張機能を使用する方法の説明。例: 「Google OAuth 2.0 認証」
required	bool クライアントが拡張機能の特定の要件に従う必要があるかどうか。例: false
params	Struct 拡張機能のオプションの構成。

AgentInterface

エージェントの追加の輸送情報を定義します。

フィールド
url	string このインターフェースが見つかる URL。
transport	string この URL をサポートしているトランスポート。これはオープン形式の文字列で、多くのトランスポート プロトコルに簡単に拡張できます。公式にサポートされているコアは JSONRPC、GRPC、HTTP+JSON です。
tenant	string エージェントを呼び出すときにリクエストで設定されるテナント。試験運用版。1.0 リリースで変更される可能性があります。

AgentProvider

エージェントのサービス プロバイダに関する情報を表します。

フィールド
url	string プロバイダの参照 URL。例: "https://ai.google.dev"
organization	string プロバイダの組織名。例: 「Google」

AgentSkill

AgentSkill は、エージェントが実行できるアクション/ソリューションの単位を表します。これは、エージェントに提供を依頼できる信頼性の高いソリューションの一種と考えることができます。エージェントは特定のスキルをいつどのように使用するかを自律的に選択できますが、クライアントは、スキルが定義されていれば、そのアクション単位を確実に実行できると確信する必要があります。

フィールド
id	string このエージェント内のスキルの固有識別子。
name	string 人が読める形式のスキル名。
description	string スキルに関する詳細と動作の説明（人間または LLM が読める形式）。
tags[]	string 分類と利用を強化するためのスキルのタグのセット。例: ["cooking", "customer support", "billing"]
examples[]	string このスキルが対応するように設計されている一連のサンプルクエリ。これらの例は、特定の目標を達成するためにエージェントにリクエストを作成する方法を理解するのに役立ちます。例: ["パンのレシピが必要です"]
input_modes[]	string サポートされている入力モダリティ。
output_modes[]	string 生成される可能性のある出力モダリティ
security[]	Security protolint:disable REPEATED_FIELD_NAMES_PLURALIZED エージェントがこのスキルを活用するために必要なセキュリティ スキーマ。AgentCard.security 全体と同様に、このリストはセキュリティ要件オブジェクトの論理 OR を表します。各オブジェクトは、一緒に使用する必要があるセキュリティ スキームのセットです（論理 AND）。protolint:enable REPEATED_FIELD_NAMES_PLURALIZED

アーティファクト

アーティファクトは、タスク完了結果のコンテナです。これらはメッセージに似ていますが、ポイントツーポイント通信ではなく、タスクの成果物として使用することを目的としています。

フィールド
artifact_id	string アーティファクトの一意の識別子（UUID など）。タスク内で一意である必要があります。
name	string 人が読める形式のアーティファクトの名前。
description	string アーティファクトの説明（人が読める形式）。省略可。
parts[]	Part アーティファクトのコンテンツ。
metadata	Struct アーティファクトに含まれるメタデータ（省略可）。
extensions[]	string このアーティファクトに存在する、またはこのアーティファクトにコントリビューションされた拡張機能の URI。

AuthenticationInfo

プッシュ通知に使用される認証の詳細を定義します。

フィールド
schemes[]	string サポートされる認証スキーム - Basic、Bearer など
credentials	string 省略可能な認証情報

AuthorizationCodeOAuthFlow

フィールド
authorization_url	string このフローで使用される認証 URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています
token_url	string このフローで使用するトークン URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています。
refresh_url	string 更新トークンの取得に使用する URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています。
scopes	map<string, string> OAuth2 セキュリティ スキームで使用可能なスコープ。スコープ名とその簡単な説明のマッピング。マップは空でも構いません。

CancelTaskRequest

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。
name	string キャンセルするタスクのリソース名。形式: tasks/{task_id}

ClientCredentialsOAuthFlow

フィールド
token_url	string このフローで使用するトークン URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています。
refresh_url	string 更新トークンの取得に使用する URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています。
scopes	map<string, string> OAuth2 セキュリティ スキームで使用可能なスコープ。スコープ名とその簡単な説明のマッピング。マップは空でも構いません。

CreateTaskPushNotificationConfigRequest

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。
parent	string 必須。この構成の親タスク リソース。形式: tasks/{task_id}
config_id	string 必須。新しい構成の ID。
config	TaskPushNotificationConfig 必須。作成する構成。

DataPart

DataPart は構造化された blob を表します。通常は JSON ペイロードです。

フィールド
data	Struct

DeleteTaskPushNotificationConfigRequest

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。
name	string 削除する構成のリソース名。形式: tasks/{task_id}/pushNotificationConfigs/{config_id}

FilePart

FilePart は、ファイルの提供方法を表します。ファイルが小さい場合は、file_with_bytes を使用してバイトを直接フィードできます。ファイルが大きい場合、エージェントは file_with_uri ソースからコンテンツを直接読み取る必要があります。

フィールド
mime_type	string
name	string
共用体フィールド file。 file は次のいずれかになります。
file_with_uri	string
file_with_bytes	bytes

GetAgentCardRequest

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。

GetTaskPushNotificationConfigRequest

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。
name	string 取得する構成のリソース名。形式: tasks/{task_id}/pushNotificationConfigs/{config_id}

GetTaskRequest

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。
name	string 必須。タスクのリソース名。形式: tasks/{task_id}
history_length	int32 取得するタスクの履歴の最新メッセージの数。

HTTPAuthSecurityScheme

フィールド
description	string このセキュリティ スキームの説明。
scheme	string RFC7235 で定義されている Authorization ヘッダーで使用される HTTP 認証スキームの名前。使用される値は、IANA 認証スキーム レジストリに登録されるべきです。RFC7235 で定義されているように、値では大文字と小文字が区別されません。
bearer_format	string ベアラートークンの形式を識別するためのクライアントへのヒント。通常、ベアラートークンは認可サーバーによって生成されるため、この情報は主にドキュメント作成を目的としています。

ImplicitOAuthFlow

フィールド
authorization_url	string このフローで使用される認証 URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています
refresh_url	string 更新トークンの取得に使用する URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています。
scopes	map<string, string> OAuth2 セキュリティ スキームで使用可能なスコープ。スコープ名とその簡単な説明のマッピング。マップは空でも構いません。

ListTaskPushNotificationConfigRequest

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。
parent	string 親タスク リソース。形式: tasks/{task_id}
page_size	int32 AIP-158 では、これらのフィールドが存在します。通常は使用されません。返す構成の最大数。指定しない場合は、すべての構成が返されます。
page_token	string 前回の ListTaskPushNotificationConfigRequest 呼び出しから受け取ったページトークン。後続のページを取得するには、これを指定します。ページ分割を行う場合、ListTaskPushNotificationConfigRequest に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。

ListTaskPushNotificationConfigResponse

フィールド
configs[]	TaskPushNotificationConfig プッシュ通知構成のリスト。
next_page_token	string 次のページを取得するために page_token として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

メッセージ

メッセージは、クライアントとサーバー間の通信の 1 つの単位です。コンテキストと、必要に応じてタスクに関連付けられます。サーバーはコンテキスト定義を担当するため、メッセージで常に context_id を提供する必要があります。クライアントは、メッセージを関連付けるコンテキストを認識している場合、context_id を任意で指定できます。task_id も同様ですが、タスクが作成されるかどうか、task_id を含めるかどうかはサーバーが決定します。

フィールド
message_id	string メッセージの一意の識別子（UUID など）。これは必須で、メッセージ作成者によって作成されます。
context_id	string メッセージのコンテキスト ID。これは省略可能です。設定すると、メッセージは指定されたコンテキストに関連付けられます。
task_id	string メッセージのタスク ID。これは省略可能です。設定すると、メッセージは指定されたタスクに関連付けられます。
role	Role メッセージのロール。
content[]	Part protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Content はメッセージ コンテンツのコンテナです。
metadata	Struct protolint:enable REPEATED_FIELD_NAMES_PLURALIZED メッセージとともに提供する任意のメタデータ。
extensions[]	string このメッセージに存在する、またはこのメッセージに提供された拡張機能の URI。

MutualTlsSecurityScheme

フィールド
description	string このセキュリティ スキームの説明。

OAuth2SecurityScheme

フィールド
description	string このセキュリティ スキームの説明。
flows	OAuthFlows サポートされているフロータイプの構成情報を含むオブジェクト
oauth2_metadata_url	string oauth2 認証サーバー メタデータ RFC8414 の URL。TLS が必要です。

OAuthFlows

フィールド
共用体フィールド flow。 flow は次のいずれかになります。
authorization_code	AuthorizationCodeOAuthFlow
client_credentials	ClientCredentialsOAuthFlow
implicit	ImplicitOAuthFlow
password	PasswordOAuthFlow

OpenIdConnectSecurityScheme

フィールド
description	string このセキュリティ スキームの説明。
open_id_connect_url	string [[OpenID-Connect-Discovery]] プロバイダ メタデータを検出するための既知の URL。

Part

Part は、コミュニケーション コンテンツのセクションのコンテナを表します。パーツは、純粋なテキスト、何らかのファイル（画像、動画など）、構造化データ BLOB（JSON など）にすることができます。

フィールド
metadata	Struct このパートに関連付けられたメタデータ（省略可）。
共用体フィールド part。 part は次のいずれかになります。
text	string
file	FilePart
data	DataPart

PasswordOAuthFlow

フィールド
token_url	string このフローで使用するトークン URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています。
refresh_url	string 更新トークンの取得に使用する URL。これは URL の形式でなければなりません。OAuth2 標準では TLS の使用が義務付けられています。
scopes	map<string, string> OAuth2 セキュリティ スキームで使用可能なスコープ。スコープ名とその簡単な説明のマッピング。マップは空でも構いません。

PushNotificationConfig

タスクの更新に関するプッシュ通知を設定するための構成。

フィールド
id	string このプッシュ通知の一意の識別子（UUID など）。
url	string 通知を送信する URL
token	string このタスク/セッションに固有のトークン
authentication	AuthenticationInfo 通知とともに送信される認証に関する情報

ロール

列挙型
ROLE_UNSPECIFIED
ROLE_USER	USER ロールは、クライアントからサーバーへの通信を指します。
ROLE_AGENT	AGENT ロールは、サーバーからクライアントへの通信を指します。

セキュリティ

フィールド
schemes	map<string, StringList>

SecurityScheme

フィールド
共用体フィールド scheme。 scheme は次のいずれかになります。
api_key_security_scheme	APIKeySecurityScheme
http_auth_security_scheme	HTTPAuthSecurityScheme
oauth2_security_scheme	OAuth2SecurityScheme
open_id_connect_security_scheme	OpenIdConnectSecurityScheme
mtls_security_scheme	MutualTlsSecurityScheme

SendMessageConfiguration

送信メッセージ リクエストの構成。

フィールド
accepted_output_modes[]	string エージェントが応答することが想定される出力モード。
push_notification	PushNotificationConfig 更新の受信に使用できる Webhook の構成
history_length	int32 履歴に含めるメッセージの最大数。0 の場合、履歴は無制限になります。
blocking	bool true の場合、タスクが完了するまでメッセージはブロックされます。false の場合、メッセージは非ブロッキングになり、タスクはすぐに返されます。タスクの更新を確認するのは、呼び出し元の責任です。

SendMessageRequest

///////// リクエスト メッセージ ///////////

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。
request	Message 必須。エージェントに送信するメッセージ。
configuration	SendMessageConfiguration 送信リクエストの構成。
metadata	Struct リクエストのメタデータ（省略可）。

SendMessageResponse

////// レスポンス メッセージ ///////////

フィールド
共用体フィールド payload。 payload は次のいずれかになります。
task	Task
msg	Message

StreamResponse

メッセージのストリーム レスポンス。ストリームは次のいずれかのシーケンスにする必要があります。レスポンスがメッセージの場合、ストリームには 1 つのメッセージのみが含まれ、その後閉じられます。レスポンスがタスクのライフサイクルの場合、最初のレスポンスは Task オブジェクトで、その後に 0 個以上の TaskStatusUpdateEvent と TaskArtifactUpdateEvent が続きます。Task が中断状態または終了状態の場合、ストリームは完了します。これらの条件が満たされる前に終了したストリームは、

フィールド
共用体フィールド payload。 payload は次のいずれかになります。
task	Task
msg	Message
status_update	TaskStatusUpdateEvent
artifact_update	TaskArtifactUpdateEvent

StringList

protolint:disable REPEATED_FIELD_NAMES_PLURALIZED

フィールド
list[]	string

タスク

タスクは、A2A のアクションのコア単位です。現在のステータスがあり、タスクの結果が作成されると、アーティファクトに保存されます。タスクに複数のターンがある場合、それらは履歴に保存されます。

フィールド
id	string タスクの一意の識別子（UUID など）。新しいタスクに対してサーバーによって生成されます。
context_id	string コンテキスト内のインタラクション（タスクとメッセージ）のコレクションの一意の識別子（UUID など）。A2A サーバーによって作成されます。
status	TaskStatus タスクの現在のステータス（状態とメッセージを含む）。
artifacts[]	Artifact タスクの出力アーティファクトのセット。
history[]	Message protolint:disable REPEATED_FIELD_NAMES_PLURALIZED タスクのインタラクションの履歴。
metadata	Struct protolint:enable REPEATED_FIELD_NAMES_PLURALIZED タスクに関するカスタム メタデータを保存する Key-Value オブジェクト。

TaskArtifactUpdateEvent

TaskArtifactUpdateEvent は、アーティファクトが生成されたタスクの差分を表します。

フィールド
task_id	string このアーティファクトのタスクの ID
context_id	string このタスクが属するコンテキストの ID
artifact	Artifact アーティファクト自体
append	bool 以前に生成されたものに追加するかどうか
last_chunk	bool これがアーティファクトの最後の部分を表すかどうか
metadata	Struct アーティファクトの更新に関連付けられたメタデータ（省略可）。

TaskPushNotificationConfig

フィールド
name	string 構成のリソース名。形式: tasks/{task_id}/pushNotificationConfigs/{config_id}
push_notification_config	PushNotificationConfig プッシュ通知の構成の詳細。

TaskState

Task が取りうる状態のセット。

列挙型
TASK_STATE_UNSPECIFIED
TASK_STATE_SUBMITTED	タスクが作成されたことを確認するステータスを表します
TASK_STATE_WORKING	タスクがアクティブに処理されている状態を表します
TASK_STATE_COMPLETED	タスクが完了したステータスを表します。これは終了状態です
TASK_STATE_FAILED	タスクが完了したが失敗したステータスを表します。これは終了状態です
TASK_STATE_CANCELLED	タスクが完了する前にキャンセルされたステータスを表します。これは終了状態です。
TASK_STATE_INPUT_REQUIRED	タスクを完了するために情報が必要なステータスを表します。これは中断された状態です。
TASK_STATE_REJECTED	エージェントがタスクを実行しないと判断したステータスを表します。これは、タスクの初回作成時、またはエージェントが続行できないと判断した後に実行されることがあります。これは終了状態です。
TASK_STATE_AUTH_REQUIRED	アップストリーム クライアントからの認証が必要な状態を表します。認証は帯域外で行われるため、これは中断状態や終了状態ではありません。

TaskStatus

タスクのステータスのコンテナ

フィールド
state	TaskState このタスクの現在の状態
update	Message ステータスに関連付けられたメッセージ。
timestamp	Timestamp ステータスが記録されたときのタイムスタンプ。例: 「2023-10-27T10:00:00Z」

TaskStatusUpdateEvent

TaskStatusUpdateEvent は、タスクが変更されたことを示すタスクの差分イベントです。

フィールド
task_id	string 変更されたタスクの ID
context_id	string タスクが属するコンテキストの ID
status	TaskStatus タスクの新しいステータス。
final	bool このタスクで想定される最後のステータス更新かどうか。
metadata	Struct タスクの更新に関連付けるメタデータ（省略可）。

TaskSubscriptionRequest

フィールド
tenant	string 省略可能なテナント。パスパラメータとして指定します。試験運用版。1.0 リリースで変更される可能性があります。
name	string 登録するタスクのリソース名。形式: tasks/{task_id}