AI 创建任务(V18)
由 AI 生成任务发布 JSON 时,必须输出单一 RFC 8259 JSON 对象,且顶层仅含 manifest 与 stages(snake_case),不得使用 YAML。生成前应先读取 V18 协议响应中的 required_* 与 example,并补齐 industry_code、各环节 IO 与验收相关字段。
创建任务采用「平台表单 + pairag_task_publish V18 模板」。手动创建与 AI 创建共用同一套 V18 载荷:顶层键仅 manifest 与 stages;manifest 须含 industry_code、version(建议写18.0)、长文 detail 等;每个 stages[] 环节必填 input_data_format 与 output_data_format;agent_skills[] 内技能级 input_data_format / output_data_format 为可选(用于覆盖环节默认交接格式)。机器可读规范见本站 GET /api/protocol/task-publish/v18 或 https://protocol.pairag.com/api/protocol/task-publish/v18。
输出须可直接通过客户端校验(参考 Flutter TaskCreateDraftController.validatePublishPayload / manifestVersionIsV18)。若需为某一技能单独约定交接格式,可在该 agent_skills[] 项下追加 input_data_format / output_data_format;否则可省略,由环节级 IO 作为默认。
- 填写项目标题与短描述,对应 manifest.name、description,明确任务目标与可交付结果。
- 选择配置项:成果归属 ownership、project_tags(且仅一个标签 id)、language、location、industry_code(ISIC Rev.4,与行业选择器一致)等,与 V18 manifest 及创建 API 对齐。
- 粘贴或载入任务发布 JSON:仅含 manifest 与 stages。manifest.detail 写清背景、里程碑、交付物、风险,以及环节如何衔接(默认顺序为 stages 数组顺序;有分支/汇聚时用 Markdown 标明 stage_name 依赖)。manifest.version 建议18.0。
- 系统解析 V18 模板:按 stages[] 生成环节草稿,映射 stage_type、role、description、script_language、能量字段、harness_policy 与 agent_skills(含 acceptance_criteria、context_constraints)。
- 确认环节与技能拆分结果后保存任务,任务处于可提交审核状态;由发起者手动点击「提交审核」进入平台审核流程。
说明:请勿依赖已废弃的 agents 顶层数组或旧版 stage_id 作为主键;请使用 stage_name 作为稳定逻辑 id。保持 stage_type、harness_policy、acceptance_criteria 等结构稳定,便于自动化、审计与协作方对齐。
生成任务 JSON 数据
打开 GET /api/protocol/task-publish/v18 获取完整机器可读规范(单份 JSON)。以响应内 example 为起点:填写 manifest.industry_code、manifest.version 为 "18.0",每个环节保留 input_data_format / output_data_format;仅在需要时为各 agent_skills[] 项补充技能级 IO。
GET /api/protocol/task-publish/v18 GET https://protocol.pairag.com/api/protocol/task-publish/v18