Skip to main content
Prompt

Prompt模板概述

在构建大语言模型应用时，为不同业务场景反复构建和调整结构相似的 Prompt 耗时且难以维护。通过使用 Prompt 模板，可将 Prompt 的固定结构与动态变量分离，创建可复用的模板，以实现Prompt的统一管理和优化，高效生成Prompt。

工作流程

  1. 创建模板：在阿里云百炼控制台或通过 API 创建并保存模板，获取唯一模板 ID。
  2. 获取模板：通过 API 和模板 ID 拉取模板内容。
  3. 生成 Prompt：将业务数据填入模板变量，生成最终的 Prompt。
  4. 使用模板：将生成好的 Prompt 发送给目标模型以获取结果。

模板类型

Prompt 模板分为预置 Prompt 模板和自定义 Prompt 模板。
维度预置 Prompt 模板自定义 Prompt 模板
来源由阿里云百炼提供，涵盖了多个不同的业务场景。通过控制台或 API 创建自定义模板。
效果已经过优化，效果稳定。用户自己设计和测试，效果取决于设计质量。
易用性无需额外开发，直接通过控制台或 API 调用即可。可能需要多次迭代优化。用户需掌握 Prompt 设计原则及优化方法（如清晰指令、示例引导、格式约束），具备一定的开发和技术能力。
适用场景适用于通用场景，如创意文案、办公助理等。适合对 Prompt 设计经验不足的用户。适用于复杂或特定业务需求的场景，例如金融风控、医疗咨询。对输出格式有严格要求，例如 JSON、列表。
是否支持修改不支持。根据实际需求修改。

预置 Prompt 模板

查看

访问组件广场 > 提示词页面，可查看和使用阿里云百炼提供的针对不同场景的预置 Prompt 模板。 每个 Prompt 模板以卡片形式展示，包含模板内容摘要和模板 ID。卡片底部提供查看详情、复制和更多操作（···）按钮。

查看与管理

  • 查看：单击模板卡片上的查看详情，可在侧边抽屉中查看模板的名称、所属类别、模板内容、包含变量、模板 ID 及接口信息（代码示例）。
  • 复制模板内容：单击复制，可以复制模板内容。
  • 创建应用：单击 ··· > 创建应用，模板内容将自动填充到应用的提示词编辑框中。可直接使用或基于业务场景修改。填充后的提示词中包含自定义变量 ${number} 和 ${content}，用于生成小红书风格文案。
  • 复制到自定义模板：单击 ··· > 复制模板，或在查看详情抽屉中单击复制到自定义模板，会在提示词页面创建一个自定义 Prompt 模板副本。
  • 查看代码示例：在查看详情抽屉的接口信息区域，可查看模板调用的代码示例。此处仅为核心代码示例，不能直接运行。完整的代码示例，请参见 GetPromptTemplate - 获取 Prompt 模板中的 SDK 示例。

自定义 Prompt 模板

创建

您可以通过控制台或 API 两种方式创建自定义 Prompt 模板。 控制台
  • 基于预置 Prompt 模板修改：在预置 Prompt 模板卡片上，单击 ··· > 复制模板，或在查看详情抽屉中单击复制到自定义模板，将会创建一个自定义 Prompt 模板副本。
  • 基于业务需求创建：在组件管理 > 提示词页面，单击右上角 + 创建提示词，完成相关配置后即可创建模板。在 Prompt 模板管理页面，可通过类型筛选（全部、文本生成、图片生成）和搜索框查找已有模板。已创建的模板以卡片形式展示，包含模板标题、内容预览和模板 ID。
API
  • 获取业务空间 ID：参见获取业务空间 ID。
  • 创建自定义 Prompt 模板：使用 CreatePromptTemplate 接口。

查看与管理

  • 查看：自定义 Prompt 模板创建完成后，可在提示词页面查看。
  • 管理：
    • 单击模板卡片上的编辑，可修改模板内容。
    • 单击复制，可以复制模板内容。
    • 单击 ··· > 创建应用，模板内容将自动填充到应用的提示词编辑框中。可直接使用或基于业务场景修改。
    • 单击查看详情，可在侧边抽屉中查看模板调用的代码示例。此处仅为核心代码示例，不能直接运行。完整的代码示例，请参见 GetPromptTemplate - 获取 Prompt 模板中的 SDK 示例。
    • 单击 ··· > 复制模板，会在当前页面创建一个自定义 Prompt 模板副本。
    • 单击 ··· > 删除，可删除已创建的模板。

使用 Prompt 模板

控制台

单击预置 Prompt 模板或自定义 Prompt 模板中的 ··· > 创建应用，模板内容将自动填充到智能体应用的提示词中。 填充后的提示词输入框中可见模板变量（如 ${name}），输入框右下角显示字符计数，最大支持 6144 个字符。 为应用设置模型，输入问题测试提示词效果。在模型调试界面左侧，选择模型（如通义千问-Plus-Latest 128K）并在提示词区域编写系统指令；右侧在用户输入区输入测试问题后单击执行，下方展示模型回复内容及输入/输出 Token 统计信息。

API

  1. 打开接口调用文档，单击调试。
  2. 在界面分别输入 workspaceId 和 promptTemplateId：
    • workspaceId：即业务空间 ID。获取方法参见获取业务空间 ID。
    • promptTemplateId：即预置 Prompt 模板或自定义模板 ID。在模板卡片上获取模板 ID 即可。
  3. 单击发起调用即可在线调试接口。
