调测网关 - DebugCoreGateway

agentarts:gateway:debugCoreGateway

Write

gateway *

g:ResourceTag/<tag-key>

-

agentIdentity::getAuthorizerConfiguration

gateway_id

是

String

参数解释：

网关的唯一标识符。

网关ID获取方式：

1. 进入AgentArts平台，在左侧导航栏选择“开发中心 > 组件库 ”，选择“网关”页签。

2. 在网关列表中“网关名称/ID”处复制网关ID即可。

约束范围：

不涉及。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

默认取值：

不涉及。

Mcp-Session-Id

否

String

参数解释

会话ID，用于标识MCP服务器与客户端之间逻辑相关的交互会话，它主要用于支持需要维护状态化会话的服务器场景。

约束限制：

客户端在后续同一会话的所有HTTP请求头中携带此Mcp-Session-Id。

取值范围：

必须仅包含可见ASCII字符（十六进制范围0x21至0x7E）。

默认取值：

不涉及。

jsonrpc

是

String

参数解释：

JSON-RPC 协议版本标识。

约束范围：

不涉及。

取值范围：

• 2.0: JSON-RPC协议2.0版本。

默认取值：

不涉及。

id

是

One of:

• String

• Integer

参数解释：

JSON-RPC 请求的唯一标识 ID，用于匹配对应的响应，遵守 MCP 协议格式。

约束范围：

同一会话中，未完成请求的 ID 必须唯一。

取值范围：

• 字符串类型。

• 整数类型（通常为正整数）。

默认取值：

不涉及。

method

是

String

参数解释：

调测方法，用于指定客户端执行的调测操作类型。

约束范围：

不涉及。

取值范围：

• initialize: 初始化，客户端在首次连接时发送给服务器，要求其开始初始化流程。

• tools/list: 获取工具列表，用于请求服务器拥有的工具列表。

• tools/call: 调用工具，用于调用服务器提供的工具。

默认取值：

不涉及。

params

否

One of:

• CoreGatewayInitializeParams object

• CoreGatewayToolsListParams object

• CoreGatewayToolsCallParams object

参数解释：

调测方法对应的参数信息，不同method对应不同类型的参数结构体，遵守MCP协议格式。

约束范围：

不涉及。

取值范围：

• initialize: 对应 CoreGatewayInitializeParams，初始化参数，包含协议版本、客户端能力和客户端信息。

• tools/list: 对应 CoreGatewayToolsListParams，工具列表查询参数，可选包含分页光标。

• tools/call: 对应 CoreGatewayToolsCallParams，工具调用参数，包含工具名称和调用参数。

默认取值：

不涉及。

authorizer_configuration

否

DebugCoreGatewayAuthorizationConfiguration object

参数解释：

授权配置信息，用于传递认证凭据。

约束范围：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

protocolVersion

是

String

参数解释：

客户端支持的MCP版本，当前支持2024-11-05、2025-03-26、2025-06-18版本。

约束范围：

格式必须符合 YYYY-MM-DD 日期格式。

取值范围：

不涉及。

默认取值：

不涉及。

capabilities

是

CoreGatewayClientCapabilities object

参数解释：

客户端能力声明，用于与服务器进行能力协商。

约束范围：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

clientInfo

是

CoreGatewayClientInfo object

参数解释：

客户端信息。

约束范围：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

elicitation

否

Map<String,Object>

参数解释：

客户端支持从服务器获取信息。

约束范围：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

experimental

否

Map<String,Map<String,Object>>

参数解释：

客户端支持的实验性、非标准功能。

约束范围：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

roots

否

CoreGatewayRootsCapability object

参数解释：

Roots能力，表示客户端支持向服务器提供文件系统根目录信息。

约束范围：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

sampling

否

map<string, object>

参数解释：

采样能力，表示客户端支持处理来自服务器的LLM采样请求。

约束范围：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

listChanged

否

Boolean

参数解释：

客户端是否会在根目录列表变更时发出通知。

约束范围：

不涉及。

取值范围：

true: 支持变更通知; false: 不支持。

默认取值：

false

name

是

String

参数解释：

客户端名称。

约束范围：

不涉及。

取值范围：

长度为1-64个字符。

