Appearance
提示词资源
提示词资源用于把已经验证的人设、任务目标、执行步骤、能力边界和输出格式沉淀到工作空间中，供智能体配置、提示词对比调试和其他获得授权的场景复用。它适合保存相对稳定、需要多人维护或反复验证的系统提示词，不适合存放密钥、真实个人信息、一次性聊天内容或未经审核的模型输出。
提示词在资源库中通过弹窗创建和编辑，当前没有独立详情页。提示词保存后会直接成为当前工作空间中的可引用资源；页面没有单独的“发布版本”或“版本历史”入口，因此修改共享提示词前需要先确认引用方并保留必要的旧稿。
本栏目导航
入口与资源边界
- 页面入口：资源 > 低代码 > 提示词。
- 页面地址：
/workbench/resource-library?type=prompt。 - 归属范围：提示词归属于当前工作空间，切换工作空间后列表、可选智能体和复制目标都会随之变化。
- 列表能力：按名称搜索，按创建者和资源范围筛选；点击名称直接进入编辑，更多菜单提供跨空间复制、编辑和删除等操作。
- 使用边界：提示词只描述模型如何完成任务，不会自动授予插件、数据库、知识库或外部服务权限。
图中各区域的用途如下：
- 提示词页签：只查看当前工作空间的提示词资源。
- 筛选条件：按创建者和资源范围缩小列表。
- 资源行：点击名称打开编辑弹窗；更多菜单用于复制、编辑或删除。
- 资源菜单：选择“提示词”开始创建。
创建提示词
在资源库右上角点击 资源 > 提示词，打开创建弹窗。
创建时需要完成以下内容：
名称
- 必填，最多 20 个字符。
- 使用“角色 + 任务”或“业务 + 用途”命名，例如“合同风险审查员”“客服工单分类”。
- 不要使用“测试”“新版”“最终版”等无法说明用途的名称。
提示词正文
正文必填。建议至少包含：
- 角色与目标：模型是什么角色，要解决什么问题。
- 输入说明：调用方会提供什么信息，哪些字段可能为空。
- 执行步骤：按什么顺序分析、查询或生成。
- 能力边界：什么可以做，什么必须拒绝或转人工。
- 事实约束：无证据时如何表达，是否允许推断。
- 输出格式：语言、长度、结构、JSON 字段或 Markdown 层级。
- 异常处理：信息不足、工具失败或结果冲突时如何返回。
创建弹窗当前不提供描述字段。保存后重新打开编辑弹窗，可以补充最多 50 个字符的简短描述。描述应说明资源用途和适用范围，不要复制整段提示词。
保存方式
- 确认：保存提示词并返回资源列表。
- 确认并对比调试：先保存，再选择当前工作空间中的智能体进入对比调试。
- 取消：关闭弹窗且不创建资源。
“确认并对比调试”不是临时预览，它会先创建或更新提示词。只想检查文字时，应先在编辑区完成审阅，再决定是否保存。
编辑提示词
点击列表中的提示词名称，或从行操作选择“编辑”，打开编辑弹窗。
编辑器包含四个主要区域：
- 名称和描述：名称最多 20 个字符，描述最多 50 个字符。
- 正文编辑区：普通文本与编辑块可以混合编排。
- 正文工具：插入编辑块，或使用 AI 自动优化。
- 保存操作：直接保存，或保存后进入智能体对比调试。
推荐使用清晰的 Markdown 标题拆分长提示词，例如 ## 人设、## 任务、## 限制 和 ## 回复格式。标题是普通文本结构，不会自动产生权限、变量或工作流节点。
编辑块
编辑块用于把提示词中的某一小段标记为可替换内容。适合把角色名称、业务范围、语气、输出模板或某条规则做成可单独调整的区块。
插入与配置
- 把光标放到需要插入的位置，或先选中要转换为编辑块的正文。
- 点击 编辑块。
- 点击正文中的蓝色编辑块，维护“空白引导”和“预设文本”。
字段含义：
| 字段 | 作用 | 建议 |
|---|---|---|
| 空白引导 | 编辑块没有内容时，提示维护者应该填写什么 | 使用动作化说明，例如“填写目标行业”或“填写输出字段” |
| 预设文本 | 编辑块默认携带的正文 | 提供安全、可直接运行的默认值 |
当前编辑器中，空白引导最多 40 个字符，预设文本最多 120 个字符。
编辑块不是运行时变量
编辑块保存的是提示词正文中的可替换片段，不等同于工作流中的 {{变量名}} 表达式，也不会在运行时自动读取用户输入。需要动态注入数据时，应在智能体配置或工作流大模型节点中建立明确的变量映射，并检查最终送入模型的完整提示词。
修改某个编辑块的预设文本会同步改变正文长度和后续区块位置。大幅改写后应逐个点击编辑块，确认范围和内容没有错位。
AI 自动优化
正文非空时，点击 优化 打开自动优化面板。
使用流程
- 先编写一份能够独立表达目标的原始提示词。
- 输入本次优化要求，例如“补充信息不足时的处理规则”“改成严格 JSON 输出”“减少重复说明”。
- 发送优化请求，等待系统生成候选结果。
- 对照原文检查事实、权限边界、变量、输出格式和拒绝条件。
- 确认后选择替换原文；不满意时重新生成或暂不替换。
优化要求最多 200 个字符。AI 返回的内容只是候选，不会因为生成成功就自动替换当前正文。已有结果尚未替换时关闭面板，系统会提示是否放弃结果。
替换前检查
- 是否改变了原有业务目标或角色身份。
- 是否虚构了插件、接口、知识库或数据库能力。
- 是否删除了权限校验、人工确认或拒绝规则。
- 是否把示例值误写成固定值。
- 是否改变 JSON 字段、枚举值或调用方依赖的格式。
- 是否把敏感信息、内部地址或凭据写进提示词。
使用优化结果替换原文后，应重新检查编辑块。当前编辑器会以优化后的普通文本替换正文，已有编辑块可能需要重新建立。
智能体对比调试
点击 确认并对比调试 后，系统按以下顺序处理：
- 校验并保存当前提示词。
- 打开“选择智能体用于对比调试”弹窗。
- 在当前工作空间中搜索并选择一个智能体。
- 进入智能体编辑器，把资源提示词作为“对比提示词”加载。
- 使用相同测试输入比较“默认提示词”和“对比提示词”的回答。
- 选择保留默认提示词，或把对比提示词应用到智能体草稿。
对比调试区域支持分别选择默认提示词和对比提示词，并使用当前可用的文本模型进行预览。测试时应保持模型、输入、附件和其他配置一致，否则无法判断差异是否来自提示词。
推荐测试集
至少准备以下样例：
| 类型 | 目的 |
|---|---|
| 标准输入 | 验证主要任务和输出格式 |
| 信息不足 | 验证追问、缺省值或拒绝策略 |
| 边界输入 | 验证长度、空值、异常字符和极端条件 |
| 越权请求 | 验证权限边界和安全拒绝 |
| 冲突信息 | 验证事实冲突和证据优先级 |
| 真实脱敏案例 | 验证提示词在业务语境中的稳定性 |
不要只比较“读起来更顺”。还要记录格式通过率、事实错误、工具调用正确率、拒绝准确性、平均响应长度和人工复核结论。
在智能体和工作流中使用
智能体
提示词资源可以用于建立或对比智能体人设。应用资源提示词前，需要检查智能体实际拥有的插件、知识库、变量和渠道能力。提示词中写了“调用搜索工具”不代表智能体已经获得该工具。
工作流
工作流大模型节点可以维护系统提示词、用户提示词和输入变量。需要复用资源提示词时，应确认：
- 资源正文被放在系统提示词还是用户提示词位置。
- 动态变量是否由上游节点真实提供。
- JSON、Markdown 或其他结构化输出是否与下游节点契约一致。
- 节点异常处理是否覆盖模型拒绝、格式错误和超时。
编辑块负责维护资源模板中的可替换片段；工作流变量负责运行时传值，两者不要混为一谈。
生命周期与变更管理
提示词资源当前没有独立的草稿、发布版本和回滚历史。保存编辑会更新当前资源。对于已经被多个智能体或流程引用的提示词，建议采用以下方式控制风险：
- 修改前记录当前正文、资源名称、引用方和测试基线。
- 重大改动优先复制资源并使用新名称，保留旧资源作为回退点。
- 在测试智能体中完成对比调试，再逐步替换生产引用。
- 记录变更原因、负责人、测试集和生效时间。
- 确认没有引用后再删除旧资源。
跨空间复制会生成目标空间中的独立资源，后续修改不会自动双向同步。复制后需要重新验证目标空间的模型、工具、知识和权限。
安全与质量要求
- 不要把 API Key、Token、账号密码或私网地址写入提示词。
- 不要直接保存包含真实身份证、手机号、病历、合同原文等敏感信息的示例。
- 明确模型不能执行的操作，并为高风险动作增加人工确认或审批。
- 要求模型区分事实、推断和未知；无证据时不要编造。
- 结构化输出要给出字段定义、类型、必填规则和失败返回。
- 长提示词优先删除重复规则，避免互相矛盾的优先级。
- 上线前使用脱敏真实样本验证，不以单次回答作为通过依据。
常见问题
为什么点击优化没有反应？
先确认正文不为空。优化针对现有提示词生成候选，空白正文不会启动优化。
为什么优化后编辑块不见了？
“替换原文”会用优化结果重建正文。优化文本是普通文本，原有编辑块可能需要重新插入和配置。
为什么提示词写了变量，运行时仍显示原样？
资源编辑块不是运行时变量。请在实际使用提示词的智能体或工作流节点中配置变量来源和映射，并检查最终拼装结果。
为什么选择对比调试后跳到了智能体？
对比调试依赖智能体的模型和预览会话。系统会先保存资源，再让你选择智能体，并在智能体编辑器中并排比较默认提示词和资源提示词。
为什么看不到版本历史？
提示词资源当前没有独立版本历史入口。重大修改应先复制资源、保留旧稿，并通过对比调试验证后再切换引用。
为什么保存后回答仍没有变化？
检查调用方是否实际引用了该资源，智能体草稿是否应用了对比提示词，以及工作流或应用是否仍使用旧的内嵌提示词。保存资源本身不会自动覆盖所有调用方配置。
删除提示词后能恢复吗？
页面没有明确恢复入口时，应把删除视为不可直接撤销。删除前先确认引用关系，并保留副本或受控备份。