Dify v1.4.3保姆级使用指南！低代码构建AI Agent全流程

一、创建应用

• 基于应用模板创建（新手推荐）
• 创建一个空白应用
• 通过 DSL 文件（本地/在线）创建应用

1.从模板创建应用

初次使用 Dify 时，你可能对于应用创建比较陌生。为了帮助新手用户快速了解在 Dify 上能够构建哪些类型的应用，Dify 团队内的提示词工程师已经创建好了多场景、高质量的应用模板。

你可以从导航选择 「工作室 」，在应用列表内选择 「从模板创建」。

任意选择某个模板，并将其添加至工作区。

2.创建一个新应用

如果你需要在 Dify 上创建一个空白应用，你可以从导航选择 「工作室」 ，在应用列表内选择 「从空白创建 」。

Dify 上可以创建 5 种不同的应用类型，分别是聊天助手、文本生成应用、Agent、Workflow 和 Chatflow。

创建应用时，你需要给应用起一个名字、选择合适的图标，或者上传喜爱的图片用作图标、使用一段清晰的文字描述此应用的用途，以便后续应用在团队内的使用。

3.通过 DSL 文件创建应用

Dify DSL 是由 Dify.AI 所定义的 AI 应用工程文件标准，文件格式为 YML。该标准涵盖应用在 Dify 内的基本描述、模型参数、编排配置等信息。

• 本地导入

如果你从社区或其它人那里获得了一个应用模板（DSL 文件），可以从工作室选择 「 导入 DSL 文件 」。DSL 文件导入后将直接加载原应用的所有配置信息。

• URL 导入

你也可以通过 URL 导入 DSL 文件，参考的链接格式：

https://example.com/your_dsl.yml

导入 DSL 文件时将校对文件版本号。如果 DSL 版本号差异较大，有可能会出现兼容性问题。

二、聊天助手

对话型应用采用一问一答模式与用户持续对话。

2.1适用场景

对话型应用可以用在客户服务、在线教育、医疗保健、金融服务等领域。这些应用可以帮助组织提高工作效率、减少人工成本和提供更好的用户体验。

2.2如何编排

对话型应用的编排支持：对话前提示词，变量，上下文，开场白和下一步问题建议。

下面边以做一个 面试官 的应用为例来介绍编排对话型应用。

2.3创建应用

在首页点击 “创建应用” 按钮创建应用。填上应用名称，应用类型选择 聊天助手 。

2.4编排应用

创建应用后会自动跳转到应用概览页。点击左侧菜单 编排 来编排应用。

2.5填写提示词

提示词用于约束 AI 给出专业的回复，让回应更加精确。你可以借助内置的提示生成器，编写合适的提示词。提示词内支持插入表单变量，例如 {{input}}。提示词中的变量的值会替换成用户填写的值。

示例：

1. 输入提示指令，要求给出一段面试场景的提示词。
2. 右侧内容框将自动生成提示词。
3. 你可以在提示词内插入自定义变量。

为了更好的用户体验，可以加上对话开场白：你好，{{name}}。我是你的面试官，Bob。你准备好了吗？。点击页面底部的 “添加功能” 按钮，打开 “对话开场白” 的功能：

编辑开场白时，还可以添加数个开场问题：

2.6添加上下文

如果想要让 AI 的对话范围局限在知识库内，例如企业内的客服话术规范，可以在“上下文”内引用知识库。

2.7添加文件上传

部分多模态 LLM 已原生支持处理文件，例如 Claude 3.5 Sonnet 或 Gemini 1.5 Pro。你可以在 LLM 的官方网站了解文件上传能力的支持情况。

选择具备读取文件的 LLM，开启 “文档” 功能。无需复杂配置即可让当前 Chatbot 具备文件识别能力。

2.8调试

在右侧填写用户输入项，输入内容进行调试。

若 LLM 给出的回答结果不理想，你可以调整提示词或切换不同底层模型进行效果对比。如需更进一步，同时查看不同模型对于同一个问题的回答情况，请参考多模型调试。

2.9发布应用

调试好应用后，点击右上角的 “发布” 按钮生成独立的 AI 应用。除了通过公开 URL 体验该应用，你也进行基于 APIs 的二次开发、嵌入至网站内等操作

如果想定制已发布的应用，可以 Fork 我们的开源的 WebApp 的模板。基于模板改成符合你的情景与风格需求的应用。

