调 Agent 的 Prompt 太痛苦了？这套“写法 + 测评”救了我

最近在做导购Agent工程侧已经开发完毕但调Prompt、做测评每一个都令我痛苦万分因为到处都是“翻车现场”要么“思维太发散”绕着用户的问题走要么“工具乱点”命中一个tool就一条道走到黑要么“跑不完”说着说着卡住了再没了下文…因此搜了一些Agent相关的论文、文章、视频企图从技术底层抱抱佛脚…正巧看到了Anthropic 8月1日在YouTube上发布了一个视频《Prompting for Agents | Code w/ Claude》详细讲了如何写好Agent 的 Prompt、如何测评。正好是我现在非常需要的内容因此今天的文章主要分享下该视频的观点。这支视频讲了啥速览版Agent 的正确定义不是“更聪明的聊天机器人”而是“在工具回路中自主推进任务的系统”给定目标→选择/调用工具→观察→决定下一步→直到达成停止条件。什么时候该用 Agent适合复杂、不确定路径、且高价值的任务能被固定流程吃掉的优先 Workflow。这个判断框架与 Anthropic 的工程文《Building effective agents》完全一致。如何写好提示词要写清目标与成功标准、工具选择原则、思考—行动—反思节奏、启发式预算/不可逆动作/停机条件、输出契约等否则只是在给模型加戏。测评从简单、小批量开始先把最小可用工具集跑通再逐步加复杂度。什么是AgentAgent 在一个循环回路中使用工具的模型。给定目标后它会自主地选择/调用合适工具 → 观察反馈 → 更新决策 → 继续推进直到满足停止条件。它所依赖的“环境”包括运行环境、可用工具清单、提示词任务与边界。Agent的组成目标与停止条件。工具回路Action–Observation每一步都基于工具返回更新计划。环境三件套运行环境 / 工具 / 系统提示明确“Agent要完成什么”。“越简单越好”提示与工具说明要清晰克制别给花里胡哨的语言描述。什么是“提示词工程prompt engineering”Anthropic AI团队成员Hannah认为“提示词工程是一种系统性改进用于大模型应用的提示词的方法——通过测试、评估、分析与对提示词及工具的优化用自然语言进行编程一个好的提示词工程是所需能力包含清晰、无歧义、精确的写作以科学思维制作评测不断测试产品化思维对你的产品来说理想的模型行为是什么理解大模型的倾向与局限汇总并分析失败模式并思考修复方法思考边界场景让提示在广泛输入下都稳健。写提示词 写操作流程Anthropic 的核心观点Prompt 不是文案是规则和流程。它要解决的不是“说得漂亮”而是如何让 Agent 在真实环境里把事办完。这份规程至少包含五部分角色与高层目标1–2 句话说清你是谁、为啥而来动态上下文检索到的资料、用户偏好、会话历史详细任务指令做什么、不做什么、成败标准示例 n-shot可选用于边界提醒不是“写死流程”重复关键指令长提示里尤其重要防遗忘一个示例你是一名AI 旅行顾问AI travel agent任务是根据用户输入创建一份个性化旅行行程。你的目标是产出一份有吸引力、结构清晰、切实可行的行程既符合用户偏好也匹配指定的目的地与出行天数。你将获得以下信息目的地、天数、用户偏好。在制定行程时请遵循以下指南调研目的地及其热门景点并结合用户偏好。为每一天规划活动确保观光—放松—本地体验之间的良好平衡。给出用餐建议考虑当地美食如用户提到饮食偏好请一并考虑。推荐住宿选项需与用户偏好与预算相匹配。提供实用信息如交通方式与预估花费。注意可用天数制定现实可行的时间安排。请按以下格式呈现你的行程以目的地的简要介绍开头。提供按天拆分的活动、用餐与住宿安排。以额外提示/出行建议结尾。现在请基于提供的目的地、天数和用户偏好创建一份个性化旅行行程。你的建议应当既有创意又充分详尽确保行程既体现用户兴趣也凸显目的地的独特之处。什么时候该用 Agent不是所有场景都需要 Agent很多时候反而不该用 Agent它最适合复杂且高价值的任务。人可以按“固定步骤”一步步做完的工作用工作流workflow可能更合适、更省资源。判断方法 1任务是否复杂到只知道终点不清楚具体怎么走、需要哪些信息与工具 2完成后是否“高价值”低价值流程别浪费 Agent 的资源 3工具与数据是否可用若给不了足够工具/信息就让它办成事那就先缩小范围 4容错与纠错成本难以发现/纠正的错误不适合让 Agent 全自动去跑。2个适合Agent的例子写代码你知道目标是“把设计文档落实成 PR”但并不确定具体路径、要如何迭代修改——高价值、强杠杆适合 Agent。数据分析你清楚希望得到哪些洞见/可视化但数据形态、清洗过程并不确定——这类探索式任务非常适配 Agent。如何写好Agent的Prompt原则一像 Agent 那样思考模拟“Agent 身处的环境”——它能看到什么工具、工具会返回什么甚至可以在脑内模拟一遍如果你站在 Agent 的角度拿到这份工具说明你会不会困惑人类都看不懂的工作流模型更不可能做对。原则二赋予“合理的启发式Heuristics”提示工程不是“写字”而是决定模型该拥有哪些概念与行为准则。例如我们给 Agent 一个重要概念——“不可逆性irreversibility”避免做不可逆、可能伤害用户或环境的动作。再比如给“检索”Agent 设停止条件与预算找到答案就停简单问题5次工具调用复杂问题可到10或50不要为“完美来源”无限搜索。这类“合理启发式”都要在提示里清晰明确地写出来。原则三明确“何时用哪种工具”前沿模型一次能挂非常多的工具但模型并不知道在你的组织里哪个工具对哪个任务更关键。必须在提示中写出选择原则比如公司信息优先搜 Slack、代码问题查 GitHub/Sentry、业务报表走 DataDog……别只给一串简短描述就指望它自己悟透。原则四引导“思考—行动”的过程不要只“打开思考”而要具体引导让它先规划这个查询复杂度如何预期用几次工具优先查哪些来源如何判定成功在工具调用之间穿插反思网页结果不必然正确需要质量评估/二次求证/必要的免责声明。提前写上副作用与停止条件比如“若找不到完美来源最多 N 次搜索后停止”。原则五管理上下文窗口Agent 容易撞到上下文上限。做法包括压缩临近窗口上限时自动把上下文浓缩为高密度摘要交给新的会话继续跑。外部记忆把关键过程/状态写入外部文件需要时再读取。子Agent把搜索等“吃上下文”的工作分给子代理压缩后再交给主代理整合、撰写报告。原则六让 Claude 发挥所长 工具要“少而精”先用一套最小可用的提示和工具跑起来再逐步加复杂度。避免给一堆名字相似/职责重叠的工具例如 6 个“搜索”工具查不同库会让模型混淆——能合并就合并并把用途说清清楚楚。测评怎么做从“小而真”开始效果量越大样本越可小起步不需要上百条只要几条真实用例每次改 Prompt/工具文档都能看到显著变化。用真实任务评测尽量让评测题就像用户会问的那种且能用现有工具找到标准答案。LLM 评审 量表rubric 很有用只要规则清楚模型能胜任“打分官”。人评无法被完全替代每周都要有人“猛怼 手感校验 真实用户试用”人类最能摸到“硌手的边角”。评测都评什么结果 过程1结果向Outcome答案正确性用 LLM-judge 判定回答是否正确、是否覆盖关键点。最终状态达成看 Agent 是否到达正确的最终状态例如外部系统里确实发生了期望变更。2过程向Process工具使用正确性评估是否选对工具与参数以及遇错能否恢复图示中“从参数错误恢复”的示例。其他常见过程量化步骤数/时延、无效调用、异常与回退等——这些直接从对话与调用日志即可统计。LLM-as-judge 的最小做法给评审模型一份量表和结构化输出格式它就能稳定工作。示例量表要点是否满足硬性约束0/1/2证据质量与可追溯性0/1/2取舍与理由是否清晰0/1/2是否给出风险/不确定性0/1/2输出契约是否遵守0/1/2合计 0–10 分并给一句话短评测评起步流程选10–20 条真实任务样例最好能用现有工具找到明确答案/标准。为每条样例写明期望结果/最终状态方便做 τ-bench。准备一份rubric用LLM-as-judge打分必要处穿插人评抽检。观察结果 过程两套指标的变化对失败样例做回放定位是选择错工具、参数错误、步骤冗长还是停止条件/启发式不当。小改就复测每次只调整一个维度如 Prompt 的启发式或某个工具文档再跑同一小集合对比效果。学AI大模型的正确顺序千万不要搞错了2026年AI风口已来各行各业的AI渗透肉眼可见超多公司要么转型做AI相关产品要么高薪挖AI技术人才机遇直接摆在眼前有往AI方向发展或者本身有后端编程基础的朋友直接冲AI大模型应用开发转岗超合适就算暂时不打算转岗了解大模型、RAG、Prompt、Agent这些热门概念能上手做简单项目也绝对是求职加分王给大家整理了超全最新的AI大模型应用开发学习清单和资料手把手帮你快速入门学习路线:✅大模型基础认知—大模型核心原理、发展历程、主流模型GPT、文心一言等特点解析✅核心技术模块—RAG检索增强生成、Prompt工程实战、Agent智能体开发逻辑✅开发基础能力—Python进阶、API接口调用、大模型开发框架LangChain等实操✅应用场景开发—智能问答系统、企业知识库、AIGC内容生成工具、行业定制化大模型应用✅项目落地流程—需求拆解、技术选型、模型调优、测试上线、运维迭代✅面试求职冲刺—岗位JD解析、简历AI项目包装、高频面试题汇总、模拟面经以上6大模块看似清晰好上手实则每个部分都有扎实的核心内容需要吃透我把大模型的学习全流程已经整理好了抓住AI时代风口轻松解锁职业新可能希望大家都能把握机遇实现薪资/职业跃迁这份完整版的大模型 AI 学习资料已经上传CSDN朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】