feat: prepare ARR for controlled public deployment

This commit is contained in:
Wyndham ARR
2026-07-29 16:38:05 +08:00
commit a701de9f0e
271 changed files with 48472 additions and 0 deletions

View File

@@ -0,0 +1,40 @@
# ARR数据处理Agent Profile v3 手工配置
## 1. 应用设置
1. “系统提示词”:粘贴 `prompts/arr_opera_daily_main_agent_prompt.md` 的全部内容。
2. 展开“高级设置”。
3. 在“输出 Schema”区域点击“导入 JSON Schema”粘贴
`prompts/arr_opera_daily_profile_output.schema.json` 的全部内容并应用。
4. 确认输出 Schema 共 7 个必填字段,并且:
- `processor_result` 类型为 `object`
- `files` 类型为 `object`
- `business_date` 类型为 `string`
5. 打开“启用外部 API”。
6. 点击“保存草稿”。
不要把 `prompts/arr_opera_daily_agent_result.schema.json` 导入 Profile 编辑器。该文件是
ARR runtime 使用的完整嵌套校验契约SuperAgent 当前导入器不会解析其中的 `$ref`,会错误地把
`processor_result` 降成 `string`
## 2. 发布
1. 进入“应用发布”。
2. 先运行平台检查。
3. 检查通过后发布生产版本;预期版本号为 `v3`
4. 发布后确认“开放 API”已开启且页面显示 endpoint。
5.`Ops > Agent Profile Open API` 中把本 Profile 绑定到现有外部应用。
不要把 OSS、Agent API 或 HMAC 密钥粘贴进提示词、Schema 或调试消息。
## 3. 临时 ARR 回调入口
联调期间的受限 HTTPS 回调地址:
`https://arr.example.com/api/integrations/super-agent/results`
该地址只在本地 ARR 与临时隧道继续运行时有效,并且只允许上述路径的 `POST`。它不应粘贴进
Profile 提示词或输出 Schema应由 SuperAgent 的受信 runtime adapter / 后置回写工具使用。
当前平台 Profile UI 没有原生 post-run hook。发布 v3 和绑定 Open API 可以打通程序调用,
但在安装/配置 runtime 回写 adapter 之前,仍不能把一次 Agent 成功运行视为“已回写 ARR”。