MCP Tools Reference: ces.googleapis.com

ツール: list_conversations

会話を一覧表示します。

次のコードサンプルは、curl を使用して list_conversations 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": "list_conversations",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

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

ListConversationsRequest

JSON 表現 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "source": enum (Source),
  "sources": [
    enum (Source)
  ]
}
フィールド
parent

string

必須。会話を一覧表示するアプリのリソース名。
pageSize

integer

省略可。リクエストされたページサイズ。サーバーはリクエストされた数よりも少ない項目を返す場合があります。指定しない場合は、サーバーで適切なデフォルトが選択されます。
pageToken

string

省略可。前の list AgentService.ListConversations 呼び出しから返された next_page_token 値。
filter

string

省略可。会話を一覧表示するときに適用するフィルタ。詳しくは、https://google.aip.dev/160 をご覧ください。
source

enum (Source)

省略可。会話のソースを示します。設定されていない場合は、デフォルトで Source.Live が適用されます。sources フィールドに置き換えられるため、非推奨となります。
sources[]

enum (Source)

省略可。会話のソースを示します。設定しない場合、デフォルトですべての利用可能なソースが適用されます。

ソース

会話のソース。

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

出力スキーマ

AgentService.ListConversations に対するレスポンス メッセージです。

ListConversationsResponse

JSON 表現 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
フィールド
conversations[]

object (Conversation)

会話のリスト。
nextPageToken

string

次のページを取得するために ListConversationsRequest.page_token として送信できるトークン。このフィールドがない場合、後続のページはありません。

会話

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 の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

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