跳到主要内容
阅读约 5 分钟

创建任务

需求来源、仓库选择、流程模式与模型冻结的完整操作说明,包括自动填充行为和预检失败的排查顺序。

创建表单只收集必需的输入

创建任务最多使用两到三个主步骤,默认表单只收集需求来源、任务名称、仓库与基线分支。显式选择已有流程时才追加该流程的动态输入。

模型、知识、能力与编排细节都不是普通用户的必填配置。这是刻意的:理解全部领域模型不应成为开始使用的门槛。

需求来源

来源支持多行,可以共同组成同一份需求。

每一行使用统一的两段式交互。第一段的选择器只负责切换该行类型,不会在选择来源时触发文件选择器或其他副作用。第二段只展开当前行的输入面板。

Markdown 面板先显示文件上传空态,读取后收敛为文件名、大小、字符数与替换或移除操作。正文作为冻结载荷保存,不默认展开为可编辑大文本。

在线来源(Git 议题、企业文档、企业即时消息)面板只显示一个带来源语义的链接输入和清除动作。

重复选择当前来源会保留已有输入;只有切换该行类型才清空该行原有数据。新增、删除或调整其他来源行不会串改本行内容。

来源可见性由当前部署决定,不使用静态夹具猜测公司工具栈。Markdown 与 Git 议题是控制面始终返回的内建来源;企业文档与企业即时消息由部署配置显式启用,并通过可用性接口暴露给界面。

需要注意的是:可用性契约只证明入口已启用。在外部正文拉取连接器尚未交付前,任务上下文仍冻结来源地址和平台生成的元数据,不冒充已经下载了正文。

任务名称

名称以可编辑默认值减少重复输入。它按来源行顺序选择第一个可用标题:

  • Markdown 提取首个不在代码围栏内的一级标题,缺失时使用文件名;
  • Git 议题通过当前用户已授权的连接器读取真实标题,失败时保留占位符并继续创建流程。

自动值只在名称尚未人工编辑时随来源替换或异步结果更新。用户输入非空名称后,后续来源变化不得覆盖。 从原任务重建或浏览器草稿恢复出的非空名称一律视为人工确认值。

名称只承担资源识别和列表标题的作用。任务上下文中的任务要求才是 Agent 的执行目标。

仓库与分支

创建页不允许自由输入仓库地址。控制面的顺序是:

  1. 把当前用户配置了个人令牌的 Git 服务作为可选服务;
  2. 使用服务端解密的当前令牌实时查询可访问的仓库;
  3. 选中仓库后查询分支,并优先建议提供方返回的默认分支。

切换 Git 服务或仓库会清空下游选择。远端拒绝令牌、网络失败和空目录分别提供可恢复状态。

这个顺序的意义在于:令牌问题在执行之前就暴露。 如果令牌无效或没有仓库权限,任务在预检阶段失败,而不是在执行到一半时失败。

议题标题同样只能由服务端使用当前用户凭据读取,并校验链接与已配置连接器的地址与路径契约一致。浏览器不得直连提供方接口。接口只返回连接器标识、提供方、仓库全名、克隆与网页地址、默认分支、私有标识、分支名称与保护标识,以及议题的仓库、编号、标题、网页地址与状态。访问令牌、密文和密钥引用均不得跨出控制面。

流程模式

智能编排是默认模式。用户提交任务后由预检检索、评估并优先复用已有发布版本,无法适配时生成任务专属的临时流程。

这条路径的实际顺序是:先分析任务目标、已提供需求、约束、交付物与验收条件;再按任务需求检索当前用户可见的已发布流程,对候选读取精确版本的完整契约并比较输入、输出、节点、依赖与能力;有满足任务的流程时优先复用精确版本,没有合适的才生成新流程。

目录读取或工具调用失败不代表没有合适的流程。系统不得掩盖故障后伪称完成匹配。

使用已有流程由用户以紧凑选择器选择当前工作范围可见的已发布版本。选择后只展开该版本输入契约中不可推导的动态字段。

创建流程进入独立创作页面,不把长期资产编辑塞进任务表单。

模型与能力

创建页不提供任务级模型选择。模型在每个节点的能力定义中固定,任务创建时冻结精确版本。

知识访问由控制面按任务主体、组织与工作范围签发最小委托,并强制注入系统知识召回技能。用户不需要在创建任务时选择或理解知识。

预检失败的排查顺序

预检失败时任务保留结构化检查结果。按以下顺序排查通常最快:

  1. 个人令牌:是否配置、是否过期、是否对该仓库有权限;
  2. 仓库与分支:分支是否仍然存在,默认分支是否被保护规则限制;
  3. 能力可见性:所选流程声明的技能或扩展在你当前工作范围是否可用;
  4. 模型网关:网关是否可达,所选模型是否已上架;
  5. 流程契约:如果使用已有流程,其输入契约中的必填字段是否已填。

失败时不会创建任何运行资源,因此修复后重新提交不会留下需要清理的残留。