MCP Tools Reference: ces.googleapis.com

ツール: get_conversation

指定された会話の詳細を取得します。

次のコードサンプルは、curl を使用して get_conversation MCP ツールを呼び出す方法を示しています。

Curl リクエスト
curl --location 'https://ces.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_conversation", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }'

入力スキーマ

AgentService.GetConversation のリクエスト メッセージです。

GetConversationRequest

JSON 表現
{ "name": string, "source": enum (Source) }

フィールド
name	string 必須。取得する会話のリソース名。
source (deprecated)	enum (Source) この項目は非推奨です。 省略可。会話のソースを示します。設定しない場合、すべてのソースが検索されます。

ソース

会話のソース。

列挙型
SOURCE_UNSPECIFIED	ソースが指定されていません。
LIVE	会話はライブ エンドユーザーからのものです。
SIMULATOR	会話はシミュレータからのものです。
EVAL	会話は評価からのものです。
AGENT_TOOL	会話がエージェント ツールからのものである。エージェント ツールは、テストとデバッグの目的で永続化される別のセッションでエージェントを実行します。

出力スキーマ

会話は、エンドユーザーと CES アプリ間のやり取りを表します。

会話

JSON 表現
{ "name": string, "startTime": string, "endTime": string, "turns": [ { object (Turn) } ], "turnCount": integer, "channelType": enum (ChannelType), "source": enum (Source), "inputTypes": [ enum (InputType) ], "entryAgent": string, "deployment": string, "appVersion": string, "languageCode": string, "messages": [ { object (Message) } ] }

フィールド
name	string ID。会話の固有識別子。形式: projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}
startTime	string (Timestamp format) 出力専用。会話が作成されたときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime	string (Timestamp format) 出力専用。会話が完了したときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
turns[]	object (Turn) 必須。会話のターン。
turnCount	integer 出力専用。会話のターン数。
channelType (deprecated)	enum (ChannelType) この項目は非推奨です。 非推奨。代わりに input_types を使用してください。
source	enum (Source) 出力専用。会話のソースを示します。
inputTypes[]	enum (InputType) 出力専用。会話の入力タイプ。
entryAgent	string 出力専用。会話に最初に対応するエージェント。指定しない場合、会話はルート エージェントによって処理されます。形式: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
deployment	string 出力専用。会話の処理に使用されるアプリのデプロイ。形式: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
appVersion	string 出力専用。会話の処理に使用されたアプリのバージョン。形式: projects/{project}/locations/{location}/apps/{app}/versions/{version}
languageCode	string 出力専用。会話の言語コード。
messages[] (deprecated)	object (Message) この項目は非推奨です。 非推奨。代わりにターンを使用してください。

タイムスタンプ

JSON 表現
{ "seconds": string, "nanos": integer }

フィールド
seconds	string (int64 format) UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos	integer ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0～999,999,999 にする必要があります（両端を含む）。

Turn

JSON 表現
{ "messages": [ { object (Message) } ], "rootSpan": { object (Span) }, "userIntendedText": string }

フィールド
messages[]	object (Message) 省略可。会話ターンのメッセージのリスト。ユーザー入力、エージェントのレスポンス、処理中の中間イベントが含まれます。
rootSpan	object (Span) 省略可。アクション処理のルートスパン。
userIntendedText	string 省略可。シミュレートされた発信者（Polysynth）からの意図された正解テキスト。単語誤り率の指標が有効になっている場合にのみ入力されます。

メッセージ

JSON 表現
{ "role": string, "chunks": [ { object (Chunk) } ], "eventTime": string }

フィールド
role	string 省略可。会話内のロール（ユーザー、エージェントなど）。
chunks[]	object (Chunk) 省略可。メッセージのコンテンツをチャンクのシーケンスとして表します。
eventTime	string (Timestamp format) 省略可。メッセージが送信または受信されたときのタイムスタンプ。メッセージが example の一部である場合は使用しないでください。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

チャンク

JSON 表現

