For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主导航

提示词

了解如何创建提示。

编写提示 是向模型提供输入的过程。输出质量通常取决于您向模型提供的提示是否有效。

概览

编写提示既是一门艺术,也是一门科学。OpenAI 提供了一些策略,并在 API 设计中作出相应安排,帮助您构建有效的提示,让模型持续产出优质结果。我们鼓励您多做尝试。

提示编写工具与技巧

  • 提示缓存:复用稳定的提示前缀,在缓存命中时降低延迟和输入 Token 成本
  • 提示工程:了解构建提示的策略、技巧和工具

完善提示

  • 将整体语气或角色指引放在系统消息中,将具体任务的细节和示例放在用户消息中。
  • 将少样本示例整理成简洁的 YAML 风格文本块或项目符号列表,方便团队快速浏览和更新。
  • 按照项目结构组织提示,并为文件夹使用清晰的名称,让团队成员能快速找到提示。
  • 每次发布时都运行提示测试和评估用例;尽早发现问题的成本低于在生产环境中修复问题的成本。

应用中的提示

像管理应用代码一样管理提示。将提示内容存储在命名模块中,通过带类型的函数参数构建动态部分,并在同一个 Pull Request 中一并审查提示变更及其所支持的产品行为变更。

OpenAI 正在弃用 API 中的可复用提示对象。自 2026 年 6 月 3 日起, 提示创建功能将逐步淡化,v1/prompts 计划于 2026 年 11 月 30 日关闭。请参阅弃用信息 页面,了解当前的 时间安排。

开展新工作时,请勿创建可复用提示对象。请改用以下方式:

  • 将每个生产环境提示保存在以代码管理并纳入版本控制的辅助模块中,例如 prompts/supportReply.ts
  • 用带类型的函数参数或经过验证的输入对象替代提示变量。
  • 通过 inputinstructions 将生成的消息直接传递给 Responses API
  • 为提示变更配备测试、具有代表性的测试数据和评估检查,并在部署流程中运行这些检查。
  • 使用 git 历史记录、PR 审查、发布标签和功能开关来审查、发布、比较和回滚提示变更。

如果您已在 API 请求中使用提示 ID 或提示版本,请按照迁移指南将这些提示迁移到代码中。

后续步骤

当您对自己的提示有信心后,可以进一步查看以下指南和资源。

文本生成

了解如何通过提示让模型生成文本。

设计更好的提示

了解 OpenAI 的提示工程工具和技巧。