胜算云 胜算云 文档中心 ↗ 精益社区

模板配置与编写

按输入、处理步骤和输出设计模板,再检查版本变化的影响。

模板定义的主要组成

部分 设计时回答的问题
基本信息 模板叫什么,解决什么问题
输入 使用者要提供什么
步骤与依赖 怎样处理,先后顺序是什么
能力与模型 由什么能力执行
可见输出 最终交给使用者什么
工作簿说明 怎样填写,样例是什么

先用业务语言明确这些内容,再让 Agent 生成配置。

设计输入

要确定的内容 会议纪要示例
一行代表什么 一份会议纪要
必填项 会议正文
可选项 补充背景
输入方式 粘贴文本,或提供支持的文件
填写示例 一条可理解、格式正确的输入

有允许值时,列出实际选项。文件输入应连接兼容端口,不能把文件标识当普通文本使用。

设计步骤、依赖与汇总

串行步骤使用前一步结果。并行步骤独立处理同一资料,再按需要汇总。

输入资料提取事实检查遗漏汇总结果

此图是设计示例。检查每一步从哪里取输入、下一步用什么结果,以及依赖失败时怎样处理。

选择能力和模型,连接输入

先确定输入与输出形态,再查询当前能力。把模板输入或上一步输出连接到返回的兼容端口。

默认模型、是否允许使用者选模型、文件素材要求应一起检查。不同步骤可以选择不同的模型或能力,但每一步的输入输出必须匹配当前平台返回的契约;是否允许用户换模型也需要明确配置。两种绑定方式见 模型与编写能力说明。

定义可见输出和失败处理

说明最终结果、需要展示的中间结果和错误信息。并行步骤部分失败时,明确是否还允许汇总,以及怎样标出缺失内容。

这些行为需要在模板配置和测试中验证,不是所有模板都自动采用相同规则。

校验修改并检查兼容性

修改后重新校验,确认保存新版本,再用原样本复测。输入结构变化后重新下载工作簿。

当前服务保存新版本会更新私有模板的最新版本,以及默认指向的可运行版本;先确认影响,再保存并核对。市场 SkillApp 的发布快照不会自动被替换,具体发布影响见 模板与 Listing 权限说明。

技术附录:当前 v2 字段

当前 v2 定义包含 meta、可选 templateInputs、steps 和 workbook。提交时声明 specVersion=template-spec/v2,定义放在 canonicalSpecV2 中。输出按步骤契约和可见输出规则组织。

inputBindings 连接模板输入、上一步输出或固定值;dependsOn 表达步骤依赖。精确字段和约束以当前 TemplateSpec 文档为准。

测试见 试运行与调试私有模板,校验错误见 常见校验错误。