feat: prepare ARR for controlled public deployment
This commit is contained in:
40
SUPERAGENT_PROFILE_V3_MANUAL_CONFIG.md
Normal file
40
SUPERAGENT_PROFILE_V3_MANUAL_CONFIG.md
Normal 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”。
|
||||
Reference in New Issue
Block a user