夜雨聆风搭 AI 智能体的人都有一个通病：花 90% 的时间选模型、搭数据库，却只花 10 分钟写角色提示词。结果就是：Demo 演示的时候好好的，一到现场用就拉胯 ——AI 要么答非所问，要么胡说八道，要么聊着聊着就忘了你刚才说什么。
今天我要告诉大家一个真相：智能体的能力上限，80% 由角色、关键词和上下文决定，和模型关系不大。一个写得好的 "入职说明书"，能让你的 AI 准确率提升 40%，幻觉率降低 70%，从 "废物" 变成 "神队友"。
🤖 第一部分：怎么给 AI 写 "入职说明书"（角色设计）
把 AI 当成你新招来的资料员。你不会只跟她说一句 "你是资料员" 就不管了吧？你会告诉她：
你是谁，给谁干活 你每天要做什么 什么事你不能做 做错了要怎么办
给 AI 写角色也是一样的道理。
90% 的人都在犯的错误
❌ 角色太泛："你是一个工程助手"（什么都能答，什么都答不好）❌ 吹得太狠："你能解决所有工程问题"（必然胡说八道）❌ 只说能做，不说不能做（AI 会主动给自己加戏）❌ 脱离工地：用网上抄的通用模板，根本不懂工程行话
正确的角色写法：7 条写全，一个都不能少
就像给新员工写岗位职责一样，一条一条写清楚：
1. 明确身份：你是谁，给谁干活
错误："你是一个工程助手"正确："你是 XX 项目专属一线技术助手，只服务本项目的施工员、技术员、安全员和班组长"
2. 明确能力：能干什么，不能干什么
错误："你能提供工程技术支持"正确：✅ 你能查：混凝土方量、材料库存、施工进度、安全隐患❌ 你不能查：成本、报价、合同、工资❌ 你不能做：设计变更、技术决策、安全交底
3. 明确铁律：绝对不能违反的规矩
这是杜绝幻觉的核心，一定要写得狠一点：
4. 明确知识边界：只能用我给你的资料
错误："你可以用你所有的知识回答问题"正确："你只能用我提供的 4 张数据库表和 5 本规范回答问题，不能用任何外部知识"
5. 明确输出要求：怎么说话
错误："请清晰回答问题"正确：
说人话，别用专业术语 多条数据用表格展示 一句话说清楚，别写长篇大论
6. 明确异常处理：遇到问题怎么办
错误："请尽量回答用户的问题"正确：
用户没说楼号："请问你想查哪个楼号的？" 用户问的问题你不会："抱歉，我只能查询混凝土浇筑相关的数据"
7. 明确安全提示：工程行业的生命线
必须加："所有涉及安全和技术决策的内容，末尾必须注明：' 以上信息仅供参考，具体操作请以现场交底为准 '"
黄金法则：能力越小，AI 越厉害
不要试图做万能 AI，只做 "一件事"，并且把这件事做到极致。
好的角色："你是一个混凝土浇筑数据查询助手" 坏的角色："你是一个全能工程助手"
📚 第二部分：教 AI 说工地人话（关键词体系）
AI 不是人，它听不懂工程行话。在它眼里：
"60# 楼" ≠ "60 号楼" ≠ "六十号楼" ≠ "60 栋" "混凝土" ≠ "砼" "Φ16" ≠ "16 厘" ≠ "16 号钢筋"
你觉得是同一个东西，它觉得是四个完全不同的东西。这就是 90% AI 幻觉的来源。
什么是关键词体系？
就是给 AI 一本专属工地字典，告诉它：
这个词是什么意思 它的同义词有哪些 在本项目里应该怎么叫
工程关键词分 4 级，按重要性排序
1. 核心关键词（最重要）
定义：AI 每天都会用到的词 示例：混凝土、钢筋、方量、楼号、日期 写法：
2. 场景关键词
定义：不同业务场景的专用词 示例： 混凝土场景：标号、坍落度、试块、养护 安全场景：隐患、整改、临边防护、脚手架 写法：按场景分组，告诉 AI 每个场景下常用的词
3. 项目专属关键词
定义：只有你们项目才有的词 示例：1 号钢筋堆场、张三班组、地下车库西区 写法：把项目里所有的楼号、班组、地点都列出来
4. 指令关键词
定义：用户用来控制 AI 的词 示例：查询、统计、汇总、导出 写法：告诉 AI 每个指令是什么意思，比如："' 统计 '= 按条件汇总数据并生成表格"
一个小技巧，解决 90% 的术语问题
把你项目里所有可能的同义词都列出来，然后告诉 AI："所有这些词，都统一用 XX 表示"。比如：
🧠 第三部分：让 AI 长记性（上下文管理）
AI 没有真正的记忆，它的 "记性" 就是你和它的聊天记录。很多人遇到的问题：
聊着聊着 AI 就忘了你刚才说什么 上一轮你说查 60# 楼，下一轮它又问你查哪个楼 聊多了 AI 就开始胡说八道
这都是因为你不会管理 AI 的 "记性"。
AI 的记性有什么特点？
它只能记住最近的几千字 它记不住细节，只能记住大概 旧的信息会被新的信息覆盖 没用的信息会干扰它的判断
怎么让 AI 记住重要的事？
1. 重要的事，重复说三遍
不要以为你说过一次 AI 就记住了。重要的规则，一定要在提示词里反复强调。比如："绝对不能编造数据。再说一遍，绝对不能编造数据。如果查不到，就直接说查不到。"
2. 主动帮 AI"划重点"
当你提到重要的信息时，主动告诉 AI："记住，我现在查的是 60# 楼，5 月份的数据。"不要让 AI 自己去猜。
3. 定期给 AI"清空记忆"
聊了 5-10 轮之后，如果发现 AI 开始答非所问，就说一句 "重置"，然后重新开始。就像你会定期清理电脑内存一样，也要定期清理 AI 的记忆。
4. 不要让 AI 记没用的事
不要和 AI 聊无关的话题，不要说废话。每一句话都要和你要查的内容相关。没用的信息越多，AI 的记性就越差。
✅ 直接抄！完整可复制的角色模板
把下面的内容复制到你的 AI 平台，改个项目名就能用：
📝 最后说两句
很多人觉得 AI 不好用，是模型不行。其实不是。同样的模型，同样的数据，有的人写的角色能做到 99% 准确，有的人写的角色就是胡说八道。
AI 的本质，是一个执行力极强但没有任何常识的实习生。你把规矩定得越清楚，把话说得越明白，它干的活就越好。你模棱两可，它就会给你模棱两可的答案。
把角色、关键词、上下文这三件事做好，你的 AI 自然就好用了。
💬 互动话题你写 AI 提示词的时候遇到过哪些坑？评论区聊聊～
