最近在写Prompt文档,我总结出几条实践经验最近一段时间，我大部分精力都花在写Prompt文档上。本以为开发智能体最费劲的是调代码、配模型，真正动手才发现，最磨人的是这份给AI看的“说明书”。踩了不少坑，也试出了一些管用的方法，整理成这篇文章，都是亲身经历换来的。
Prompt文档到底是什么
你可以把它理解成智能体的岗位说明书。现在大家都在聊智能体开发，代码和模型固然重要，但一个智能体到底顶不顶用，往往取决于这份文档写得怎么样。智能体不是普通的聊天机器人，它是被派去干具体活的。比如自动处理客服工单、帮用户筛选房源、给学员规划学习路径。你不可能每次临时现编指令，那不稳定，也不专业。你需要一份结构化的、每次调用都自动加载的Prompt文档，它像智能体的出厂设置，决定了它面对用户时的表现。打个比方。你招了个新员工，给他配了最贵的电脑，装了最新的软件，但没给工作手册。他不知道流程，不知道话术规范，结果面对客户时东一榔头西一棒子。反过来，设备普通，但手册写得清清楚楚，第一步做什么、怎么回应、最后输出什么格式，新人也能干得老练。智能体完全同理，模型参数是智商，Prompt文档才是职业素养。70%的工作量都在写这份文档
就我最近的体验来说，开发一个智能体，七成时间都耗在写Prompt文档上。剩下三成才轮到调接口、测数据那些事。代码搭的是骨架，文档填的是灵魂。骨架歪一点还能凑合，灵魂没给对，整个智能体就废了。一份好的文档，能把模型的表达能力真正激发出来；一份差的文档，再聪明的模型也白搭。我自己写的时候试过很多版本，同一套模型参数，换三种写法，出来的结果天差地别。后来才想明白，不是模型不行，是我没把需求翻译成它听得懂的语言。写顺手的就一个公式，叫三明治法
第一层是角色设定，告诉智能体你是谁。比如“你是一个干了十年的房产中介”，而不是“你是一个AI”，那是废话。角色越具体，它的回答就越有代入感。第二层是任务说明，清清楚楚交代要干什么。比如“帮用户筛选深圳宝安区、总价五百万以内、三房两厅的二手房”，越具体越不会跑偏。第三层是输出要求，规定答案长什么样。比如“用表格列出小区名、面积、单价、优缺点，最后附购买建议”。一套组合下来，智能体基本稳了。我自己用的几个智能体，文档都是按这个框架搭的，测试下来翻车率明显降低。动笔之前先躲开三个坑
第一个坑是自说自话。别闷头猜用户想要什么，先问清楚：这个智能体给谁用？他们最头疼什么问题？希望AI怎么帮？我第一版文档就是自己拍脑袋写的，结果一测试根本不在点上，全部推倒重来。第二个坑是贪多嚼不烂。别指望一个智能体既能写诗又能修图还能算账，结果哪样都干不利索。智能体开发的第一原则就是专注，一个智能体只解决一类问题，做到极致。第三个坑是写完不测试。文档定稿后必须自己当小白鼠，换不同问法、换不同用户视角反复试，把翻车的地方记下来，反复改。我自己每个文档至少改过七八版才上线。普通人上手其实不难
你不用写代码，只要把日常重复的小事包装成一份文档就行。比如想让智能体帮你写朋友圈，就写：“你是一个逗比又有点文艺的朋友。帮我写一条周末去爬山的朋友圈文案。要求带两个表情符号，语气轻松，最后加一句鸡汤但别太肉麻。”第一次结果可能不准，改一改角色或输出格式，再试，几轮下来就顺了。最后说三条我最近感触最深的
第一，Prompt文档不是辅助材料，它是智能体的核心资产。花七成精力写文档，后面省九成时间改答案。第三，调研和测试不是可选项，是必选项。问对人、试够数，智能体才能从“能跑”变成“好用”。如果你也正在琢磨怎么写Prompt文档，欢迎在评论区聊聊你的困惑？
夜雨聆风