Dify 平台 Agent 开发入门指南

在大模型技术飞速发展的今天，AI 智能体（Agent）已成为能够自主理解、规划并执行任务的 AI 应用形态。Dify 作为一个强大的 LLM 应用开发平台，让即使没有深厚编程背景的开发者也能快速构建功能丰富的 AI 智能体。

测试开发全景图：人工智能测试、智能驱动、自动化、测试开发、左移右移与DevOps的持续交付

本文将手把手带你体验在 Dify 平台上创建第一个智能体的全过程，从环境准备到实际部署。

一、Dify 平台与智能体基础

Dify 是一个专注于 LLMOps（大语言模型运维）的平台，其名字来源于"Define"和"Modify"，寓意帮助开发人员不断改进其 AI 应用程序。它提供了多种应用程序类型和模板，包括 AI 聊天机器人、代码转换器、SQL 生成器等多种应用。

与传统基于提示词的问答应用不同，Dify 智能体具备以下核心特性：

• 自主规划能力：能根据设定目标自主思考并拆解任务步骤

• 工具调用能力：可以调用各种 API 工具，如搜索引擎、计算器等

• 记忆能力：拥有短期和长期记忆，能记住对话上下文

• 人机协同：复杂任务中可请求人类介入提供决策

二、环境准备与平台配置

1. 注册 Dify 账号

你可以选择使用Dify Cloud（云端版本）或自行部署 Dify 社区版/企业版。对于初学者，推荐直接从云端版本开始，免去部署复杂性。

2. 配置模型 API 密钥

智能体需要大语言模型来驱动思考和决策，需在"设置" → "模型供应商"中配置你的 API 密钥。Dify 支持多种模型，包括 OpenAI 的 GPT 系列、Anthropic 的 Claude 系列以及国内多个大模型平台。

三、创建第一个智能体：会议纪要小助手

下面我们以创建一个"会议纪要小助手"为例，演示完整构建流程。该智能体的目标是根据用户提供的会议主题和要点，自动生成结构化的会议纪要。

步骤 1：创建新应用

登录 Dify 平台后：

1. 点击"创建应用"

2. 选择应用类型为"Agent（智能助手）"

3. 输入应用名称（如"会议纪要小助手"）

4. 添加应用描述和图标

步骤 2：编排提示词

提示词是智能体理解并执行任务的关键，需要清晰定义其角色、目标和行为规范。以下是我们会议纪要小助手的提示词示例：

# 角色你是一位专业的会议记录员，擅长将零散的会议要点整理成结构清晰、重点突出的会议纪要。
# 技能- 理解用户输入的会议主题和核心要点- 能够识别出发言人（如果提供）- 按照标准的会议纪要格式进行组织- 语言简洁、专业、客观
# 工作流程1. 接收用户输入的会议相关信息（主题、日期、参与人、讨论要点等）2. 分析信息，理解核心内容3. 如果信息不足或不清晰，可以向用户提问以获取更多细节（但尽量根据已有信息完成）4. 按照以下格式生成会议纪要：
## 会议纪要**会议主题：** [根据用户输入填充]**会议日期：** [根据用户输入或当前日期填充，若未提供可留空或询问]**参会人员：** [根据用户输入填充，若未提供可留空]**主持人：** [根据用户输入填充，若未提供可留空]**主要议题与讨论：***   [要点1]*   [要点2]*   ...**决议与行动项：***   [行动项1：负责人，截止日期]*   [行动项2：负责人，截止日期]*   ... (如果用户提供了相关信息)**其他备注：***   [根据需要添加]
5. 输出结构化的会议纪要
# 限制- 严格按照指定的格式输出- 不要编造信息，仅基于用户提供的内容生成- 如果需要联网查询通用信息（例如某个术语的解释），可以使用联网工具，但主要内容必须来自用户输入

步骤 3：选择与配置模型

在"模型与参数"设置中：

1. 选择已配置好的大语言模型（如 GPT-4、Claude 3 或 DeepSeek V3）

2. 根据任务需求调整参数（如 Temperature 值）

3. 对于文本处理任务，通常不需要过多调整默认参数

步骤 4：添加工具（可选）

虽然这个简单的会议纪要助手可以不添加特定工具，但 Dify 强大的工具调用能力是智能体的核心价值之一。

如果需要，你可以添加：

• 联网搜索工具：如 Brave Search，用于查询术语解释

• 文档处理工具：用于解析上传的会议相关文档

步骤 5：调试与预览

完成基本配置后，点击右上角的"调试与预览"，在右侧对话框中测试智能体表现：

输入："帮我整理一个会议纪要。主题是关于下季度产品营销计划的讨论。主要讨论了三个点：1. 增加社交媒体广告投放；2. 举办线上新品发布会；3. 优化官网用户体验。小明负责第一点，小红负责第二点，月底前完成。"

观察智能体的响应，检查是否符合预期，根据需要进一步优化提示词或配置。

步骤 6：发布与分享

对智能体表现满意后：

1. 点击"发布"使智能体生效

2. 可通过"访问 API"获取 API 信息，集成到自己的应用中

3. 也可以嵌入到网页中，或直接分享预览链接给他人使用

四、智能体进阶配置与优化

1. 配置推理模式

Dify 支持两种推理模式，应根据所选模型特性选择：

• Function Calling：适用于支持此模式的模型（如 GPT-3.5、GPT-4），效果更佳、更稳定

• ReAct：适用于不支持 Function Calling 的模型，通过 ReAct 推理框架实现类似效果

2. 添加上下文与知识库

在"上下文"部分，可以整合知识库工具，为智能体提供外部背景知识和信息检索能力。这对于需要专业知识的场景特别有用：

1. 创建或选择知识库

2. 上传相关文档（PDF、Word 等）

3. 配置检索参数

4. 在提示词中引导智能体使用知识库信息

3. 设置对话开场白

为智能体配置对话开场白和初始问题，帮助用户了解其功能和可提出的问题类型。这可以显著提升用户体验，特别是对于初次使用者。

五、实践建议与常见问题

1. 智能体开发最佳实践

• 提示词是灵魂：清晰、具体、结构化的提示词是智能体成功的关键

• 从小处着手：先从单一、明确的目标开始，逐步迭代增加功能

• 善用工具：思考智能体需要哪些"超能力"，并配置合适的工具

• 持续测试优化：多测试不同场景，根据反馈持续优化

2. 常见问题与解决

• 流式响应延迟：启用"消息分块传输"优化体验

• 多工具冲突：设置工具执行优先级（如先查库存再报价）

• 迭代次数过多：在 Agent 设置中调整迭代次数限制

测试开发全景图：人工智能测试、智能驱动、自动化、测试开发、左移右移与DevOps的持续交付

六、总结与展望

通过以上步骤，我们成功在 Dify 平台上创建了一个功能实用的会议纪要小助手。Dify 平台大大降低了 AI 智能体的开发门槛，使开发者能专注于任务逻辑而非技术实现细节。

Dify 智能体的潜力远不止于此，你还可以构建：

• 客服助手：导入售后 QA 文档，设定多语言回复策略

• 决策 Agent：配置"感知-分析-执行"工作流，如舆情监控→生成报告→邮件预警

• 专业助手：基于专业领域知识库，提供法律、医疗等专业咨询

随着大模型技术和 Agent 框架的不断发展，Dify 平台也在持续演进，未来将提供更强大的工具集成能力和更复杂的工作流编排功能。

希望本文能帮助你顺利完成第一个 Dify 智能体的创建，开启 AI 应用开发的新旅程！