智能体任务书编写指南：从要素拆解到实战案例
目录
一、任务书为什么重要
任务书（Prompt/任务指令）是智能体的"工作说明书"------写得好，智能体精准高效；写得差，答非所问、产出泛泛。
一句话：「给智能体写任务书，就像给新员工布置任务------目标不清，执行必乱」。
二、任务书核心要素
角色 + 目标 + 背景 + 数据 + 输出格式 + 约束 + 步骤 + 示例速记口诀
「你是谁、干什么、什么情况、给什么、交什么、别做什么、怎么做、照什么做」
| 要素 | 一句话 |
|---|---|
| 角色 | 你是谁 |
| 目标 | 干什么 |
| 背景 | 什么情况 |
| 数据 | 给什么 |
| 输出格式 | 交什么 |
| 约束 | 别做什么 |
| 步骤 | 怎么做 |
| 示例 | 照什么做 |
三、要素详解
角色（Role）
- 让模型用特定专业视角回答。
- 例："你是一位资深的无人机排障工程师"。
目标（Goal）
- 明确、可衡量、单一。
- 例："分析这份飞行日志，找出画圈的原因"。
背景（Context）
- 提供必要上下文，减少猜测。
- 例："这是编队表演用多旋翼，定位模式悬停时画圈"。
数据（Data）
- 输入材料：文档/表格/日志/图片。
- 说明数据格式与关键字段。
输出格式（Format）
- 规定交付形态：表格、列表、JSON、报告。
- 例："用表格输出：现象/参数/根因/处理"。
约束（Constraints）
- 边界与禁止项。
- 例："只基于给定日志分析，不要臆测；长度不超过 500 字"。
步骤（Steps）
- 指导执行顺序（复杂任务）。
- 例："第一步看测试比，第二步看磁场，第三步给结论"。
示例（Example）
- 给 1-2 个样板（Few-shot），引导格式与风格。
四、任务书模板
【角色】你是一位{专业角色}。
【目标】请完成{具体任务}。
【背景】{必要上下文：场景/条件/限制}。
【数据】以下是输入材料：
{粘贴数据/说明附件}
【输出格式】请按以下格式输出：
{格式要求：表格/列表/结构}
【约束】{边界与禁止项：只依据给定数据/不臆测/长度限制等}
【步骤】建议按以下步骤执行：
1. {步骤一}
2. {步骤二}
3. {步骤三}
【示例】参考格式：
{示例}五、案例一：文档总结
任务书
【角色】你是一位严谨的文档分析师。
【目标】总结下面这份文档，提炼核心要点。
【背景】这是平台技术文档，读者是无人机工程师。
【数据】（粘贴文档或说明"见附件"）
【输出格式】用"要点 + 一句话说明"的列表输出，不超过 8 条。
【约束】只总结文档内容，不添加文档没有的信息。效果
- 得到结构化要点，而非泛泛概括。
- 约束"只总结文档内容"抑制幻觉。
六、案例二：飞行日志排障分析
任务书
【角色】你是一位资深无人机排障工程师，精通飞控参数。
【目标】分析以下飞行日志，判断该机画圈的可能原因，给出排查建议。
【背景】该机为编队表演多旋翼（PX4），定位模式悬停时轨迹画圈（半径 1-2 米），机头航向与轨迹切线不一致。
【数据】
mag_test_ratio: 持续 1.2-1.8（>1.0）
pos_test_ratio: 0.3-0.5（正常）
磁场强度: 0.70-0.75 Gauss
双罗盘差值: 恒定约 8°
卫星数: 14，HDOP: 1.3
【输出格式】用表格输出：现象 / 参数异常 / 可能根因 / 建议处理。
【约束】只基于给定参数分析，不臆测其他因素；结论需符合 MECE 分流逻辑。
【步骤】
1. 先看估计器测试比定位被拒传感器
2. 再看磁场相关参数确认干扰类型
3. 最后给出处理建议预期输出
| 现象 | 参数异常 | 可能根因 | 建议处理 |
|---|---|---|---|
| 画圈+机头转 | mag>1.0、磁场偏大、双罗盘差值大 | 硬磁干扰 | 移除磁源、重新校准 |
七、案例三：数据分析
任务书
【角色】你是一位数据分析师。
【目标】分析附件的电池电压数据，找出异常趋势。
【背景】这是 20 次飞行记录的电压/内阻数据，评估电池健康。
【数据】（上传 CSV 或粘贴数据）
【输出格式】输出：1）整体趋势结论 2）异常数据点 3）建议动作（表格）。
【约束】数据不足时说明，不要编造统计数字。技巧
- 上传数据 + 明确分析维度 + 规定输出结构。
- 让模型用代码执行（如开启代码沙箱）更精确。
八、常见错误与修正
| 错误写法 | 问题 | 修正 |
|---|---|---|
| "帮我分析一下" | 目标宽泛 | 明确：分析什么、输出什么 |
| "写得专业点" | 约束宽泛 | 给角色、格式、长度 |
| 不提供背景 | 模型瞎猜 | 补背景与数据 |
| 一次要太多 | 输出失控 | 拆小任务 |
| 没有示例 | 格式随意 | 给示例 |
九、进阶技巧
迭代式任务书
- 先给简化任务书 → 看产出 → 反馈增补约束 → 再执行。
- 把满意的任务书存为模板复用。
链式任务
- 把大任务拆成多个子任务书，逐步推进。
- 例：先"提取关键字段" → 再"分析字段关系" → 最后"生成报告"。
结构化约束
- 指定输出 JSON/表格 → 便于程序化使用。
- 指定"如果...就..."的条件逻辑。
防幻觉技巧
- 要求"标注不确定项"。
- 要求"给出依据/来源"。
- 要求"只使用给定数据"。