MCP Tools Reference: ces.googleapis.com

工具：run_evaluation

为 CES 应用运行评估

以下代码示例展示了如何使用 curl 调用 run_evaluation 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": "run_evaluation",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

McpService.RunEvaluation 的请求消息。

RunEvaluationRequest

JSON 表示法 
{
  "app": string,
  "evaluations": [
    string
  ],
  "evaluationDataset": string,
  "displayName": string,
  "appVersion": string
}
字段
app

string

要为其运行评估的应用的资源名称。格式：projects/{project}/locations/{location}/apps/{app}
evaluations[]

string

要运行的评估 ID 列表。
evaluationDataset

string

用于运行的评估数据集 ID。
displayName

string

评估运行的显示名称。
appVersion

string

用于评估运行的应用版本。

输出架构

此资源表示由网络 API 调用引发的长时间运行的操作。

操作

JSON 表示法 
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
字段
name

string

由服务器分配的名称，该名称仅在最初返回它的那项服务中是唯一的。如果您使用默认 HTTP 映射，则 name 应是以 operations/{unique_id} 结尾的资源名称。
metadata

object

与操作关联的服务专属元数据。它通常包含进度信息和常见元数据（如创建时间）。一些服务可能不会提供此类元数据。任何返回长时间运行的操作的方法都应记录元数据类型（如果有的话）。

此对象可以包含任意类型的字段。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。
done

boolean

如果值为 false，则表示操作仍在进行中。如果为 true，则表示操作已完成，其结果不是 error 就是 response。
联合字段 result。操作结果，可以是 error，也可以是有效的 response。如果 done == false，则既不会设置 error，也不会设置 response。如果 done == true，则只能设置 error 或 response 中的一项。部分服务可能不会提供结果。result 只能是下列其中一项：
error

object (Status)

操作失败或被取消时表示有错误发生的结果。
response

object

操作的常规成功响应。如果原始方法在成功时不返回任何数据（如 Delete），则响应为 google.protobuf.Empty。如果原始方法为标准 Get/Create/Update 方法，则响应应该为资源。对于其他方法，响应类型应为 XxxResponse，其中 Xxx 是原始方法的名称。例如，如果原始方法名称为 TakeSnapshot()，则推断的响应类型为 TakeSnapshotResponse。

此对象可以包含任意类型的字段。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

不限

JSON 表示法 
{
  "typeUrl": string,
  "value": string
}
字段
typeUrl

string

使用 URI 引用（由以斜杠结尾的前缀和完全限定的类型名称组成）标识序列化 Protobuf 消息的类型。

示例：type.googleapis.com/google.protobuf.StringValue

此字符串必须包含至少一个 / 字符，并且最后一个 / 后面的内容必须是规范形式的完全限定类型名称，且不带前导句点。请勿在这些 URI 引用中写入架构，以免客户端尝试与它们联系。

前缀是任意的，Protobuf 实现应仅剥离最后一个 / 之前（包括最后一个 /）的所有内容，以标识类型。type.googleapis.com/ 是某些旧版实现所需的常见默认前缀。此前缀不表示类型的来源，并且包含该前缀的 URI 不应响应任何请求。

所有类型网址字符串都必须是合法的 URI 引用，并且（对于文本格式）引用内容必须仅包含字母数字字符、百分比编码的转义符以及以下集合中的字符（不包括外部反引号）：/-.~_!$&()*+,;=。尽管我们允许百分比编码，但实现不应取消转义，以防止与现有解析器混淆。例如，type.googleapis.com%2FFoo 应被拒绝。

在 Any 的原始设计中，我们考虑了在这些类型网址上启动类型解析服务的可能性，但 Protobuf 从未实现过此类服务，并且认为与这些网址联系存在问题，并且可能存在安全问题。请勿尝试与类型网址联系。
value

string (bytes format)

包含 type_url 所描述类型的 Protobuf 序列化。

使用 base64 编码的字符串。

状态

JSON 表示法 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
字段
code

integer

状态代码，应为 google.rpc.Code 的枚举值。
message

string

面向开发者的错误消息（应采用英语）。任何向用户显示的错误消息都应进行本地化并通过 google.rpc.Status.details 字段发送，或者由客户端进行本地化。
details[]

object

包含错误详细信息的消息列表。有一组通用的消息类型可供 API 使用。

可以包含任意类型字段的对象。附加字段 "@type" 包含用于标示相应类型的 URI。示例：{ "id": 1234, "@type": "types.example.com/standard/id" }。

工具注释

工具注释会发送给 MCP 客户端，以描述给定工具的基本风险。大多数客户端会将这些提示视为不受信任，但它们可用于确定何时向用户发送确认提示。

除了标题字符串之外，以下布尔值提示的定义如下：

  • readOnlyHint：如果为 true，则表示该工具不会修改其环境。默认值：false。
  • destructiveHint：如果为 true，则表示该工具可以执行破坏性操作。如果为 false，则表示该工具只能执行添加操作。默认值：true。
  • idempotentHint：如果为 true，则表示使用相同的参数重复调用该工具不会对其环境产生额外影响。默认值：false。
  • openWorldHint：如果为 true，则表示该工具可以与外部实体的“开放世界”进行交互。如果为 false，则表示该工具只能与内部实体进行交互。例如，网络搜索工具属于开放世界，而内存工具则不属于开放世界。

破坏性提示：❌ | 幂等性提示：❌ | 只读提示：❌ | 开放世界提示：❌