2.10多模型调试

聊天助手应用类型支持 “多个模型进行调试” 功能，你可以同时批量检视不同模型对于相同问题的回答效果。

最多支持同时添加 4 个大模型。

调试时如果发现效果较好的模型，点击 “单一模型进行调试” 即可进入至当前模型的单独调试页面。

三、Agent

3.1定义

智能助手（Agent Assistant），利用大语言模型的推理能力，能够自主对复杂的人类任务进行目标规划、任务拆解、工具调用、过程迭代，并在没有人类干预的情况下完成任务。

3.2如何使用智能助手

为了方便快速上手使用，你可以在“探索”中找到智能助手的应用模板，添加到自己的工作区，或者在此基础上进行自定义。在全新的 Dify 工作室中，你也可以从零编排一个专属于你自己的智能助手，帮助你完成财务报表分析、撰写报告、Logo 设计、旅程规划等任务。

选择智能助手的推理模型，智能助手的任务完成能力取决于模型推理能力，我们建议在使用智能助手时选择推理能力更强的模型系列如 gpt-4 以获得更稳定的任务完成效果。

你可以在“提示词”中编写智能助手的指令，为了能够达到更优的预期效果，你可以在指令中明确它的任务目标、工作流程、资源和限制等。

3.3添加助手需要的工具

在“上下文”中，你可以添加智能助手可以用于查询的知识库工具，这将帮助它获取外部背景知识。

在“工具”中，你可以添加需要使用的工具。工具可以扩展 LLM 的能力，比如联网搜索、科学计算或绘制图片，赋予并增强了 LLM 连接外部世界的能力。Dify 提供了两种工具类型：第一方工具和 自定义工具 。

你可以直接使用 Dify 生态提供的第一方内置工具，或者轻松导入自定义的 API 工具（目前支持 OpenAPI / Swagger 和 OpenAI Plugin 规范）。

“工具”功能允许用户借助外部能力，在 Dify 上创建出更加强大的 AI 应用。例如你可以为智能助理型应用（Agent）编排合适的工具，它可以通过任务推理、步骤拆解、调用工具完成复杂任务。

另外工具也可以方便将你的应用与其他系统或服务连接，与外部环境交互。例如代码执行、对专属信息源的访问等。你只需要在对话框中谈及需要调用的某个工具的名字，即可自动调用该工具。

3.4配置 Agent

在 Dify 上为智能助手提供了 Function calling（函数调用）和 ReAct 两种推理模式。已支持 Function Call 的模型系列如 gpt-3.5/gpt-4 拥有效果更佳、更稳定的表现，尚未支持 Function calling 的模型系列，我们支持了 ReAct 推理框架实现类似的效果。

在 Agent 配置中，你可以修改助手的迭代次数限制。

Function Calling 模式

ReAct 模式

3.5配置对话开场白

你可以为智能助手配置一套会话开场白和开场问题，配置的对话开场白将在每次用户初次对话中展示助手可以完成什么样的任务，以及可以提出的问题示例。

3.6添加文件上传

部分多模态 LLM 已原生支持处理文件，例如 Claude 3.5 Sonnet 或 Gemini 1.5 Pro。你可以在 LLM 的官方网站了解文件上传能力的支持情况。

选择具备读取文件的 LLM，开启 “文档” 功能。无需复杂配置即可让当前 Chatbot 具备文件识别能力。

3.7调试与预览

编排完智能助手之后，你可以在发布成应用之前进行调试与预览，查看助手的任务完成效果。

3.8应用发布

四、应用工具箱

在 工作室 – 应用编排 内点击 添加功能 ，打开应用工具箱

应用工具箱为 Dify 的应用提供了不同的附加功能：

4.1对话开场白

在对话类应用中，AI 会主动说第一句话或者提出问题，你可以编辑开场白的内容包括开场问题。使用对话开场白可以引导用户提问，交代应用背景，降低对话提问的使用门槛。

4.2下一步问题建议

设置下一步问题建议可以在每次对话交互后，让 AI 根据之前的对话内容继续生成 3 个提问，引导下一轮对话。

4.3文字转语音

开启后可以将 AI 回复的内容转换成自然的语音播放。

4.4语音转文字

开启后可以在应用内录音并将语音自动转换成文本。