默认取值：

不涉及。

version

是

String

参数解释：

客户端版本。

约束范围：

不涉及。

取值范围：

长度为1-32个字符。

默认取值：

不涉及。

title

否

String

参数解释：

面向UI展示的可读标题，2025-06-18版本新增参数。

约束范围：

不涉及。

取值范围：

长度为0-256个字符。

默认取值：

不涉及。

cursor

否

String

参数解释：

分页光标，用于获取下一页工具列表。

约束范围：

不涉及。

取值范围：

长度为0-256。

默认取值：

不涉及。

_meta

否

CoreGatewayRequestMeta object

参数解释：

请求元数据信息，键值对形式。

取值范围：

不涉及。

name

是

String

参数解释：

调用工具名称。

约束范围：

不涉及。

取值范围：

长度为1-256个字符。

默认取值：

不涉及。

arguments

否

Map<String,Object>

参数解释：

自定义参数，键值对形式，遵守MCP协议格式。

约束范围：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

_meta

否

CoreGatewayRequestMeta object

参数解释：

请求元数据信息，键值对形式。

取值范围：

不涉及。

{自定义key}

否

Map<String,Object>

参数解释：

请求元数据信息，键值对形式。

取值范围：

不涉及。

progressToken

否

One of:

• String

• Integer

参数解释：

进度令牌，用于将进度通知与原始请求关联起来。

取值范围：

字符串或整数。

access_token

否

String

参数解释：

当入站认证为自定义JWT认证时，该参数可填。

约束范围：

不涉及。

取值范围：

长度为0-65535。

默认取值：

不涉及。

status

Integer

参数解释：

HTTP请求状态码，表示服务器对请求的处理结果。

约束范围：

遵循 RFC 9110 HTTP 语义规范，按类别划分：

• 1xx（信息响应）：请求已接收，继续处理

• 2xx（成功响应）：请求成功接收并处理

• 3xx（重定向响应）：需要进一步操作完成请求

• 4xx（客户端错误）：请求包含错误语法或无法满足

• 5xx（服务端错误）：服务器未能完成有效请求

取值范围：

100 - 599（标准 HTTP 状态码范围）。

默认取值：

不涉及。

result

CoreGatewayJSONRPCResponse object

参数解释：

调用网关的响应结果。

约束范围：

按响应字段划分为以下三种模式：

• 标准HTTP错误模式：必须包含 code、message字段，通过 code 和 message 字段返回 HTTP 状态码（400-599）及错误信息。

• JSON-RPC响应模式：必须包含 jsonrpc、id、result字段，通过 result 字段返回响应成功时的业务结果。

• JSON-RPC错误模式：必须包含 jsonrpc、id、error字段，通过 error 字段返回 JSON-RPC 标准错误对象（符合 JSON-RPC 2.0 协议）。

取值范围：

不涉及。

默认取值：

不涉及。

jsonrpc

String

参数解释：

JSON-RPC 协议版本标识。

约束范围：

不涉及。

取值范围：

• 2.0: JSON-RPC协议2.0版本。

默认取值：

不涉及。

id

One of:

• String

• Integer

参数解释：

JSON-RPC 请求的唯一标识 ID，用于匹配对应的响应，遵守 MCP 协议格式。

约束范围：

同一会话中，未完成请求的 ID 必须唯一。

取值范围：

• 字符串类型。

• 整数类型（通常为正整数）。

默认取值：

不涉及。

result

One of:

• CoreGatewayInitializeResult object

• CoreGatewayToolsListResult object

• CoreGatewayToolsCallResult object

参数解释：

调用网关返回的响应结果，根据请求方法不同返回对应类型的结果。

约束范围：

根据请求方法对应的响应结果如下：

• initialize: 对应 CoreGatewayInitializeResult，初始化响应结果。

• tools/list: 对应 CoreGatewayToolsListResult，工具列表响应结果。

• tools/call: 对应 CoreGatewayToolsCallResult，工具调用响应结果。

取值范围：

不涉及（由具体 Schema 定义）。

默认取值：

不涉及。

error

CoreGatewayJSONRPCError object

参数解释：

错误详情，包含错误代码、消息和附加数据。

