搭建 Dify 智能体时，先做一个能验收的小任务，例如“根据输入生成会议行动项，并在信息缺失时明确追问”。Dify 官方 new Agent 文档当前明确标注为 Beta，入口、字段和运行行为仍可能变化。官方文档把指令、工具和调试放在同一构建流程里；本文只完成这三个环节，不在第一个版本同时接知识库、多个外部系统和复杂分支。
先把常见疑问说清楚
- 开始前：准备 3 条正常输入、2 条信息不足输入和 1 条不应回答的越界输入。
- 版本状态：new Agent 当前为 Beta；正式使用前应重新核对官方页面，并保留回归用例。
- 最小配置：写清角色、允许任务、拒绝条件与输出格式；没有实际需要时先不添加工具。
- 通过标准：正常问题得到指定格式，信息不足时追问，越界问题不编造，工具失败时不伪装成功。
开始前先准备什么
准备一份不含敏感信息的测试材料，并写清任务范围、期望输出和验收条件。涉及客户资料、个人信息、未公开论文或商业文件时，先确认上传权限并做必要脱敏。
实际操作步骤
- 在 Dify 工作区创建 Agent 应用。先给它一个具体名称和单一目标，例如“会议行动项整理器”，避免使用“万能助手”这类无法验收的目标。
- 在 Instructions 中写四部分：角色、输入范围、处理规则、输出格式。示例：
只根据用户提供的会议记录输出事项、负责人、截止日期；缺失字段写“待确认”；不要补造姓名和日期。 - 确有外部动作需求时再添加工具。逐项阅读工具需要的参数与权限，测试阶段只连接低风险数据；写入、发送或删除类动作必须保留人工确认。
- 在预览区依次提交正常、缺字段、越界和工具失败问题。记录输入、预期结果、实际结果和失败原因；只改一个配置后重复同一组测试。
- 最后重开预览并复测一遍。若输出格式稳定、未知字段没有补造、工具失败没有显示成功，再把这一版本记为可继续迭代的基线。
预期结果与检查方法
完成后应得到一个任务边界明确的 Agent，以及至少六条可重复执行的预览测试记录。
验证：检查三类证据：正常问题格式正确，缺字段问题保留待确认，越界或工具失败问题没有生成伪结果。
什么时候应该停止并回退
指令频繁互相冲突、工具参数不清或失败仍显示成功时，停止增加功能；删回最小配置并定位具体失败环节。
如果结论会用于考试、医疗、法律、财务或对外承诺，应让具备责任的人复核，不能把 AI 输出当成最终依据。
官方资料
- https://docs.dify.ai/en/cloud/use-dify/build/new-agent/build：Dify 官方文档说明 Agent 的创建、指令、工具配置与调试预览。
- https://docs.dify.ai/en/cloud/use-dify/build/new-agent/overview：Dify 官方概览说明 Agent 的组成与适用边界。
使用边界
本文依据 2026-10-01 可读取的 Dify 官方文档整理，未登录读者工作区，也未调用外部工具；new Agent 当前为 Beta，模型、工具列表、权限、入口和运行行为均以当前实例与最新官方文档为准。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32799.html
