MySQL
PostgreSQL
Posts
React
技术手册

Dify Agent 节点使用指南#

概述#

Agent 节点是 Dify 中高度封装的智能单元，具备自主思考和规划能力。你只需要给它设定目标（Goal）并提供工具（Tools），它就能在内部自主地思考、规划、执行任务。

Agent 节点基础#

什么是 Agent 节点#

Agent 节点是一个高度封装的智能单元，可以：

自主思考任务目标
规划执行步骤
选择合适的工具
处理复杂任务
适应不同场景

与 LLM 节点的区别#

特性	LLM 节点	Agent 节点
自主性	低	高
规划能力	无	有
工具使用	手动配置	自动选择
复杂度	简单	复杂
适用场景	单一任务	复杂任务

适用场景#

场景	说明
研究助手	自动检索和总结信息
数据分析	自动收集和分析数据
任务自动化	自动完成多步骤任务
决策支持	基于信息提供决策建议

创建 Agent 节点#

添加 Agent 节点#

步骤：

在工作流画布中点击 + 按钮
选择 Agent 节点
将节点添加到画布

基础配置#

目标设置：

PRTCL // YAML

1
Agent 节点配置:
2
  goal: "帮助用户完成特定任务"
3
  instruction: |
4
    你是一个智能助手，可以：
5
    1. 搜索网络信息
6
    2. 读取文件内容
7
    3. 调用 API 接口
8
    4. 分析数据
9

10
    根据用户需求，自主规划并执行任务。

提示词模板：

PRTCL // YAML

1
提示词配置:
2
  role: "智能助手"
3
  expertise:
4
    - "信息检索"
5
    - "数据分析"
6
    - "任务规划"
7
  personality: "专业、高效、可靠"

工具配置#

可用工具#

Dify 支持多种工具类型：

工具类型	说明	示例
网络搜索	搜索网络信息	Google, Bing, Baidu
文件操作	读取和写入文件	读取文档、保存结果
API 调用	调用外部 API	天气 API, 股票 API
数据库	查询和更新数据库	MySQL, PostgreSQL
计算器	数学计算	基础运算、统计分析

配置工具#

启用工具：

PRTCL // YAML

1
工具配置:
2
  enabled_tools:
3
    - name: "web_search"
4
      description: "搜索网络信息"
5
      provider: "google"
6
      max_results: 10
7

8
    - name: "file_read"
9
      description: "读取文件内容"
10
      allowed_paths:
11
        - "/data/documents"
12
        - "/data/reports"
13

14
    - name: "api_call"
15
      description: "调用 API 接口"
16
      endpoints:
17
        - name: "weather"
18
          url: "https://api.weather.com/v1/current"
19
          method: "GET"
20
        - name: "stock"
21
          url: "https://api.stock.com/v1/quote"
22
          method: "GET"
23

24
    - name: "calculator"
25
      description: "数学计算"
26
      operations:
27
        - "addition"
28
        - "subtraction"
29
        - "multiplication"
30
        - "division"
31
        - "statistics"

工具权限：

PRTCL // YAML

1
工具权限:
2
  web_search:
3
    max_results: 10
4
    timeout: 30
5

6
  file_read:
7
    allowed_paths:
8
      - "/data/documents"
9
      - "/data/reports"
10
    max_file_size: 10485760  # 10MB
11

12
  api_call:
13
    rate_limit: 60  # 每分钟 60 次
14
    timeout: 10

自定义工具#

创建自定义工具：

PRTCL // YAML

1
自定义工具:
2
  name: "custom_analysis"
3
  description: "自定义数据分析工具"
4
  type: "api"
5
  endpoint: "https://api.example.com/analyze"
6
  method: "POST"
7
  headers:
8
    Authorization: "Bearer ${API_KEY}"
9
  parameters:
10
    - name: "data"
11
      type: "object"
12
      required: true
13
    - name: "options"
14
      type: "object"
15
      required: false

推理配置#

推理策略#

Dify 支持多种推理策略：

策略	说明	适用场景
Chain of Thought	链式思维	简单任务
Tree of Thoughts	树状思维	复杂任务
ReAct	推理-行动循环	需要工具的任务

配置推理#

推理设置：

PRTCL // YAML

1
推理配置:
2
  enabled: true