约束范围：

必须包含 code 和 message 字段。

取值范围：

包含标准错误码和自定义错误码的对象。

默认取值：

不涉及。

code

Integer

参数解释:

HTTP响应异常错误码。

取值范围:

400-599

message

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

_meta

map<string, object>

参数解释：

响应结果元数据信息，键值对形式。

取值范围：

不涉及。

protocolVersion

String

参数解释：

服务器确定的MCP协议版本。

取值范围：

格式必须符合 YYYY-MM-DD 日期格式。

capabilities

CoreGatewayServerCapabilities object

参数解释：

服务器能力详情。

取值范围：

不涉及。

serverInfo

CoreGatewayServerInfo object

参数解释：

服务器信息。

取值范围：

不涉及。

instructions

String

参数解释：

可选的说明文本，用于指导 AI 如何使用服务器。

取值范围：

长度 0-4096。

tools

CoreGatewayToolsCapabilities object

参数解释：

服务器工具能力定义。

取值范围：

不涉及。

prompts

CoreGatewayPromptsCapabilities object

参数解释：

服务器提示词能力定义。

取值范围：

不涉及。

resources

CoreGatewayResourcesCapabilities object

参数解释：

服务器资源能力定义。

取值范围：

不涉及。

logging

map<string, object>

参数解释：

服务器日志能力定义。

取值范围：

不涉及。

experimental

map<string, object>

参数解释：

服务器实验性扩展能力定义。

取值范围：

不涉及。

completions

map<string, object>

参数解释：

服务器参数自动补全能力定义。

取值范围：

不涉及。

listChanged

Boolean

参数解释：

是否支持工具列表变更通知。

取值范围：

true或者false。

listChanged

Boolean

参数解释：

是否支持提示词列表变更通知。

取值范围：

true或者false。

subscribe

Boolean

参数解释：

是否支持资源订阅。

取值范围：

true或者false。

listChanged

Boolean

参数解释：

是否支持资源列表变更通知。

取值范围：

true或者false。

name

String

参数解释：

服务器名称。

取值范围：

长度 1-128。

version

String

参数解释：

服务器版本。

取值范围：

长度 1-32。

title

String

参数解释：

面向UI展示的可读标题，2025-06-18版本新增参数。

约束范围：

不涉及。

取值范围：

长度为0-256个字符。

默认取值：

不涉及。

_meta

map<string, object>

参数解释：

响应结果元数据信息，键值对形式。

取值范围：

不涉及。

tools

Array of CoreGatewayTool objects

参数解释：

工具集合，遵守MCP协议格式。

取值范围：

不涉及。

nextCursor

String

参数解释：

分页光标，用于获取下一页工具列表。

取值范围：

长度为0-256。

_meta

map<string, object>

参数解释：

响应结果元数据信息，键值对形式。

取值范围：

不涉及。

name

String

参数解释：

工具名称。

取值范围：

长度为1-256个字符。

title

String

参数解释：

工具的人类可读标题（用于UI显示），2025-06-18版本新增参数。

取值范围：

长度为0-256。

description

String

参数解释：

工具解释。

取值范围：

长度为0-1024个字符。

annotations

CoreGatewayToolAnnotations object

参数解释：

向客户端描述工具的附加属性。

取值范围：

不涉及。

inputSchema

inputSchema object

参数解释：

一个 JSON Schema 对象，用于定义工具所需的参数。

取值范围：

不涉及。

outputSchema

outputSchema object

参数解释：

一个可选的 JSON Schema 对象，用于定义工具输出的结构，2025-06-18版本新增参数。

取值范围：

不涉及。

destructiveHint

Boolean

参数解释：

破坏性更新提示，如果为 true，表示该工具可能对其环境执行破坏性更新。默认值：true。

取值范围：

true或false。

idempotentHint

Boolean

参数解释：

幂等性提示，如果为 true，表示使用相同参数重复调用该工具不会产生额外效果。默认值：false。

取值范围：

true或false。

openWorldHint

Boolean

参数解释：

开放世界提示，如果为 true，表示该工具可能与外部实体的“开放世界”进行交互。默认值：true。

取值范围：

true或false。

readOnlyHint

Boolean

