2. 创建 Agent


功能介绍

Agent(智能体)是 Dify 中最"智能"的应用类型。与其他应用类型不同,Agent 具备自主决策能力——它可以根据用户的请求,自主判断需要调用哪些工具、按什么顺序执行、以及如何整合各步骤的结果来生成最终回答。

Dify 的 Agent 支持两种推理策略:

  • ReAct(Reasoning + Acting):Agent 会交替进行"思考"和"行动",每一步先推理下一步应该做什么,然后执行对应的工具调用,观察结果后再决定下一步。
  • Function Calling(函数调用):Agent 通过模型的原生函数调用能力,一次性规划并调用所需的工具。

Agent 的编排界面与聊天助手类似,左侧配置提示词、变量、知识库和工具,右侧是调试区域。关键区别在于 Agent 多了「工具」配置区域和「Agent 设置」面板,可以在其中选择推理策略、配置最大迭代次数等参数。

使用方法

image-20260407131418263

在工作室中点击「创建应用」,选择「Agent」类型。

image-20260407131512653

输入应用名称和描述,点击创建。

image-20260407131611712

编写提示词,定义 Agent 的角色和行为规则,或点击右上角的「生成」按钮,让 AI 自动生成提示词。

image-20260407131756898

Agent 也可以关联知识库和设置变量,用户可以自行配置。

image-20260407133301657

点击右上角选择Agent使用的模型。

image-20260407132248962

在「工具」区域点击「+ 添加」,从工具列表中选择 Agent 可以使用的工具。

image-20260407132316829

点击右上角的齿轮图标打开 Agent 设置面板,可以配置:

  • Agent Mode(推理策略):选择 ReAct 或 Function Calling。
  • 最大迭代次数:限制 Agent 的推理步数(默认 10 次)。

image-20260407132806585

下方的「视觉」选项可以选择智能体是否能接收图片。

image-20260407133007355

观察 Agent 的推理过程,确认工具调用是否正确。满意后点击右上角「发布」上线。

image-20260407134718320

发布后的应用可以在「探索」界面的左侧边栏使用。

Agent 设置参数说明

参数说明
Agent Mode推理策略,ReAct 适合需要逐步推理的场景,Function Calling 更高效。
最大迭代次数Agent 最多执行多少轮"思考-行动"循环,防止无限循环。
提示词Agent 的系统提示词,定义角色、工具使用规则和输出格式。

使用技巧

  • Agent 的提示词要明确说明每个工具的用途和使用场景,帮助 Agent 做出更好的决策。
  • 最大迭代次数不宜设得太高,10-15 次通常足够。设置过高可能导致不必要的 token 消耗。
  • 对于需要访问实时信息的场景(如查询天气、搜索新闻),给 Agent 添加 Google 搜索和网页抓取工具。
  • 如果 Agent 的行为不符合预期,可以在调试区域查看完整的推理链(思考过程和工具调用记录),找出问题所在。
  • 推荐为复杂任务使用 ReAct 策略,它的推理过程更透明,便于调试。

示例

示例一:智能研究助手 Agent

提示词:
你是一位专业的研究助手。用户会向你提出研究问题,你需要使用可用的工具来搜索信息、分析数据,最终生成一份全面的研究报告。

工作流程:
1. 理解用户的研究问题
2. 使用 Google 搜索查找相关信息
3. 使用网页抓取工具获取详细内容
4. 综合分析所有收集到的信息
5. 生成结构化的研究报告

工具列表:Google 搜索、网页抓取、时间(获取当前日期)

示例二:数据分析 Agent

提示词:
你是一位数据分析师 Agent。用户会向你描述数据分析需求,你需要编写并执行代码来完成分析任务。

规则:
1. 先确认用户的分析需求和数据格式
2. 使用代码执行工具运行 Python 代码进行数据处理
3. 将分析结果以清晰的格式呈现给用户
4. 如果分析过程中遇到问题,向用户说明并提出解决方案

工具列表:代码执行器

示例三:日程管理 Agent

提示词:
你是一位个人日程管理助理。你可以帮助用户查询当前时间、创建提醒、搜索活动信息等。

能力范围:
1. 查询当前日期和时间
2. 搜索用户提到的活动或事件信息
3. 根据用户描述生成日程安排建议

工具列表:时间、Google 搜索

示例四:技术文档问答 Agent

提示词:
你是一位技术支持 Agent,负责回答用户关于产品技术文档的问题。你可以从知识库中检索文档内容,也可以在需要时搜索最新的技术文章。

工作策略:
1. 首先从产品文档知识库中检索相关信息
2. 如果知识库中没有找到答案,使用搜索工具查找最新的技术资料
3. 综合所有信息后给出回答
4. 引用信息来源,方便用户验证

工具列表:Google 搜索、网页抓取
知识库:产品技术文档库

示例五:内容创作 Agent

提示词:
你是一位全能内容创作 Agent。用户会描述他们想要创作的内容类型和主题,你需要搜集素材、组织架构、最终生成高质量的内容。

创作流程:
1. 了解用户的内容需求(类型、主题、受众、风格)
2. 搜索相关的热门话题和素材
3. 根据搜集到的信息构建内容框架
4. 生成完整的内容稿件
5. 根据用户反馈修改优化

工具列表:Google 搜索、网页抓取、时间