3
  strategy: "tree_of_thought"  # chain_of_thought, tree_of_thought, react
4
  max_iterations: 5
5
  max_thought_depth: 3
6
  timeout: 300

推理参数：

PRTCL // YAML

1
推理参数:
2
  thought_budget: 1000  # 思考预算（token 数）
3
  action_budget: 10  # 动作预算（最多执行 10 次工具调用）
4
  confidence_threshold: 0.7  # 置信度阈值

推理示例#

任务：搜索并分析某个主题

推理过程：

思考：用户想要了解 AI 的发展趋势
规划：搜索相关信息 → 分析内容 → 总结结论
执行：
- 调用 web_search 搜索”AI 发展趋势”
- 读取搜索结果
- 分析关键信息
- 生成总结
输出：提供详细的趋势分析报告

记忆管理#

短期记忆#

短期记忆配置：

PRTCL // YAML

1
短期记忆:
2
  enabled: true
3
  max_messages: 20
4
  strategy: "recent"  # recent, summary
5
  retain_period: 3600  # 保留 1 小时

长期记忆#

长期记忆配置：

PRTCL // YAML

1
长期记忆:
2
  enabled: true
3
  storage: "vector_db"  # vector_db, file, database
4
  retrieval:
5
    top_k: 5
6
    threshold: 0.7

上下文管理#

上下文配置：

PRTCL // YAML

1
上下文管理:
2
  enabled: true
3
  context_window: 8000  # 上下文窗口大小
4
  retain_strategy: "hybrid"  # recent, summary, hybrid
5
  compression:
6
    enabled: true
7
    threshold: 0.8

使用示例#

研究助手#

目标：自动检索和总结信息

配置：

PRTCL // YAML

1
Agent 节点配置:
2
  goal: "帮助用户研究特定主题"
3
  instruction: |
4
    你是一个研究助手，可以：
5
    1. 搜索网络信息
6
    2. 读取学术文献
7
    3. 分析数据
8
    4. 生成研究报告
9

10
    研究步骤：
11
    1. 理解研究主题
12
    2. 搜索相关资料
13
    3. 分析关键信息
14
    4. 生成结构化报告
15
  tools:
16
    - "web_search"
17
    - "file_read"
18
    - "calculator"
19
  reasoning:
20
    strategy: "tree_of_thought"
21
    max_iterations: 5

数据分析助手#

目标：自动收集和分析数据

配置：

PRTCL // YAML

1
Agent 节点配置:
2
  goal: "帮助用户分析数据"
3
  instruction: |
4
    你是一个数据分析助手，可以：
5
    1. 读取数据文件
6
    2. 执行统计分析
7
    3. 生成可视化报告
8
    4. 提供洞察和建议
9

10
    分析步骤：
11
    1. 理解数据结构
12
    2. 执行统计分析
13
    3. 识别模式和趋势
14
    4. 生成报告和建议
15
  tools:
16
    - "file_read"
17
    - "calculator"
18
    - "database"
19
  reasoning:
20
    strategy: "react"
21
    max_iterations: 10

任务自动化助手#

目标：自动完成多步骤任务

配置：

PRTCL // YAML

1
Agent 节点配置:
2
  goal: "帮助用户完成自动化任务"
3
  instruction: |
4
    你是一个任务自动化助手，可以：
5
    1. 读取任务描述
6
    2. 分解任务步骤
7
    3. 执行每个步骤
8
    4. 汇总结果
9

10
    自动化流程：
11
    1. 理解任务需求
12
    2. 规划执行步骤
13
    3. 调用相应工具
14
    4. 监控执行过程
15
    5. 生成执行报告
16
  tools:
17
    - "file_read"
18
    - "api_call"
19
    - "web_search"
20
  reasoning:
21
    strategy: "chain_of_thought"
22
    max_iterations: 8

高级功能#

任务分解#

任务分解配置：

PRTCL // YAML

1
任务分解:
2
  enabled: true
3
  max_subtasks: 10
4
  parallel_execution: true
5
  dependency_resolution: true

错误处理#

错误处理配置：

PRTCL // YAML

1
错误处理:
2
  enabled: true
3
  strategy: "retry"  # retry, skip, stop
4
  max_retries: 3
5
  retry_delay: 5
