新增SuperAgent MCP入站诊断链路

This commit is contained in:
andy committed 2026-07-22 21:10:49 +07:00
1 parent 76d253afc4
commit 5712f03d4f
21 files changed
+1163 -14

No files matched your search

@@ -0,0 +1,28 @@
-- SuperAgent MCP 入站诊断:用于联调排查原始 tools/call 参数、adapter 后 payload 和安全错误摘要。
CREATE TABLE platform_superagent_mcp_call_diagnostic (
id BIGINT NOT NULL COMMENT 'MCP 调用诊断 ID',
jsonrpc_id VARCHAR(128) NULL COMMENT 'JSON-RPC request id 的安全文本表示',
method_name VARCHAR(128) NULL COMMENT 'JSON-RPC method,例如 tools/call',
tool_name VARCHAR(128) NULL COMMENT 'MCP tool 名称,例如 th_hotel_submit_task_results',
mcp_client_id VARCHAR(64) NOT NULL COMMENT 'MCP 调用方机器身份,第一版固定 superagent-mcp',
request_body_bytes INT NOT NULL COMMENT '原始请求体 UTF-8 字节数',
request_body_sha256 CHAR(64) NOT NULL COMMENT '原始请求体 SHA-256,用于不暴露正文时定位同一次请求',
raw_body_json LONGTEXT NULL COMMENT '原始 MCP JSON-RPC 请求体,受控诊断字段,不进入普通接口或日志',
arguments_json LONGTEXT NULL COMMENT 'params.arguments 原始 JSON,受控诊断字段',
adapted_payload_json LONGTEXT NULL COMMENT 'submit adapter 转换后送入业务入站层的 JSON;非 submit 或转换失败为空',
mapping_diagnostics_json LONGTEXT NULL COMMENT 'submit adapter 事件索引映射诊断 JSON',
response_summary_json LONGTEXT NULL COMMENT 'MCP 响应安全摘要,不保存完整查询工具响应或邮件正文',
call_status VARCHAR(32) NOT NULL COMMENT '调用状态:RECEIVED、SUCCEEDED、FAILED',
safe_error_code VARCHAR(128) NULL COMMENT '安全错误码,例如 SOURCE_MESSAGE_NOT_FOUND',
safe_error_summary VARCHAR(512) NULL COMMENT '安全错误摘要,不包含正文、HTML、附件 URL 或 Secret',
source_message_external_id VARCHAR(256) NULL COMMENT '从 submit 入参中尽力提取的外部来源消息 ID',
hotel_id VARCHAR(64) NULL COMMENT '后端解析出的酒店 ID;解析失败或不适用时为空',
created_at DATETIME(6) NOT NULL COMMENT '记录创建 UTC 时间',
updated_at DATETIME(6) NOT NULL COMMENT '记录更新 UTC 时间',
PRIMARY KEY (id),
KEY idx_mcp_diagnostic_created (created_at, id),
KEY idx_mcp_diagnostic_status_created (call_status, created_at),
KEY idx_mcp_diagnostic_tool_created (tool_name, created_at),
KEY idx_mcp_diagnostic_source_message (source_message_external_id, created_at)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin
COMMENT='SuperAgent MCP 入站诊断表,受控记录原始工具参数、adapter 后 payload 和安全错误摘要';