参数解释：

只读提示，如果为 true，表示该工具不会修改其环境。默认值：false。

取值范围：

true或false。

title

String

参数解释：

工具的人类可读标题，2025-06-18 前主要使用 annotations.title 表示 UI 标题。

取值范围：

长度为0-256。

type

String

参数解释：

JSON Schema 类型标识，必须为 "object"，表示参数是一个键值对对象。

取值范围：

仅允许 object。

properties

Map<String,Map<String,Object>>

参数解释：

定义工具参数的JSON Schema属性声明。

取值范围：

不涉及。

required

Array of strings

参数解释：

必填参数列表，列出在 properties 中定义且必须提供的参数名。

type

String

参数解释：

JSON Schema 类型标识，必须为 "object"，表示输出是一个键值对对象。

取值范围：

仅允许 object。

properties

Map<String,Map<String,Object>>

参数解释：

定义工具输出的JSON Schema属性声明。

取值范围：

不涉及。

required

Array of strings

参数解释：

必填输出参数列表，列出在 properties 中定义且必须提供的参数名。

取值范围：

不涉及。

_meta

map<string, object>

参数解释：

响应结果元数据信息，键值对形式。

取值范围：

不涉及。

content

Array of objects

参数解释：

工具调用的响应结果，遵守MCP协议格式。

取值范围：

不涉及。

isError

Boolean

参数解释：

工具调用是否为错误响应。

取值范围：

true或false。

structuredContent

Map<String,Object>

参数解释：

一个可选的 JSON 对象，表示工具调用的结构化结果，应与 Tool.outputSchema 对齐，2025-06-18版本新增参数。

取值范围：

不涉及。

code

Integer

参数解释：

错误类型代码，标识发生的错误类别。

约束范围：

预定义错误码范围为 -32768 至 -32000，自定义错误码应使用正数或 -32000 以上的负数。

取值范围：

• -32700: 解析错误(Parse error)。

• -32600: 无效请求(Invalid Request)。

• -32601: 方法未找到(Method not found)。

• -32602: 无效参数(Invalid params)。

• -32603: 内部错误(Internal error)。

默认取值：

不涉及。

message

String

参数解释：

错误的简短描述，提供人类可读的错误信息。

约束范围：

不涉及。

取值范围：

不超过2048位字符。

默认取值：

不涉及。

data

Object

参数解释：

关于错误的附加信息，用于携带更详细的错误上下文。

约束范围：

不涉及。

取值范围：

任意 JSON 类型（字符串、数字、对象、数组等）。

默认取值：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

取值为固定18个字符，匹配以 AgentArts. 开头、后接恰好8位数字的字符串，符合正则条件^AgentArts.[0-9]{8}$。

error_msg

String

参数解释：

错误消息。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释：

错误原因。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释：

错误处理建议。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_code

String

参数解释：

错误码。

取值范围：

取值为固定18个字符，匹配以 AgentArts. 开头、后接恰好8位数字的字符串，符合正则条件^AgentArts.[0-9]{8}$。

error_msg

String

参数解释：

错误消息。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息，可通过统一身份认证服务IAM的解密鉴权失败的原因接口解码获取详细授权失败原因。

取值范围：

取值为 1-4096 个字符。

details

Array of CoreGatewayCommonError objects

参数解释：

依赖的下游服务错误信息列表。

取值范围：

数组长度为 0-10。

error_code

String

参数解释：

错误码。

取值范围：

取值为固定18个字符，匹配以 AgentArts. 开头、后接恰好8位数字的字符串，符合正则条件^AgentArts.[0-9]{8}$。

error_msg

String

参数解释：

错误消息。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释：

错误原因。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释：

错误处理建议。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_code

String

参数解释：

错误码。

取值范围：

取值为固定18个字符，匹配以 AgentArts. 开头、后接恰好8位数字的字符串，符合正则条件^AgentArts.[0-9]{8}$。

error_msg

String

参数解释：

错误消息。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_reason

String

参数解释：

错误原因。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

error_suggestion

String

参数解释：

错误处理建议。

取值范围：

取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()''"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

200

网关调测成功

400

无效的请求体

403

权限不足，拒绝访问

500

内部服务器错误