6
  fallback_to_human: true

协作能力#

多 Agent 协作：

PRTCL // YAML

1
多 Agent 配置:
2
  enabled: true
3
  agents:
4
    - id: "researcher"
5
      role: "信息收集"
6
      tools:
7
        - "web_search"
8
        - "file_read"
9
    - id: "analyst"
10
      role: "数据分析"
11
      tools:
12
        - "calculator"
13
        - "database"
14
    - id: "writer"
15
      role: "报告撰写"
16
      tools:
17
        - "file_write"
18
  collaboration:
19
    mode: "sequential"  # sequential, parallel, hybrid

性能优化#

推理优化#

减少推理次数：

PRTCL // YAML

1
推理优化:
2
  enabled: true
3
  thought_pruning: true  # 剪枝不重要的思考
4
  action_caching: true  # 缓存工具调用结果
5
  early_stopping: true  # 提前停止

工具优化#

工具调用优化：

PRTCL // YAML

1
工具优化:
2
  enabled: true
3
  parallel_execution: true
4
  batch_size: 5
5
  timeout: 30

记忆优化#

记忆压缩：

PRTCL // YAML

1
记忆压缩:
2
  enabled: true
3
  compression_ratio: 0.5  # 压缩到 50%
4
  strategy: "summary"  # summary, keyword

监控和调试#

监控指标#

关键指标：

PRTCL // YAML

1
监控指标:
2
  - name: "推理次数"
3
    target: "< 10"
4
  - name: "工具调用次数"
5
    target: "< 20"
6
  - name: "执行时间"
7
    target: "< 300s"
8
  - name: "成功率"
9
    target: "> 90%"

调试工具#

查看推理过程：

点击 Agent 节点
查看 推理日志
分析思考过程
识别问题

查看工具调用：

查看 工具调用日志
检查输入输出
验证结果
优化配置

日志分析#

日志类型：

思考日志
行动日志
工具调用日志
错误日志

最佳实践#

设计原则#

明确目标：清晰定义 Agent 的目标
合理工具：提供必要的工具，避免过多
优化推理：选择合适的推理策略
监控性能：持续监控和优化

工具选择#

工具选择原则：

选择最相关的工具
避免冗余工具
优化工具配置
测试工具性能

推理优化#

推理优化建议：

选择合适的推理策略
设置合理的迭代次数
优化思考预算
监控推理过程

常见问题#

Q1: Agent 执行时间过长怎么办？#

解决方案：

减少 max_iterations
优化工具调用
启用 early_stopping
优化推理策略

Q2: Agent 选择错误的工具怎么办？#

解决方案：

优化工具描述
调整推理策略
增加工具权限限制
提供更多示例

Q3: 如何提高 Agent 的准确性？#

解决方案：

优化提示词
改进工具配置
增加推理迭代
收集反馈优化

资源链接#

Agent 节点文档: https://docs.dify.ai/zh/use-dify/tutorials/workflow-101/lesson-08
工具文档: https://docs.dify.ai/zh/use-dify/tools
推理策略文档: https://docs.dify.ai/zh/use-dify/reasoning

最后更新: 2026-03-12 作者: EchoHaoRan

Dify Agent 节点使用指南#

概述#

Agent 节点基础#

什么是 Agent 节点#

与 LLM 节点的区别#

适用场景#

创建 Agent 节点#

添加 Agent 节点#

基础配置#

工具配置#

可用工具#

配置工具#

自定义工具#

推理配置#

推理策略#

配置推理#

推理示例#

记忆管理#

短期记忆#

长期记忆#

上下文管理#

使用示例#

研究助手#

数据分析助手#

任务自动化助手#

高级功能#

任务分解#

错误处理#

协作能力#

性能优化#

推理优化#

工具优化#

记忆优化#

监控和调试#

监控指标#

调试工具#

日志分析#

最佳实践#

设计原则#

工具选择#

推理优化#

常见问题#

Q1: Agent 执行时间过长怎么办？#

Q2: Agent 选择错误的工具怎么办？#

Q3: 如何提高 Agent 的准确性？#

资源链接#

Dify Agent节点使用指南

Dify知识库使用指南

Ollama使用指南

CoPaw记忆系统使用指南

全面转向国产化的今天，它是你最好的入口——deepin

评论