MCP Tools Reference: ces.googleapis.com

ツール: list_agents

指定したアプリ内のエージェントを一覧表示します。

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

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

入力スキーマ

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

ListAgentsRequest

JSON 表現 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
フィールド
parent

string

必須。エージェントを一覧表示するアプリのリソース名。
pageSize

integer

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

string

省略可。前のリスト AgentService.ListAgents 呼び出しから返された next_page_token 値。
filter

string

省略可。エージェントの一覧表示時に適用するフィルタ。詳しくは、https://google.aip.dev/160 をご覧ください。
orderBy

string

省略可。並べ替えの基準となるフィールド。「name」と「create_time」のみがサポートされています。詳しくは、https://google.aip.dev/132#ordering をご覧ください。

出力スキーマ

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

ListAgentsResponse

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

object (Agent)

エージェントのリスト。
nextPageToken

string

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

エージェント

JSON 表現 
{
  "name": string,
  "displayName": string,
  "description": string,
  "modelSettings": {
    object (ModelSettings)
  },
  "instruction": string,
  "tools": [
    string
  ],
  "childAgents": [
    string
  ],
  "beforeAgentCallbacks": [
    {
      object (Callback)
    }
  ],
  "afterAgentCallbacks": [
    {
      object (Callback)
    }
  ],
  "beforeModelCallbacks": [
    {
      object (Callback)
    }
  ],
  "afterModelCallbacks": [
    {
      object (Callback)
    }
  ],
  "beforeToolCallbacks": [
    {
      object (Callback)
    }
  ],
  "afterToolCallbacks": [
    {
      object (Callback)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "guardrails": [
    string
  ],
  "etag": string,
  "toolsets": [
    {
      object (AgentToolset)
    }
  ],
  "generatedSummary": string,
  "transferRules": [
    {
      object (TransferRule)
    }
  ],

  // Union field agent_type can be only one of the following:
  "llmAgent": {
    object (LlmAgent)
  },
  "remoteDialogflowAgent": {
    object (RemoteDialogflowAgent)
  }
  // End of list of possible types for union field agent_type.
}
フィールド
name

string

ID。エージェントの一意の識別子。形式: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
displayName

string

必須。エージェントの表示名。
description

string

省略可。人が読める形式のエージェントの説明。
modelSettings

object (ModelSettings)

省略可。LLM モデルの構成。
instruction

string

省略可。エージェントの動作をガイドする LLM モデルの指示。
tools[]

string

省略可。エージェントで使用可能なツールのリスト。形式: projects/{project}/locations/{location}/apps/{app}/tools/{tool}
childAgents[]

string

省略可。エージェント ツリー内の子エージェントのリスト。形式: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
beforeAgentCallbacks[]

object (Callback)

省略可。エージェントが呼び出される前に実行するコールバック。指定されたコールバックは、リストに指定された順序で順番に実行されます。コールバックがオーバーライドされたレスポンスを返すと、実行が停止し、残りのコールバックはスキップされます。
afterAgentCallbacks[]

object (Callback)

省略可。エージェントの呼び出し後に実行するコールバック。指定されたコールバックは、リストに指定された順序で順番に実行されます。コールバックがオーバーライドされたレスポンスを返すと、実行が停止し、残りのコールバックはスキップされます。
beforeModelCallbacks[]

object (Callback)

省略可。モデルが呼び出される前に実行するコールバック。モデルへの呼び出しが複数ある場合、コールバックは複数回実行されます。指定されたコールバックは、リストに指定された順序で順番に実行されます。コールバックがオーバーライドされたレスポンスを返すと、実行が停止し、残りのコールバックはスキップされます。
afterModelCallbacks[]

object (Callback)

省略可。モデルの呼び出し後に実行するコールバック。モデルへの呼び出しが複数ある場合、コールバックは複数回実行されます。指定されたコールバックは、リストに指定された順序で順番に実行されます。コールバックがオーバーライドされたレスポンスを返すと、実行が停止し、残りのコールバックはスキップされます。
beforeToolCallbacks[]

object (Callback)

省略可。ツールが呼び出される前に実行するコールバック。ツールの呼び出しが複数ある場合、コールバックは複数回実行されます。指定されたコールバックは、リストに指定された順序で順番に実行されます。コールバックがオーバーライドされたレスポンスを返すと、実行が停止し、残りのコールバックはスキップされます。
afterToolCallbacks[]

object (Callback)

省略可。ツールが呼び出された後に実行するコールバック。ツールの呼び出しが複数ある場合、コールバックは複数回実行されます。指定されたコールバックは、リストに指定された順序で順番に実行されます。コールバックがオーバーライドされたレスポンスを返すと、実行が停止し、残りのコールバックはスキップされます。
createTime

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"。
updateTime

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"。
guardrails[]

string

省略可。エージェントのガードレールのリスト。形式: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
etag

string

読み取り、変更、書き込みオペレーション中にオブジェクトが変更されていないことを確認するために使用される ETag。etag が空の場合、更新によって同時変更が上書きされます。
toolsets[]

object (AgentToolset)

省略可。エージェントのツールセットのリスト。
generatedSummary

string

出力専用。エージェントが LLM アシスタントによって生成された場合、このフィールドには生成の説明的な概要が含まれます。
transferRules[]

object (TransferRule)

省略可。エージェントの転送ルール。複数のルールが一致する場合は、リストの最初のルールが使用されます。
共用体フィールド agent_type。エージェントのタイプ。agent_type は次のいずれかになります。
llmAgent

object (LlmAgent)

省略可。デフォルトのエージェント タイプ。
remoteDialogflowAgent

object (RemoteDialogflowAgent)

省略可。エージェントの実行に使用されるリモート Dialogflow エージェント。このフィールドが設定されている場合、他のすべてのエージェント レベルのプロパティは無視されます。

注: Dialogflow エージェントがアプリとは異なるプロジェクトにある場合は、CES サービス エージェント service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com に roles/dialogflow.client を付与する必要があります。

RemoteDialogflowAgent

JSON 表現 
{
  "agent": string,
  "flowId": string,
  "environmentId": string,
  "inputVariableMapping": {
    string: string,
    ...
  },
  "outputVariableMapping": {
    string: string,
    ...
  },
  "respectResponseInterruptionSettings": boolean
}
フィールド
agent

string

必須。Dialogflow エージェントのリソース名。形式: projects/{project}/locations/{location}/agents/{agent}
flowId

string

省略可。Dialogflow エージェントのフローのフロー ID。
environmentId

string

省略可。エージェントの実行に使用する Dialogflow エージェントの環境 ID。指定しない場合は、ドラフト環境が使用されます。
inputVariableMapping

map (key: string, value: string)

省略可。Dialogflow エージェントに入力として送信されるアプリ変数名と Dialogflow セッション パラメータ名のマッピング。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
outputVariableMapping

map (key: string, value: string)

省略可。Dialogflow エージェントの実行終了後に CES エージェントに送り返される Dialogflow セッション パラメータ名とアプリ変数名のマッピング。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
respectResponseInterruptionSettings

boolean

省略可。Dialogflow エージェントで構成されたメッセージ レベルの中断設定を尊重するかどうかを示します。

  • false の場合: Dialogflow エージェントからのすべてのレスポンス メッセージは、アプリレベルの割り込み設定に従います。
  • true の場合: allow_playback_interruption が true に設定されているレスポンス メッセージのみが割り込み可能になり、他のすべてのメッセージはアプリレベルの割り込み設定に従います。

InputVariableMappingEntry

JSON 表現 
{
  "key": string,
  "value": string
}
フィールド
key

string
value

string

OutputVariableMappingEntry

JSON 表現 
{
  "key": string,
  "value": string
}
フィールド
key

string
value

string

ModelSettings

JSON 表現 
{
  "model": string,

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
フィールド
model

string

省略可。エージェントが使用する LLM モデル。設定されていない場合、エージェントは親エージェントからモデルを継承します。

共用体フィールド _temperature。

_temperature は次のいずれかになります。
temperature

number

省略可。設定すると、この温度が LLM モデルに使用されます。温度は、モデルのレスポンスのランダム性を制御します。温度が低いほど、予測しやすい回答が生成されます。温度が高いほど、より創造的なレスポンスが生成されます。

コールバック

JSON 表現 
{
  "description": string,
  "disabled": boolean,
  "proactiveExecutionEnabled": boolean,

  // Union field callback can be only one of the following:
  "pythonCode": string
  // End of list of possible types for union field callback.
}
フィールド
description

string

省略可。コールバックの説明（人が読める形式）。
disabled

boolean

省略可。コールバックが無効かどうか。無効になっているコールバックはエージェントによって無視されます。
proactiveExecutionEnabled

boolean

省略可。有効にすると、中間モデルの出力でもコールバックが実行されます。この設定は、モデル コールバック後にのみ影響します。慎重に有効にしてください。通常、モデル コールバックはすべてのモデル レスポンスを受信した後にのみ実行する必要があります。プロアクティブな実行を有効にすると、実行コストとレイテンシに悪影響を及ぼす可能性があるため、有効にするのはまれな状況のみにしてください。
共用体フィールド callback。実行するコールバック。callback は次のいずれかになります。
pythonCode

string

必須。コールバックで実行する Python コード。

タイムスタンプ

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 にする必要があります（両端を含む）。

AgentToolset

JSON 表現 
{
  "toolset": string,
  "toolIds": [
    string
  ]
}
フィールド
toolset

string

必須。ツールセットのリソース名。形式: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}
toolIds[]

string

省略可。ツールセットをフィルタするツール ID。

TransferRule

JSON 表現 
{
  "childAgent": string,
  "direction": enum (Direction),

  // Union field rule_type can be only one of the following:
  "deterministicTransfer": {
    object (DeterministicTransfer)
  },
  "disablePlannerTransfer": {
    object (DisablePlannerTransfer)
  }
  // End of list of possible types for union field rule_type.
}
フィールド
childAgent

string

必須。ルールが適用される子エージェントのリソース名。形式: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
direction

enum (Direction)

必須。転送の方向。
共用体フィールド rule_type。ルールの種類。rule_type は次のいずれかになります。
deterministicTransfer

object (DeterministicTransfer)

省略可。条件が満たされたときにターゲット エージェントにすぐに転送するルール。
disablePlannerTransfer

object (DisablePlannerTransfer)

省略可。プランナーがターゲット エージェントに転送できないようにするルール。

DeterministicTransfer

JSON 表現 
{

  // Union field condition_type can be only one of the following:
  "expressionCondition": {
    object (ExpressionCondition)
  },
  "pythonCodeCondition": {
    object (PythonCodeCondition)
  }
  // End of list of possible types for union field condition_type.
}
フィールド
共用体フィールド condition_type。評価する条件。condition_type は次のいずれかになります。
expressionCondition

object (ExpressionCondition)

省略可。セッション状態の条件を評価するルール。条件が true と評価されると、転送が行われます。
pythonCodeCondition

object (PythonCodeCondition)

省略可。Python コードブロックを使用して条件を評価するルール。条件が true と評価されると、転送が行われます。

ExpressionCondition

JSON 表現 
{
  "expression": string
}
フィールド
expression

string

必須。cloud.api.Expression 条件の文字列表現。

PythonCodeCondition

JSON 表現 
{
  "pythonCode": string
}
フィールド
pythonCode

string

必須。実行する Python コード。

DisablePlannerTransfer

JSON 表現 
{
  "expressionCondition": {
    object (ExpressionCondition)
  }
}
フィールド
expressionCondition

object (ExpressionCondition)

必須。条件が true と評価されると、プランナーはターゲット エージェントに転送できません。

ツールのアノテーション

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