ARR1 历史文档 — ARR 数据处理 Agent v4 + ARR MCP 手工配置

ARR2.0 不使用此配置；默认 Compose 没有 MCP 服务或公网 MCP 入口。

本清单用于公网无 PII 联调。开始前应按 deploy/README.md 部署 ARR Web/MCP，使用长期受控 HTTPS 域名，并把 MCP bearer 放入平台 Secret 管理。

1. 新增 MCP 服务

在 SuperAgent 组织后台进入 MCP 服务管理，点击“新增 MCP 服务”，逐项填写：

字段	值
服务标识	`arr_ingestion_gateway`
显示名称	`ARR 数据结果入库`
传输	`HTTP`
状态	先选 `草稿`
服务地址	`https://mcp.example.com/mcp`（替换为正式 MCP 域名）
描述	`ARR 日报结构化结果受控入库；独立复验源 XML 后事务写入数据库。`
Headers JSON	`{"Authorization":"Bearer <平台 Secret 引用>"}`
OAuth JSON	`{}`
Secret refs JSON	`{}`

Headers JSON 必须是一个完整 JSON object。不要再包一层引号，不要把 bearer 明文粘贴到 Main Prompt、Skill、聊天消息或截图中；优先使用 SuperAgent 的 Secret 引用语法。

点击“保存”。如果平台提供“连接测试”“发现工具”“同步工具”或类似入口，执行一次。成功时只应发现一个工具：

arr_submit_processing_result

如果出现 401，表示 Headers JSON 没有被平台带上；如果出现 404，先核对地址必须以 /mcp 结尾；如果出现连接超时，先不要修改 Agent Prompt，保留错误提示并检查公网 DNS、TLS、Caddy 与 MCP 容器日志。

发现工具成功后，把服务状态改为“启用”或平台对应的可用状态并保存。不要启用任何其他工具。

2. 绑定 ARR数据处理Agent

打开“ARR数据处理Agent”并从当前已发布版本建立新草稿：

在 MCP/工具区域添加 ARR 数据结果入库。
只启用 arr_submit_processing_result。
保留现有 fetch_oss_file 与 arr-opera-daily-ingest Skill。
不添加数据库、OSS SDK、shell 下载器或旧回调工具。

3. 更新 Main Prompt

将“系统提示词/Main Prompt”全部替换为：

prompts/arr_opera_daily_main_agent_prompt.md

该版本要求：一次 OSS 取件、一次确定性处理、处理成功后把完整 structured-result.json 作为 JSON object 调用 arr_submit_processing_result，并且只有收到 committed/already_committed receipt 才视为入库成功。

输出 Schema 继续使用，不需要修改：

prompts/arr_opera_daily_profile_output.schema.json

不要把 program-input Schema 导入 Profile 输出 Schema。它由 ARR 上传后端自动生成。

4. 保存并发布 v4

保存草稿并运行平台检查。
确认 fetch_oss_file、日报 Skill、ARR MCP 三项均可用。
发布为新版本（建议 v4），不要覆盖已发布 v3 的审计记录。
发布后告诉 Codex“已配置并发布”，再由 Codex 使用无 PII XML 做整链验收。

5. 联调后的安全收尾

端到端验收完成后：

若 bearer 曾以明文经过剪贴板或截图，立即轮换 ARR_MCP_BEARER_TOKEN；
确认 bearer 由 SuperAgent Secret 管理，不长期保存在 Headers JSON；
清空系统剪贴板；
保留稳定 HTTPS 域名，并按最小权限继续运行 MCP；
只有完整 XML 竖切通过后，才允许正式业务数据进入页面上传。

3.3 KiB Raw Permalink Blame History Unescape Escape