模板配置与编写
按输入、处理步骤和输出设计模板,再检查版本变化的影响。
模板定义的主要组成
| 部分 | 设计时回答的问题 |
|---|---|
| 基本信息 | 模板叫什么,解决什么问题 |
| 输入 | 使用者要提供什么 |
| 步骤与依赖 | 怎样处理,先后顺序是什么 |
| 能力与模型 | 由什么能力执行 |
| 可见输出 | 最终交给使用者什么 |
| 工作簿说明 | 怎样填写,样例是什么 |
先用业务语言明确这些内容,再让 Agent 生成配置。
设计输入
| 要确定的内容 | 会议纪要示例 |
|---|---|
| 一行代表什么 | 一份会议纪要 |
| 必填项 | 会议正文 |
| 可选项 | 补充背景 |
| 输入方式 | 粘贴文本,或提供支持的文件 |
| 填写示例 | 一条可理解、格式正确的输入 |
有允许值时,列出实际选项。文件输入应连接兼容端口,不能把文件标识当普通文本使用。
设计步骤、依赖与汇总
串行步骤使用前一步结果。并行步骤独立处理同一资料,再按需要汇总。
此图是设计示例。检查每一步从哪里取输入、下一步用什么结果,以及依赖失败时怎样处理。
选择能力和模型,连接输入
先确定输入与输出形态,再查询当前能力。把模板输入或上一步输出连接到返回的兼容端口。
默认模型、是否允许使用者选模型、文件素材要求应一起检查。不同步骤可以选择不同的模型或能力,但每一步的输入输出必须匹配当前平台返回的契约;是否允许用户换模型也需要明确配置。两种绑定方式见 模型与编写能力说明。
定义可见输出和失败处理
说明最终结果、需要展示的中间结果和错误信息。并行步骤部分失败时,明确是否还允许汇总,以及怎样标出缺失内容。
这些行为需要在模板配置和测试中验证,不是所有模板都自动采用相同规则。
校验修改并检查兼容性
修改后重新校验,确认保存新版本,再用原样本复测。输入结构变化后重新下载工作簿。
当前服务保存新版本会更新私有模板的最新版本,以及默认指向的可运行版本;先确认影响,再保存并核对。市场 SkillApp 的发布快照不会自动被替换,具体发布影响见 模板与 Listing 权限说明。
技术附录:当前 v2 字段
当前 v2 定义包含 meta、可选 templateInputs、steps 和 workbook。提交时声明 specVersion=template-spec/v2,定义放在 canonicalSpecV2 中。输出按步骤契约和可见输出规则组织。
inputBindings 连接模板输入、上一步输出或固定值;dependsOn 表达步骤依赖。精确字段和约束以当前 TemplateSpec 文档为准。
测试见 试运行与调试私有模板,校验错误见 常见校验错误。