扣子基于动态Prompt模板的精准输出控制开发指南-人工智能-PHP中文网

必须启用动态system prompt并绑定变量与schema：第一步勾选「启用自定义system prompt」；第二步用{{}}注入已定义变量；第三步通过插件输出映射绑定字段；第四步用`json schema强制格式；第五步在debug中验证替换结果。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

扣子基于动态prompt模板的精准输出控制开发指南

要在扣子（Coze）平台实现动态Prompt模板驱动的精准输出控制，必须绕过静态提示词的硬编码限制，让模型每次响应前都能根据实时输入自动重组指令结构、注入上下文变量、校验格式边界。这要求你直接操作Bot的System Prompt层与插件参数绑定逻辑，而非仅依赖对话框编辑器。

第一步：在Bot设置中启用动态System Prompt

进入Bot编辑页→点击右上角「设置」→切换到「高级设置」标签页→勾选「启用自定义System Prompt」。这一步不可跳过，【未启用该开关时，所有后续变量注入均无效】。默认关闭状态会强制使用平台预设角色模板，覆盖你写的任何动态逻辑。

勾选后，下方「System Prompt」文本框才变为可编辑状态。此时输入基础角色锚点，例如：“你是一个严格遵循JSON Schema输出的API代理，所有响应必须是合法JSON，无额外说明文字。”

第二步：用{{}}语法注入运行时变量

在System Prompt或任意Message节点中，插入双花括号包裹的变量名，如{{user_name}}、{{order_id}}、{{current_time}}。这些变量必须已在Bot工作流中被定义——要么来自用户消息解析（如正则提取），要么来自插件返回字段（如数据库查询结果），要么来自全局变量配置。

注意：变量名区分大小写，且不能含空格或特殊符号。写成{{user name}}或{{User_Name}}会导致注入失败，模型原样输出花括号内容。

示例有效写法：
“请基于订单{{order_id}}的物流状态生成回复，收件人姓名为{{recipient}}，当前时间为{{current_time}}。”

第三步：绑定插件输出到Prompt变量

添加一个「数据库查询」插件→配置SQL语句（如SELECT status, estimated_delivery FROM orders WHERE id = '{{order_id}}'）→在插件设置底部找到「输出映射」区域→将查询结果字段status映射为变量{{order_status}}，estimated_delivery映射为{{eta}}。

扣子Coze CLI工具

与 Coze CLI (@coze/cli) 交互——创建/部署 Coze 项目、管理空间和组织、向项目发送消息、生成图像/音频/视频等功能

下载

这一步完成后，后续任何含{{order_status}}的位置都会被真实数据库值替换。如果查询无结果，该变量为空字符串，可能导致Prompt逻辑断裂——【务必在调用插件前加条件判断节点，拦截空值】。

第四步：用三重反引号+JSON Schema约束输出结构

在System Prompt末尾追加一段明确的格式指令：

```json
{"type": "object", "properties": {"reply": {"type": "string"}, "confidence": {"type": "number", "minimum": 0, "maximum": 1}}, "required": ["reply", "confidence"]}
```

这段代码不是示例，而是直接告诉模型：你的输出必须是JSON对象，且必须包含reply和confidence两个字段，confidence必须是0~1之间的数字。模型会主动校验自身输出是否符合此Schema，不符合则重试——这是扣子v3.2+版本新增的底层能力，旧版不支持。