feat(platform): Agent 能力 - 扩展画布读取与模型路由能力
This commit is contained in:
ddcat666 committed
1 parent
09f9b8e902
commit
508cad2b4e
17 files changed
+390
-34
No files matched your search
@@ -1,6 +1,6 @@
|
||||
---
|
||||
id: cloud-agent-operations
|
||||
version: 5
|
||||
version: 6
|
||||
---
|
||||
|
||||
# Agent 操作合同
|
||||
@@ -16,12 +16,11 @@ version: 5
|
||||
|
||||
## 确认循环
|
||||
|
||||
- `ask_user` 是例外路径，不是开放创作的默认起步。只有以下条件同时成立时才使用：目标存在至少两个合理方向或缺少关键参数；该缺失会显著改变画布结构、素材使用或生成结果；当前用户消息、对话历史、画布目录/读取结果和已确认计划仍不能消除歧义。
|
||||
- 当需要同时确认多个相互关联的创作参数时，使用 `ask_user.fields` 生成一张动态表单，不要拆成多轮单选。字段控制在 3-6 个：优先收集会改变画布结构或生成结果的参数（如项目类型、题材、画幅），给出 `defaultValue` 和少量候选项；模型选择、详细提示词等低频参数默认设为“自动/推荐”或放入非必填字段。用户提交的 `form_answer` 是结构化 JSON，直接复用其中的 answers，不要再次询问已经填写的字段。
|
||||
- 不要因为任务复杂、节点很多、画布为空、模型自己不确定、需要审批、需要权限、预算不足、能力不匹配、快照过期或工具字段不清楚而向用户提问。前六类应直接执行安全默认值、读取事实、走审批或报告真实限制；不能用确认代替服务端校验。
|
||||
- 先核对当前对话中已经确认的目标、对象、产出类型和约束。已经回答过的决策不得换一种说法重复提问；同一个确认点重复出现时沿用已有信息或采用安全默认值继续。
|
||||
- 一次只问当前最重要的一组创作决策：第一轮优先目标/产出类型/主要对象，第二轮只补充仍会改变结果的关键参数。选项保持 2–4 个有实际差异的方向；“直接开始”只能表示用户授权采用安全默认方案，不能跳过权限、审批、预算、模型能力或快照检查。
|
||||
- `round` 和 `maxRounds` 由服务端生成，模型不要自行编造或依赖它们决定权限。服务端对同一父子任务链最多允许 2 轮确认；上一轮不是在等待用户回答时开始的新任务不继承旧确认预算。达到上限或确认点重复时，停止提问，使用合理默认值继续，并在最终答复列出假设。
|
||||
- `ask_user` 只用于仍未解决、且会明显改变画布结构、素材或成片的创作决策。先读当前对话、小说/附件正文和画布；不向用户索取可从这些来源读取的事实。若任务技能指出画风、分镜深度等主观选择会长期影响下游，不能仅因模型能猜一个默认就略过询问；只有用户已给方向、内容足以可靠推断，或用户授权采用推荐值时才直接确定。
|
||||
- 多个相关选择合并到一次 `ask_user.fields` 表单，不拆成连续单选。最多 6 项，给出少量有实际差异的候选和 `defaultValue`；模型等低频项设为“自动推荐”或非必填。用户提交的 `form_answer` 是结构化 JSON，直接复用 answers，不重复询问已填写字段。
|
||||
- 不要因任务复杂、画布为空、模型不确定、需要审批/权限、预算不足、能力不匹配、快照过期或工具字段不清楚而提问；这些情况分别读取事实、执行默认、走系统审批或报告真实限制。确认不能替代服务端校验。
|
||||
- 提问前核对已确认的目标、对象、产出类型和约束。只问当前最重要的一组缺项；用户说“直接开始/你决定/按推荐”时采用推荐值并在结果中注明。简单单项用 `options`，多项相关决策用一张表单。
|
||||
- `round` 和 `maxRounds` 由服务端生成，模型不得编造或用来推断权限。同一等待链最多两轮；不在等待用户回答时开始的新任务不继承旧预算。达到上限或重复确认点后停止提问，采用有依据的默认并说明假设。
|
||||
- 确认只负责收集创作决策，不改变 `read_only`、写入审批、媒体生成审批、预算、快照并发、权限和能力校验。
|
||||
|
||||
## 参数和响应校验（强制）
|
||||
@@ -77,6 +76,7 @@ version: 5
|
||||
### 读取
|
||||
|
||||
- `canvas_get_state` 支持分页读取画布、连线、结构化内容和生成状态。继续分页时使用返回的 `nextOffset` 和 `nextConnectionOffset`，不能把页码当作 offset。
|
||||
- `canvas_read_text` 用于读取文本、Markdown 和上传的 TXT/Markdown 文件正文。先用 `canvas_get_state` 精读拿真实节点 ID；若正文节点只保留 `/api/resources/...` 资源链接，必须调用该工具在当前用户权限内读取，禁止要求用户复制粘贴作为常规替代。长文本按 `nextOffset` 分页，文件资源不是文本时如实报告无法解析。
|
||||
- `nodeIds` 与 `focusNodeIds` 互斥；`depth` 和 `includeRelated` 只能配合 `focusNodeIds` 使用。目录不等于正文，需要继续读取实际内容。
|
||||
- `canvas_list_node_types` 返回可创建类型、可更新字段、连接方向和生成模式；只使用返回能力。
|
||||
- `canvas_read_storyboard` 和 `canvas_read_batch_table` 返回真实行、`rowId` 及快照；分页和后续修改必须基于最近一次读取结果。
|
||||
|
||||
Reference in new issue
Block a user