【笑小枫AI系列】Prompt工程避坑指南(建议收藏)

张开发
2026/4/6 1:13:42 15 分钟阅读

分享文章

【笑小枫AI系列】Prompt工程避坑指南(建议收藏)
最近在做智能体开发调过了很多的Prompt。刚开始觉得挺简单写Prompt就像和人聊天。结果呢踩坑踩到怀疑人生。后来才发现Prompt工程是门手艺写得好和写得差效果天壤之别。今天把这10个坑分享出来看看你中了几个。坑1把Prompt当聊天写我最早写Prompt是这样的帮我分析一下这段代码看看有什么问题给出改进建议最好能详细一点谢谢写得挺客气对吧问题在于——模型理解飘忽不定。有时候它真就详细一点给你输出三千字。有时候又敷衍两句完事。Prompt并不是真的【同事.skill】而是像写代码一样要有规范。下面给出一个简单的案例模版## 任务 分析代码问题 ## 输入 [代码内容] ## 要求 1. 找出性能瓶颈 2. 指出潜在bug 3. 给出优化建议 ## 输出格式 - 问题列表 - 优化建议结构化、模块化这样效果稳多了。坑2一个Prompt干所有事不要以为一个Prompt真的就能搞定一切请分析这段代码找出问题给出优化建议然后重构成更优雅的版本最后写个单元测试像上面这样我真的这样干过…输出一塌糊涂。Prompt也要遵循单一职责原则。你可以这样拆分写Prompt 1: 分析代码问题 Prompt 2: 针对问题给优化建议 Prompt 3: 重构代码 Prompt 4: 生成单元测试链式调用每一步输出质量都高而且方便调试——哪一步出问题一目了然。要有逻辑一个方法干一件事别整那一坨坨的。坑3疯狂加示例Few-shot Learning很火并不是示例越多越好。如果示例很多模型反而会去模仿示例的格式和语气而不是理解任务本身。2-3个高质量示例足够。关键是示例要精准❌ 示例太长、太复杂、边界模糊✅ 示例简短、典型、覆盖核心场景坑4输出格式全靠缘分请总结一下这篇文章你是不是也经常这样干好的模型真的给你总结到位差点的模型它自己都不知道自己在说啥。你可以这样试下返回结果一目了然## 输出格式JSON { summary: 一句话总结, key_points: [要点1, 要点2, 要点3], sentiment: positive/neutral/negative }坑5把模型当搜索引擎用最近龙虾火了你是不是也经常让它帮你整理最近一周的科技新闻。记得打开搜索API开启联网搜索不然的话嘿嘿我的枫小虾会一本正经给我画饼讲故事。坑6Prompt写完不迭代开发智能体时写Prompt → 测试一下 → 感觉挺好 → 上线上线后智能体开始尬聊了改了一版感觉不错上线后发现还不如第一版。第一版呢谁把我的第一版给吃了Prompt是代码需要版本管理。现在我的习惯每个Prompt都在Git里有版本改之前先提issue记录问题改完提交时写清楚改动原因坑7忽视System PromptSystem Prompt和User Prompt你有没有区分开是不是都堆在一个里面后来发现同样一个User PromptSystem Prompt不同输出完全两个风格。System Prompt定人设User Prompt定任务。可以参考下System Prompt: 你是一个资深后端工程师擅长代码优化和架构设计。 回答风格简洁、专业、偏实战。 输出格式优先用代码示例。 User Prompt: 帮我优化这段SQL查询人设和规则放System任务放User清晰又稳定。坑8温度参数乱调Temperature参数你有没有调过做工作流智能体时你是不是都是默认的0.7参考下面的值调优下吧任务类型建议温度说明代码生成0 - 0.3要稳定不要花活逻辑推理0 - 0.3推理要严谨数据分析0 - 0.2结果要可复现文案创作0.7 - 0.9可以飘一点头脑风暴给小爷油门踩到爆越飘越好坑9复杂Prompt用中文写一直都是使用中文写Prompt笑小枫的英语差呀。后来做对比测试复杂的思维链任务同样的Prompt英文版输出质量明显更高。索性我还是支持国产吧小哭包现在的原则简单指令中文方便阅读复杂任务英文追求效果输出中文让模型输出中文或指定语言坑10不会引导式提问是不是经常这样问这段代码有什么问题在IDE的code编码插件里面你知道会把你的问题改写成什么样吗让模型根据问题去思考而不是让它猜你的问题。你可以复制下面的Prompt这样问请按以下步骤分析代码 1. 先理解代码的整体功能和架构 2. 检查是否存在性能瓶颈 3. 检查是否存在安全隐患 4. 检查是否存在逻辑漏洞 5. 针对发现的问题给出具体的优化建议关于笑小枫本章到这里结束了喜欢的朋友关注一下我呦大伙的支持就是我坚持写下去的动力。老规矩懂了就点赞收藏不懂就问日常在线我会就会回复哈~后续文章会陆续更新文档会同步在微信公众号、个人博客、CSDN和GitHub保持同步更新。微信公众号笑小枫笑小枫个人博客https://www.xiaoxiaofeng.comCSDNhttps://zhangfz.blog.csdn.netGitHubhttps://github.com/hack-feng

更多文章