调用成功示例： 
{
  "variables": ["platform", "topic", "num1", "num2"],
  "promptTemplateId": "cfec40c311f14f3e976403059d8f0116",
  "requestId": "8C616xxx",
  "name": "营销文案生成",
  "content": "你是一名在${platform}平台具有丰富经验的专业爆款营销文案策划人，现在请以\"${topic}\"为核心主题，撰写一段极具吸引力的${platform}营销内容。要求内容包括：一个引人入胜且符合SEO优化原则的标题，以及一段详细且富有情感煽动力的正文。在正文中，请至少插入${num1}不同的emoji表情，以增加内容的互动性和视觉吸引力。此外，请根据该主题，设计并提供最多${num2}热门推荐标签，这些标签需具有高度概括主题和吸引目标用户群体的特点。"
}

SDK

  1. 打开接口调用文档，单击调试。
  2. 在界面分别输入 workspaceId 和 promptTemplateId。配置完成后，workspaceId 和 promptTemplateId 将自动填充至 SDK 示例中。
    • workspaceId：即业务空间 ID。获取方法参见获取业务空间 ID。
    • promptTemplateId：即预置 Prompt 模板或自定义 Prompt 模板 ID。在模板卡片上获取模板 ID 即可。
  3. 在调试界面中单击 SDK 示例。
  4. 在线运行示例，或下载完整工程，设置 accessKeyId 和 accessKeySecret 后运行。获取方法请参见创建 AccessKey。
在 OpenAPI 调试页面右侧，单击 SDK 示例页签，选择 SDK 代系 V2.0（推荐）及目标语言（如 Java），即可查看对应的 SDK 示例代码。

应用于生产环境

缓存模板内容：GetPromptTemplate 的返回结果（即模板内容）在模板未被修改时是固定不变的。建议在您的应用层对模板内容进行缓存，缓存键可以使用 templateId。这可以显著减少不必要的 API 调用，降低延迟和成本。当您更新模板后，需要手动或通过某种机制使缓存失效。

效果示例

预置 Prompt 模板介绍推荐使用场景模板内容生成效果文案
营销标题生成快速生成各流量渠道的吸引眼球的标题文案营销推广你是一名专业的【小红书】爆款标题专家。请你以【杭州亚运会】为主题，以【YYDS、建议收藏、揭秘】为关键词，提供【10】个吸引人眼球的标题。每个标题字数在【20】个字以内。【YYDS】揭秘杭州亚运会幕后故事！
【建议收藏】杭州亚运会精彩瞬间不容错过！
杭州亚运会【YYDS】金牌选手独家采访！
营销文案生成一键生成各流量渠道的高质量推广文案营销推广你是一名专业的【小红书】爆款营销文案专家。请以【智能蓝牙耳机】为主题，创作营销内容。包括标题、正文。并给出热门推荐标签。标题：【智能蓝牙耳机】：你的音乐新伙伴
正文：你是否厌倦了线缆的束缚…
热门推荐标签：#智能蓝牙耳机 #无线音乐 #触控操作
商品推广文案生成快速生成高转化的商品种草文案营销推广、商品推广你是一名经验丰富的商品推荐文案创作者，请为一款【负离子吹风机】写一篇【小红书】风格的推广种草文案。标题：【负离子吹风机】：让你的秀发焕发新生
正文：采用先进的负离子技术…
热门推荐标签：#负离子吹风机 #秀发护理
摘要抽取办公场景中摘要抽取、总结提炼的提效神器办公提效工具、学习工具你是一名专业的文章内容摘要专家，请根据我提供的文章内容生成摘要。字数不超过【200字】。杭州亚运会以"绿色"为办赛理念，其中"无废亚运"是重要内涵……
文案润色根据输入要求润色修改文案办公提效工具、学习工具你是一名专业的文案润色专家，请根据我提供的文案进行润色改写。要【用现代语，有修辞手法】，希望达到【更为简洁、有吸引力】的效果。原文：今天的天气真是好极了…
润色后：今天的天气真是棒极了！…
文案风格改写根据输入要求改写不同风格的文案内容办公提效工具、学习工具你是一名专业的文案风格改写专家，请将我提供的文案用【3种】不同的【小红书】风格改写的更加【积极向上】。风格一：通过改变心态，让每天更有意义。
风格二：改变习惯，让生活更加美好。
风格三：感恩当下，保持积极的态度。
文案续写根据输入要求续写文案、故事等办公提效工具、学习工具你是一位经验丰富的文案续写专家。请根据我提供文案续写一段【科幻故事】，字数不少于【500个】字，要求【故事带清朝穿越情节】。星期天的早上，我来到了火星…发现里面是一个巨大的实验室，里面忙碌着的竟然都是清朝的人…
商品评论根据输入要求生成电商买手级的商品评论文案商品推广你是一名有经验丰富的电商买手。请为【蓝牙筋膜枪】写【3条】好评，要求体现【轻巧便携、性价比高】的特点。1. 这款蓝牙筋膜枪非常轻巧便携…
2. 放在包里或车上都非常方便…
3. 按摩效果好，轻巧便携…

错误码

如果调用失败并返回报错信息，请参见应用调用参考进行解决。

常见问题

调用 GetPromptTemplate 接口和直接在代码中拼接字符串有什么区别？

使用 GetPromptTemplate 接口管理 Prompt 的优势如下：
  • 逻辑与内容分离：可在阿里云百炼控制台更新和优化 Prompt 内容，无需修改或重新部署应用程序代码。
  • 集中管理与协作：所有 Prompt 集中存储，便于团队（如 Prompt 工程师和开发工程师）协作、版本管理和复用。
  • 一致性保障：保证在应用的不同部分或不同服务间使用的 Prompt 版本和结构一致，避免因手动维护导致的不一致问题。
概览
开始使用
应用开发
Prompt
插件
任务中心
组件
应用调用
权限管理
更新日志