76 lines
4.5 KiB
Markdown
76 lines
4.5 KiB
Markdown
---
|
||
name: xdfx-split-controller
|
||
description: xdfx 深链接单智能体拆分版总控技能，按顺序调度 step1-step6 技能完成分析与入库。
|
||
---
|
||
|
||
# xdfx 拆分版总控 Skill
|
||
|
||
总控也必须优先运行内置 Python 执行器，不要让模型手写接口流程。执行器位于：
|
||
|
||
```text
|
||
scripts/xdfx_flow.py
|
||
```
|
||
|
||
## 输入文件
|
||
|
||
准备 `xdfx-input.json`：
|
||
|
||
```json
|
||
{
|
||
"api_base": "https://ch1.b.uat.4.cn",
|
||
"taskId": "真实任务id",
|
||
"actionId": "真实xdfx行动id",
|
||
"mubiao": "传播...叙事，驱动...行为体产生...预期行为，实现...作战目的。",
|
||
"direction": "U方向",
|
||
"platform": "fb"
|
||
}
|
||
```
|
||
|
||
## 推荐执行顺序
|
||
|
||
默认会自动处理登录态：当命令没有传 `Authorization`，或某个接口返回 401 时，脚本会用固定账号 `admin`、口令 `ch@user` 调用 `POST /api/v1/auth/login/username?password=ch%40user`，请求体为 `{"username":"admin"}`。拿到 `access_token` 后写入 `Authorization: Bearer ...` 并重试原接口一次。默认关闭 HTTPS 证书校验以兼容 UAT/内网自签证书；如果环境证书链正常，可以追加 `--verify-ssl`。如果已有可用 token，可追加 `--auth-token TOKEN` 或 `--header "Authorization: Bearer TOKEN"`。
|
||
|
||
总控按顺序执行下面 6 条命令，所有步骤共用同一个 `xdfx-flow-state.json`：
|
||
|
||
```bash
|
||
python scripts/xdfx_flow.py --mode step1 --input xdfx-input.json --state xdfx-flow-state.json --summary xdfx-flow-summary.md
|
||
python scripts/xdfx_flow.py --mode step2 --input xdfx-input.json --state xdfx-flow-state.json --summary xdfx-flow-summary.md
|
||
python scripts/xdfx_flow.py --mode step3 --input xdfx-input.json --state xdfx-flow-state.json --summary xdfx-flow-summary.md
|
||
python scripts/xdfx_flow.py --mode step4 --input xdfx-input.json --state xdfx-flow-state.json --summary xdfx-flow-summary.md
|
||
python scripts/xdfx_flow.py --mode step5 --input xdfx-input.json --state xdfx-flow-state.json --summary xdfx-flow-summary.md
|
||
python scripts/xdfx_flow.py --mode step6 --input xdfx-input.json --state xdfx-flow-state.json --summary xdfx-flow-summary.md
|
||
```
|
||
|
||
每条命令结束都会输出一行 `STEP_FEEDBACK {...}`。总控必须在每个 step 命令结束后立即反馈用户，再继续下一步。
|
||
|
||
每次接口调用前会输出 `OP_FEEDBACK {...}`。总控必须告诉用户当前正在做什么、调用哪个接口。
|
||
|
||
如果接口或模型处理报错，会立即输出 `ERROR_FEEDBACK {...}`。总控必须立刻把失败阶段、URL、状态码、请求摘要和响应摘要告诉用户。
|
||
|
||
如果模型返回文本经过自动修复仍无法解析，会输出 `JSON_PARSE_REVIEW {...}`。总控必须查看响应片段，判断是否需要重跑当前 step 或重新调用对应接口。
|
||
|
||
如果只想一条命令跑完，也可以使用下面命令做无人值守兜底，但不建议作为默认方式，因为外层工具通常会等命令结束后才返回输出，无法保证用户看到实时反馈：
|
||
|
||
```bash
|
||
python scripts/xdfx_flow.py --mode full --input xdfx-input.json --state xdfx-flow-state.json --summary xdfx-flow-summary.md
|
||
```
|
||
|
||
## 断点续跑
|
||
|
||
- Step1 成功后会写入 `topAudiences`。
|
||
- Step2 成功后会写入 `topPathways`。
|
||
- Step3/Step4 会写入两类脆弱点。
|
||
- Step5/Step6 会写入两类策略。
|
||
- 各步骤会同步前端 `task/task-action.step`；需要禁用时每条命令追加 `--no-step-status`。
|
||
- 策略步骤会同步写入 channel、narrate、message、策略与受众/传播节点关系表，保证原前端策略表格/编排页可继续读取。
|
||
- 每个步骤完成都会输出 `STEP_FEEDBACK`，总控必须逐步转述给用户。
|
||
- 每次操作和接口调用都会输出 `OP_FEEDBACK`，总控必须逐条转述当前操作。
|
||
- 每次错误都会输出 `ERROR_FEEDBACK`，总控必须立即报告错误细节。
|
||
- 每次 JSON 彻底解析失败都会输出 `JSON_PARSE_REVIEW`，总控必须复核响应片段并判断是否重试当前 step。
|
||
- 每个步骤里的流式模型接口第一次空响应、返回 `y模型没有响应`/`模型没有响应` 或超时类字符串时，会自动再调用一次；仍失败才写入 `errors`。
|
||
- 某一步失败后，修正问题再重跑同一个 `--mode stepN`。
|
||
|
||
## 汇报规则
|
||
|
||
执行过程中按 `OP_FEEDBACK` 告诉用户当前操作和接口；按 `ERROR_FEEDBACK` 立即报告错误；每个 step 结束后再根据 `STEP_FEEDBACK` 回复用户一次。全部步骤结束后，读取 `xdfx-flow-summary.md` 和 `xdfx-flow-state.json.errors` 再做最终汇总。只要存在错误，就明确说“部分完成”，并列出失败阶段、接口 URL、状态码和响应摘要。
|