实现 Debug EML 上传到 SuperAgent 链路

This commit is contained in:
andy
2026-07-09 14:22:24 +08:00
parent 9fa608f602
commit fcb30d460a
50 changed files with 3527 additions and 1 deletions

View File

@@ -0,0 +1,31 @@
-- M004 Debug EML 上传链路记录单次上传、SourceMessage 捕获和 SuperAgent Open API 调用结果。
CREATE TABLE platform_debug_eml_superagent_run (
id BIGINT NOT NULL COMMENT 'Debug EML 运行 ID',
hotel_id VARCHAR(64) NOT NULL COMMENT '酒店或业务上下文 ID',
run_label VARCHAR(128) NULL COMMENT '前端传入的调试标签,仅用于联调筛选和排查',
source_message_id BIGINT NULL COMMENT '关联的内部 SourceMessage Inbox ID写入成功后回填',
external_message_id VARCHAR(256) NULL COMMENT 'Debug 链路生成或解析出的外部邮件 ID',
external_conversation_id VARCHAR(256) NULL COMMENT 'Debug 链路生成或解析出的外部邮件会话 ID',
original_file_name VARCHAR(512) NULL COMMENT '原始上传 .eml 文件名的安全清洗结果',
original_eml_oss_url VARCHAR(2048) NULL COMMENT '原始 .eml 文件在阿里云 OSS 上的访问 URL',
original_eml_sha256 CHAR(64) NULL COMMENT '原始 .eml 文件 SHA-256用于排查重复和内容追溯',
payload_json LONGTEXT NULL COMMENT '发送给 SuperAgent 的 AgentBus-like 邮件 payload JSON不包含 Secret',
superagent_session_id VARCHAR(128) NULL COMMENT 'SuperAgent Open API session ID',
superagent_run_id VARCHAR(128) NULL COMMENT 'SuperAgent 返回的 run ID',
superagent_profile_id VARCHAR(128) NULL COMMENT 'SuperAgent 实际使用的 profile ID',
superagent_profile_version_id VARCHAR(128) NULL COMMENT 'SuperAgent 实际使用的 profile version ID',
superagent_model_name VARCHAR(128) NULL COMMENT 'SuperAgent 响应元数据中的模型名称',
superagent_raw_answer LONGTEXT NULL COMMENT 'SuperAgent 最终 AI 文本回答,用于 Debug 展示和排查',
superagent_parsed_json LONGTEXT NULL COMMENT '后端从最终回答中解析出的 JSON无法解析时为空',
superagent_input_tokens INT NULL COMMENT 'SuperAgent 输入 token 数,供应商返回时保存',
superagent_output_tokens INT NULL COMMENT 'SuperAgent 输出 token 数,供应商返回时保存',
superagent_total_tokens INT NULL COMMENT 'SuperAgent 总 token 数,供应商返回时保存',
run_status VARCHAR(32) NOT NULL COMMENT 'Debug 运行状态CREATED、SOURCE_CAPTURED、SUPERAGENT_SUCCEEDED、SUPERAGENT_FAILED、FAILED',
safe_error_summary VARCHAR(512) NULL COMMENT '安全错误摘要不包含正文、HTML、Secret 或附件签名 URL',
created_at DATETIME(6) NOT NULL COMMENT '记录创建时间,按 UTC 写入',
updated_at DATETIME(6) NOT NULL COMMENT '记录更新时间,按 UTC 写入',
PRIMARY KEY (id),
KEY idx_debug_eml_hotel_time (hotel_id, created_at),
KEY idx_debug_eml_source_message (source_message_id),
KEY idx_debug_eml_status_time (run_status, created_at)
) COMMENT='Debug EML 上传到 SuperAgent 调试运行表记录来源捕获、OSS 转存和 AI 调用结果';