如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

编写提示词

了解如何创建提示词。

使用提示词就是向模型提供输入。模型的输出质量往往取决于您如何编写提示词。

概览

编写提示词既是艺术,也是科学。OpenAI 提供的策略和相应的 API 设计可以帮助您编写有效的提示词,让模型持续给出高质量的结果。我们鼓励您多尝试。

提示词工具与技巧

  • 提示词缓存:复用内容稳定的提示词前缀,在缓存命中时降低延迟和输入 Token 费用。
  • 提示词工程:了解编写提示词的策略、技巧和工具。

优化提示词

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

在应用中管理提示词

像管理应用代码一样管理提示词。将提示词内容存放在有明确名称的模块中,使用带类型的函数参数构建动态部分,并在同一个 Pull Request 中审查提示词变更及其对应的产品行为变更。

OpenAI 正在逐步弃用 API 中的可复用提示词对象。自 2026 年 6 月 3 日起,OpenAI 将逐步减少对创建提示词对象这一功能的推广,并计划于 2026 年 11 月 30 日停用 v1/prompts。有关最新时间安排,请参阅弃用公告页面。

开展新的开发工作时,请勿创建可复用提示词对象。请采用以下做法:

  • 将生产环境中的每个提示词存放在辅助模块中,例如 prompts/supportReply.ts,并随代码一起进行版本管理。
  • 用带类型的函数参数或经过验证的输入对象替换提示词变量。
  • 调用 Responses API 时,通过 input 和 instructions 直接传入生成的消息。
  • 为提示词变更编写测试,准备有代表性的测试数据,并设置评估检查,在部署流程中运行这些测试和检查。
  • 使用 Git 历史记录、PR 审查、发布标签和功能开关来审查、发布、比较和回滚提示词变更。

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

后续步骤

当您对自己编写的提示词有信心后,可以进一步了解以下指南和资源。

文本生成

了解如何使用提示词引导模型生成文本。

编写更有效的提示词

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