Dify 搭建智能体应用

这篇适合谁，读完能做什么

这篇适合想做一个对话应用、让模型自己决定什么时候调用工具，而不是按固定步骤运行的人。读完你能写好提示词，添加变量和工具，接入知识库，并在发布前完成测试。

Agent 还是工作流

Agent 是一种对话式应用，模型在需要时使用工具来完成用户的请求^[1]。当你希望模型自主决定如何使用可用的工具，同时不想设计多步工作流时，就适合用 Agent。比如数据分析助手，可以自动获取实时数据、生成图表并总结发现^[1]。

另外要注意，经典版 Agent 现在被标记为 Legacy（旧版）。新版 Agent 仍处于测试版阶段，它在自己的沙箱中运行，只需构建一次，既可以作为聊天应用使用，也可以用于工作流^[1]。

怎么写提示词

提示词告诉模型该做什么、怎么回应，以及需要遵守哪些约束。在 Agent 中，提示词还要引导模型如何推理任务、何时使用工具，所以要把期望的工作流程说清楚^[1]。以下几条技巧比较实用：

• 定义角色，说明模型应扮演的角色以及应运用的专业知识^[1]。
• 指定输出格式，说明你期望的结构、长度或风格^[1]。
• 设定约束，告诉模型应避免什么、遵循什么规则^[1]。
• 引导工具使用，提及具体的工具名称，并说明何时应使用它们^[1]。
• 拆分步骤，把复杂任务拆成模型应遵循的逻辑步骤^[1]。

不知道从哪里写起，可以点击 生成，让大模型根据你的描述起草提示词。也可以改进已有的提示词：引用 current_prompt 并说明要改什么。在 理想输出 中添加示例，结果会更精准^[1]。每次生成都会保存为一个版本，方便你尝试修改、随时回退^[1]。

用变量处理会变化的输入

变量是提示词中的占位符。每个变量都会显示为一个输入字段，用户在对话开始前填写，应用运行时其值会注入提示词。用户也可以在对话中修改变量的值，提示词会随之调整^[1]。

在提示词编辑框中输入 /，选择 添加新变量，就能插入一个命名的占位符，它的详细配置在后面的 变量 部分完成^[1]。比如数据分析 Agent 可以使用 domain 变量，让用户指定自己关注的领域^[1]。

按照预期的输入选择变量类型^[1]：

• 文本：最多接受 256 个字符，适合姓名、邮箱、标题等单行的简短输入。
• 段落：没有长度限制，给用户一个多行文本框。
• 下拉选项：显示预先设定的选项。
• 数字：只接受数字输入。
• 复选框：勾选时输出 true，否则输出 false。
• 基于 API 的变量：应用运行时从外部 API 获取值，而不是由用户输入。提示词需要实时天气、数据库记录等动态数据时使用，这种变量需要配置自定义端点^[1]。

显示名称 是终端用户在每个输入字段上看到的名称^[1]。

用 Dify 工具扩展 Agent

Dify 工具让模型能与外部服务和 API 交互，比如获取实时数据、搜索网页或查询数据库^[1]。模型会根据每个查询决定是否使用工具，以及使用哪一个。要更精确地引导它，可以在提示词中提及工具名称，并说明何时应该使用^[1]。

工具需要认证时，可以选择已有的凭证，也可以新建一个。要修改默认凭证，前往 集成 > 工具 > 工具插件^[1]。

在 Agent 设置 中，最大迭代次数 限制了模型在单次请求中可以重复运行的推理-行动循环次数。每一轮包括思考、调用工具和处理结果。处理需要多次调用工具的复杂任务时可以调高，但延迟和 token 消耗也会增加^[1]。

基于你的数据生成回复

要让回复基于自己的资料而不是通用知识，可以添加经典知识库^[1]。模型会把每个用户查询与知识库的描述做相关性判断，并决定是否检索，所以提示词里无需提及知识库。知识库描述越详细，这种判断越准确^[1]。

Agent 应用本身没有应用级的检索设置，每个知识库都按各自的设置检索。添加多个知识库时，由 Agent 决定查询哪些，结果也不会跨知识库重新排序^[1]。默认在整个知识库中检索；要把范围限制到特定文档，可以启用手动或自动的元数据过滤^[1]。

允许用户上传文件

要允许终端用户上传文件，需要选择具备相应多模态能力的模型。模型支持时，就会显示 视觉、音频 或 文档 开关^[1]。

• 分辨率：设为「高」时，对复杂图片更准确，但消耗更多 token；设为「低」时，处理简单图片更快，消耗也更少^[1]。
• 上传方式：用户可以从设备上传、粘贴 URL，或两者都可以^[1]。
• 上传数量限制：用户每条消息最多可以上传的文件数量^[1]。

调试与发布

在右侧的预览面板中测试 Agent：选择模型，发送消息，查看回复^[1]。多个模型进行调试 最多可以同时运行 4 个模型，方便对比输出^[1]。

建议选择推理能力强、并且原生支持工具调用的模型^[1]。在 Agent 设置 中会自动显示 Agent 模式：原生支持的模型使用 Function Calling，其他模型使用 ReAct，此时 Dify 通过提示词策略引导它们使用工具^[1]。

对结果满意后，点击 发布 使应用可用。完整的发布选项见发布页面^[1]。

需要记住的限制

Agent 每次对话最多保留 500 条消息或 2,000 个 token 的历史记录。超出任一上限时，最早的消息会被移除，为新消息腾出空间^[1]。

下一步

Agent、知识库、工具和发布等功能的完整说明，请参阅 Dify 官方文档^[1]。

本文改编自 Dify 官方文档中的《Agent》^[1]，原文以 CC BY 4.0 许可证发布。