{ // Union field data can be only one of the following: "text": string, "transcript": string, "blob": { object (Blob) }, "payload": { object }, "image": { object (Image) }, "toolCall": { object (ToolCall) }, "toolResponse": { object (ToolResponse) }, "agentTransfer": { object (AgentTransfer) }, "updatedVariables": { object }, "defaultVariables": { object } // End of list of possible types for union field data. }

フィールド
共用体フィールド data。チャンクデータ。data は次のいずれかになります。
text	string 省略可。テキストデータ。
transcript	string 省略可。音声に関連付けられた文字起こし。
blob	object (Blob) 省略可。Blob データ。
payload	object (Struct format) 省略可。カスタム ペイロード データ。
image	object (Image) 省略可。画像データ。
toolCall	object (ToolCall) 省略可。ツールの実行リクエスト。
toolResponse	object (ToolResponse) 省略可。ツール実行のレスポンス。
agentTransfer	object (AgentTransfer) 省略可。エージェントの転送イベント。
updatedVariables	object (Struct format) 構造体は、会話で更新された変数を変数名でキー設定して表します。
defaultVariables	object (Struct format) 構造体は、会話の開始時のデフォルト変数を表します。変数名でキー設定されます。

Blob

JSON 表現
{ "mimeType": string, "data": string }

フィールド
mimeType	string 必須。ソースデータの IANA 標準 MIME タイプ。
data	string (bytes format) 必須。blob の元のバイト。 Base64 でエンコードされた文字列。

構造体

JSON 表現
{ "fields": { string: value, ... } }

フィールド
fields	map (key: string, value: value (Value format)) 動的に型指定される値の順序なしのマップ。 "key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

JSON 表現
{ "key": string, "value": value }

フィールド
key	string
value	value (Value format)

値

JSON 表現
{ // Union field kind can be only one of the following: "nullValue": null, "numberValue": number, "stringValue": string, "boolValue": boolean, "structValue": { object }, "listValue": array // End of list of possible types for union field kind. }

フィールド
共用体フィールド kind。値の種類。kind は次のいずれかになります。
nullValue	null JSON null を表します。
numberValue	number JSON 数値を表します。NaN、Infinity、-Infinity は JSON でサポートされていないため、使用できません。また、JSON 形式では通常、数値型で大きな Int64 値がサポートされていないため、大きな Int64 値も表現できません。
stringValue	string JSON 文字列を表します。
boolValue	boolean JSON ブール値（JSON の true または false リテラル）を表します。
structValue	object (Struct format) JSON オブジェクトを表します。
listValue	array (ListValue format) JSON 配列を表します。

ListValue

JSON 表現
{ "values": [ value ] }

フィールド
values[]	value (Value format) 動的に型指定される値の繰り返しフィールド。

画像

JSON 表現
{ "mimeType": string, "data": string, "altText": string }

フィールド
mimeType	string 必須。ソースデータの IANA 標準 MIME タイプ。サポートされている画像タイプは次のとおりです。* image/png * image/jpeg * image/webp
data	string (bytes format) 必須。画像の未加工のバイト数。 Base64 でエンコードされた文字列。
altText	string 省略可。画像の代替テキスト。

ToolCall

JSON 表現
{ "id": string, "displayName": string, "args": { object }, "parentToolCallId": string, "agentName": string, // Union field tool_identifier can be only one of the following: "tool": string, "toolsetTool": { object (ToolsetTool) } // End of list of possible types for union field tool_identifier. }

フィールド
id	string 省略可。ツール呼び出しの固有識別子。入力されている場合、クライアントは ToolResponse の照合用のウェブ商品アイテム ID を含む実行結果を返す必要があります。
displayName	string 出力専用。ツールの表示名。
args	object (Struct format) 省略可。JSON オブジェクト形式のツールの入力パラメータと値。
parentToolCallId	string 出力専用。親通話の代わりに作業しているサブエージェントによって発行された場合、このツール呼び出しの原因となったツール呼び出しの ID。トップレベルの呼び出しの場合は空。クライアントが、サブエージェントの作業を、すべてのステップを兄弟としてレンダリングするのではなく、その作業を開始した呼び出しの下にグループ化できるようにします。
agentName	string 出力専用。この呼び出しを発行したエージェントの人が読める形式の名前（「契約アーキテクト」など）。ルート エージェントが発行した場合は空。
共用体フィールド tool_identifier。実行するツールの識別子。永続化されたツールまたはツールセットのツールです。tool_identifier は次のいずれかになります。
tool	string 省略可。実行するツールの名前。形式: projects/{project}/locations/{location}/apps/{app}/tools/{tool}
toolsetTool	object (ToolsetTool) 省略可。実行するツールセット ツール。

ToolsetTool

JSON 表現
{ "toolset": string, "toolId": string }

フィールド
toolset	string 必須。このツールが派生した Toolset のリソース名。形式: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}
toolId	string 省略可。スキーマを取得するツールをフィルタするツール ID。

ToolResponse

JSON 表現
{ "id": string, "displayName": string, "response": { object }, "parentToolCallId": string, "agentName": string, // Union field tool_identifier can be only one of the following: "tool": string, "toolsetTool": { object (ToolsetTool) } // End of list of possible types for union field tool_identifier. }

フィールド
id	string 省略可。レスポンスの対象となる tool call の照合用のウェブ商品アイテム ID。
displayName	string 出力専用。ツールの表示名。
response	object (Struct format) 必須。JSON オブジェクト形式のツール実行結果。「output」キーを使用してツールのレスポンスを指定し、「error」キーを使用してエラーの詳細を指定します（ある場合）。「output」キーと「error」キーが指定されていない場合、レスポンス全体がツール実行結果として扱われます。
parentToolCallId	string 出力専用。親通話の代わりに作業しているサブエージェントによって発行された場合、このツール呼び出しの原因となったツール呼び出しの ID。トップレベルの呼び出しの場合は空。クライアントが、サブエージェントの作業を、すべてのステップを兄弟としてレンダリングするのではなく、その作業を開始した呼び出しの下にグループ化できるようにします。
agentName	string 出力専用。この呼び出しを発行したエージェントの人が読める形式の名前（「契約アーキテクト」など）。ルート エージェントが発行した場合は空。
共用体フィールド tool_identifier。実行されたツールの ID。永続化されたツールまたはツールセットのツールです。tool_identifier は次のいずれかになります。
tool	string 省略可。実行するツールの名前。形式: projects/{project}/locations/{location}/apps/{app}/tools/{tool}
toolsetTool	object (ToolsetTool) 省略可。実行されたツールセット ツール。

AgentTransfer

JSON 表現
{ "targetAgent": string, "displayName": string }

フィールド
targetAgent	string 必須。会話の転送先のエージェント。ここから先は、エージェントが会話に対応します。形式: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
displayName	string 出力専用。エージェントの表示名。

スパン

JSON 表現
{ "name": string, "startTime": string, "endTime": string, "duration": string, "attributes": { object }, "childSpans": [ { object (Span) } ] }

フィールド
name	string 出力専用。スパンの名前。
startTime	string (Timestamp format) 出力専用。スパンの開始時間。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime	string (Timestamp format) 出力専用。スパンの終了時間。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
duration	string (Duration format) 出力専用。スパンの期間。 s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。
attributes	object (Struct format) 出力専用。スパンに関連付けられた Key-Value 属性。
childSpans[]	object (Span) 出力専用。このスパンの下にネストされている子スパン。

所要時間

JSON 表現
{ "seconds": string, "nanos": integer }

フィールド
seconds	string (int64 format) 期間の符号付き秒数。-315,576,000,000 ～+315,576,000,000 の範囲（両端を含む）にする必要があります。注: これらの上限は、60 秒/分 * 60 分/時間 * 24 時間/日 * 365.25 日/年 * 10,000 年から計算されます。
nanos	integer 時間のスパンのナノ秒分解能による、秒の符号付き小数以下部分。1 秒未満の期間は、0 の seconds フィールドと正または負の nanos フィールドで表されます。1 秒以上の期間の場合、nanos フィールドのゼロ以外の値は、seconds フィールドと同じ符号にする必要があります。-999,999,999～+999,999,999 の範囲内（境界含む）である必要があります。

NullValue

JSON null を表します。

NullValue はセンチネルです。1 つの値のみを持つ列挙型を使用して、Value 型共用体の null 値を表します。

0 以外の値を持つ NullValue 型のフィールドは無効と見なされます。ほとんどの ProtoJSON シリアライザーは、整数値に関係なく、null_value を JSON null として設定した Value を出力するため、0 値に往復します。

列挙型
NULL_VALUE	Null 値。

ChannelType

会話のチャンネル タイプ。

列挙型
CHANNEL_TYPE_UNSPECIFIED	チャンネル タイプが指定されていません。
TEXT	会話には、エンドユーザーとエージェント間のテキスト メッセージのみが含まれます。
AUDIO	会話には、エンドユーザーとエージェント間の音声メッセージが含まれています。
MULTIMODAL	エンドユーザーとエージェント間の会話のマルチモーダル メッセージ（画像など）。

ソース

会話のソース。

列挙型
SOURCE_UNSPECIFIED	ソースが指定されていません。
LIVE	会話はライブ エンドユーザーからのものです。
SIMULATOR	会話はシミュレータからのものです。
EVAL	会話は評価からのものです。
AGENT_TOOL	会話がエージェント ツールからのものである。エージェント ツールは、テストとデバッグの目的で永続化される別のセッションでエージェントを実行します。

InputType

入力メッセージのタイプ。

列挙型
INPUT_TYPE_UNSPECIFIED	入力タイプが指定されていません。
INPUT_TYPE_TEXT	テキスト入力。
INPUT_TYPE_EVENT	イベント入力。
INPUT_TYPE_AUDIO	音声入力。
INPUT_TYPE_IMAGE	画像入力。
INPUT_TYPE_BLOB	Blob 入力。
INPUT_TYPE_TOOL_RESPONSE	クライアント関数ツールのレスポンス入力。
INPUT_TYPE_VARIABLES	変数の入力。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントはこれらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値のヒントが次のように定義されます。

• readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
• destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
• idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に影響はありません。デフォルトは false です。
• openWorldHint: true の場合、ツールは外部エンティティの「オープンワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