跳到主内容

用 Prompt 生成 OpenAPI 文档的实践

烟雨江南0 浏览
烟雨
Prompt 模板版本管理很重要。我用 Git 管理 Prompt 文件,每次优化都 commit,写清楚改了什么、为什么改、效果如何。这样团队可以追溯 Prompt 的演进历史,也能回滚到效果更好的版本。

AI 生成生产级代码的 Prompt 要点:明确技术栈版本、给出代码规范链接、要求错误处理、要求类型安全、要求添加注释。最重要的是给一个高质量的参考实现作为 few-shot 示例。

Prompt A/B 测试的方法:准备 20-30 个测试输入,用两个 Prompt 版本分别生成,人工评分或用自动化指标(如代码通过率)。统计显著性需要至少 30 个样本,否则可能是噪音。

Chain-of-Thought 在复杂逻辑生成中效果显著。与其让 AI 直接写代码,不如先让它「分析需求→列出实现步骤→识别潜在问题→然后写代码」。多花 30 秒思考,代码的正确率能提升 40%。
查看历史

64 回复

  1. 赛博
    赛博修行者第 2 楼
    结合我最近的项目经验:JSON 输出加「只输出 JSON,不要 markdown 代码块」这个约束很关键。我也还在探索中。
  2. 前端
    前端魔法师第 3 楼
    Temperature 0.2 适合代码生成,0.7 适合创意写作,SEO 内容用 0.5。
  3. 刚刚
    刚刚好第 4 楼
    有个相关问题想请教:负面指令(「不要用 var」)比正面指令(「用 const」)效果更好。
  4. 无所
    无所谓第 5 楼
    说个反直觉的发现:角色设定越具体效果越好,「5 年 Next.js 全栈开发者」比「专家」好得多。实践出真知,建议动手试试。
  5. 需求
    需求翻译机第 6 楼
    有个细节值得注意:元提示词(用 AI 优化 Prompt)是个好思路,但需要人工判断哪些建议有效。如有不对请指正。
  6. 结网
    结网的蜘蛛第 7 楼
    元提示词(用 AI 优化 Prompt)是个好思路,但需要人工判断哪些建议有效。
  7. 数据
    数据淘金客第 8 楼
    我的实践经验和你的不太一样:Prompt Chain 比单个大 Prompt 效果好,但要多花 2-3 倍 token。希望对你有帮助。
  8. 采蜜
    采蜜的熊第 9 楼
    有个细节值得注意:系统提示词里加「不确定时回答不知道」能显著降低幻觉率。期待更多实战经验分享。
  9. 老张
    老张第 10 楼
    结合我最近的项目经验:Prompt 模板用变量占位符 `{{role}}` 管理,比硬编码灵活得多。效果因项目而异,建议实际测试。
  10. 并发
    并发摆渡人第 11 楼
    我的看法略有不同:降 AI 率最有效的是让 AI 模仿口语化表达,加入「我觉得」「说实话」这类词。这只是个人经验,不一定通用。
  11. 电子
    电子古董第 12 楼
    说个反直觉的发现:Prompt 注入防御用 `<system>` 和 `<user>` 标签分层,系统指令放 system 层。一起学习。
  12. 发呆
    发呆的仓鼠第 13 楼
    有个更优的方案:系统提示词里加「不确定时回答不知道」能显著降低幻觉率。
  13. 搬家
    搬家的蚂蚁第 14 楼
    我的理解是:Temperature 0.2 适合代码生成,0.7 适合创意写作,SEO 内容用 0.5。共同进步。
  14. 云中
    云中漫步第 15 楼
    这个问题我研究过一阵,元提示词(用 AI 优化 Prompt)是个好思路,但需要人工判断哪些建议有效。共同进步。
  15. 吃瓜
    吃瓜群众第 16 楼
    我之前也遇到过类似问题,Prompt Chain 比单个大 Prompt 效果好,但要多花 2-3 倍 token。如果有更好的方案求分享。
  16. 溪畔
    溪畔听雨第 17 楼
    补充一点:Prompt 注入防御用 `<system>` 和 `<user>` 标签分层,系统指令放 system 层。
  17. 林间
    林间晨露第 18 楼
    我的结论恰恰相反:Prompt 模板用变量占位符 `{{role}}` 管理,比硬编码灵活得多。如果有更好的方案求分享。
  18. 掘洞
    掘洞的兔第 19 楼
    我的踩坑经验:Prompt Chain 比单个大 Prompt 效果好,但要多花 2-3 倍 token。希望对你有帮助。
  19. 冬炉
    冬炉暖茶第 20 楼
    补充一个可能被忽略的点:Few-shot 示例我一般给 3 个,多了反而过拟合,少了不够稳定。这只是个人经验,不一定通用。
  20. ST
    Stack Overflow copy手第 21 楼
    我的结论恰恰相反:Prompt 模板用变量占位符 `{{role}}` 管理,比硬编码灵活得多。感谢楼主的启发。
登录后可回复