# Table of Contents - [欢迎使用 Dify | Dify](#-dify-dify) - [SearchApi | Dify](#searchapi-dify) - [管理知识库 | Dify](#-dify) - [Google | Dify](#google-dify) - [3. 设定索引方法与检索设置 | Dify](#3-dify) - [Bing | Dify](#bing-dify) - [AlphaVantage 股票分析 | Dify](#alphavantage-dify) - [2. 指定分段模式 | Dify](#2-dify) - [StableDiffusion | Dify](#stablediffusion-dify) - [知识库请求频率限制 | Dify](#-dify) - [SiliconFlow (支持 Flux 绘图) | Dify](#siliconflow-flux-dify) - [召回测试/引用归属 | Dify](#-dify) - [ComfyUI | Dify](#comfyui-dify) - [Dall-e | Dify](#dall-e-dify) --- # 欢迎使用 Dify | Dify **Dify** 是一款开源的大语言模型(LLM) 应用开发平台。它融合了后端即服务（Backend as Service）和 [LLMOps](/zh-hans/learn-more/extended-reading/what-is-llmops) 的理念，使开发者可以快速搭建生产级的生成式 AI 应用。即使你是非技术人员，也能参与到 AI 应用的定义和数据运营过程中。 由于 Dify 内置了构建 LLM 应用所需的关键技术栈，包括对数百个模型的支持、直观的 Prompt 编排界面、高质量的 RAG 引擎、稳健的 Agent 框架、灵活的流程编排，并同时提供了一套易用的界面和 API。这为开发者节省了许多重复造轮子的时间，使其可以专注在创新和业务需求上。 ### [](#wei-shen-me-shi-yong-dify) 为什么使用 Dify？ 你或许可以把 LangChain 这类的开发库（Library）想象为有着锤子、钉子的工具箱。与之相比，Dify 提供了更接近生产需要的完整方案，Dify 好比是一套脚手架，并且经过了精良的工程设计和软件测试。 重要的是，Dify 是**开源**的，它由一个专业的全职团队和社区共同打造。你可以基于任何模型自部署类似 Assistants API 和 GPTs 的能力，在灵活和安全的基础上，同时保持对数据的完全控制。 > 我们的社区用户对 Dify 的产品评价可以归结为简单、克制、迭代迅速。 ——路宇，Dify.AI CEO 希望以上信息和这份指南可以帮助你了解这款产品，我们相信 Dify 是为你而做的（Do It For You）。 ### [](#dify-neng-zuo-shen-me) Dify 能做什么？ Dify 一词源自 Define + Modify，意指定义并且持续的改进你的 AI 应用，它是为你而做的（Do it for you）。 * **创业**，快速的将你的 AI 应用创意变成现实，无论成功和失败都需要加速。在真实世界，已经有几十个团队通过 Dify 构建 MVP（最小可用产品）获得投资，或通过 POC（概念验证）赢得了客户的订单。 * **将 LLM 集成至已有业务**，通过引入 LLM 增强现有应用的能力，接入 Dify 的 RESTful API 从而实现 Prompt 与业务代码的解耦，在 Dify 的管理界面是跟踪数据、成本和用量，持续改进应用效果。 * **作为企业级 LLM 基础设施**，一些银行和大型互联网公司正在将 Dify 部署为企业内的 LLM 网关，加速 GenAI 技术在企业内的推广，并实现中心化的监管。 * **探索 LLM 的能力边界**，即使你是一个技术爱好者，通过 Dify 也可以轻松的实践 Prompt 工程和 Agent 技术，在 GPTs 推出以前就已经有超过 60,000 开发者在 Dify 上创建了自己的第一个应用。 ### [](#xia-yi-bu-xing-dong) 下一步行动 * 阅读[**快速开始**](/zh-hans/guides/application-orchestrate/creating-an-application) ，速览 Dify 的应用构建流程 * 了解如何[**自部署 Dify 到服务器**](/zh-hans/getting-started/install-self-hosted) 上，并[**接入开源模型**](/zh-hans/guides/model-configuration) * 了解 Dify 的[**特性规格**](/zh-hans/getting-started/readme/features-and-specifications) 和 **Roadmap** * 在 [**GitHub**](https://github.com/langgenius/dify) 上为我们点亮一颗星，并阅读我们的**贡献指南** [Next特性与技术规格](/zh-hans/getting-started/readme/features-and-specifications) Last updated 7 months ago --- # SearchApi | Dify [PreviousBing](/zh-hans/guides/tools/tool-configuration/bing) [NextStableDiffusion](/zh-hans/guides/tools/tool-configuration/stable-diffusion) Last updated 19 days ago > 工具作者 @SearchApi。 “工具”已全面升级为“插件”生态，详细的使用说明请参考[插件开发](https://docs.dify.ai/zh-hans/plugins/quick-start/install-plugins) 。以下内容已归档。 SearchApi 是一个强大的实时 SERP API，可提供来自 Google 搜索、Google 招聘、YouTube、Google 新闻等搜索引擎集合的结构化数据。以下是在 Dify 中配置和使用 SearchApi 搜索工具的步骤。 [](#id-1.-shen-qing-search-api-key) 1\. 申请 Search API Key -------------------------------------------------------------- 请在 [SearchApi](https://www.searchapi.io/) 申请 API Key。 [](#id-2.-zai-dify-nei-tian-xie-pei-zhi) 2\. 在 Dify 内填写配置 -------------------------------------------------------------- 在 Dify 导航页内轻点 `工具 > SearchApi > 去授权` 填写 API Key。 [](#id-3.-shi-yong-gong-ju) 3\. 使用工具 ----------------------------------------- 你可以在以下应用类型中使用 SearchApi 工具。 * **Chatflow / Workflow 应用** Chatflow 和 Workflow 应用均支持添加 `SearchApi` 系列工具节点，提供 Google Jobs API，Google News API，Google Search API，YouTube 脚本 API 四种工具。 * **Agent 应用** 在 Agent 应用内选择需要添加的 `SearchApi` 工具，然后输入指令调用工具。 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-24f2f87379bf03bc5fe924b7ee65c9acaa345b88%252Fzh-tool-searchapi.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=783739d7&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-6de911e4ee655e198d94992288f09ecf63ff0400%252Fzh-tool-searchapi-flow.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=e4fa09e0&sv=2) --- # 管理知识库 | Dify [Previous3\. 设定索引方法与检索设置](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods) [Next维护知识库内文档](/zh-hans/guides/knowledge-base/knowledge-and-documents-maintenance/maintain-knowledge-documents) Last updated 1 month ago > 知识库管理页仅面向团队所有者、团队管理员、拥有编辑权限的角色开放。 点击 Dify 平台顶部的 “知识库” 按钮，选择需要管理的知识库。轻点左侧导航中的**设置**进行调整。 你可以在此处调整知识库名称、描述、可见权限、索引模式、Embedding 模型和检索设置。 知识库设置 * **知识库名称**，用于区分不同的知识库。 * **知识库描述**，用于描述知识库内文档代表的信息。 * **可见权限**，提供 **“只有我”** 、**“所有团队成员”** 和 **“部分团队成员”** 三种权限范围。不具有权限的人将无法访问该知识库。若选择将知识库公开至其它成员，则意味着其它成员同样具备该知识库的查看、编辑和删除权限。 * **索引方法**，详细说明请参考[索引方法文档](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods) 。 * **Embedding 模型**， 修改知识库的嵌入模型，修改 Embedding 模型将对知识库内的所有文档重新嵌入，原先的嵌入将会被删除。 * **检索设置**，详细说明请参考[检索设置文档](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods) 。 * * * #### [](#cha-kan-zhi-shi-ku-nei-yi-guan-lian-de-ying-yong) 查看知识库内已关联的应用 知识库将会在左侧信息栏中显示已关联的应用数量。将鼠标悬停至圆形信息图标时将显示所有已关联的 Apps 列表，点击右侧的跳转按钮即可快速查看对应的应用。 * * * 你可以通过网页维护或 API 两种方式维护知识库内的文档。 #### [](#wei-hu-zhi-shi-ku-nei-wen-dang) 维护知识库内文档 支持管理知识库内的文档和对应的文档分段。详细说明请参考以下文档： #### [](#shi-yong-api-wei-hu-zhi-shi-ku) 使用 API 维护知识库 Dify 知识库提供整套标准 API ，开发者通过 API 调用对知识库内的文档、分段进行增删改查等日常管理维护操作，请参考以下文档： 查看已关联应用 [维护知识库内文档](/zh-hans/guides/knowledge-base/knowledge-and-documents-maintenance/maintain-knowledge-documents) [通过 API 维护知识库](/zh-hans/guides/knowledge-base/knowledge-and-documents-maintenance/maintain-dataset-via-api) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F28899b9b0eba8996f364fb74e5b94c7f.png&width=768&dpr=4&quality=100&sign=de00f8f&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F20fc93428f8f20f7acfce665c4ed4ddf.png&width=768&dpr=4&quality=100&sign=df16db3e&sv=2) 通过 API 管理文档 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252FqqERjUP6VxL7DjsBbpks%252Fimage.png%3Falt%3Dmedia%26token%3D2ae1af89-6620-4cc6-8bb6-20bf47e879de&width=768&dpr=4&quality=100&sign=619c60b0&sv=2) --- # Google | Dify [Previous工具配置](/zh-hans/guides/tools/tool-configuration) [NextBing](/zh-hans/guides/tools/tool-configuration/bing) Last updated 19 days ago > 工具作者 @Dify。 “工具”已全面升级为“插件”生态，详细的使用说明请参考[插件开发](https://docs.dify.ai/zh-hans/plugins/quick-start/install-plugins) 。以下内容已归档。 Google 搜索工具能够帮助你在使用 LLM 应用的时候，获取联网搜索结果。以下是在 Dify 中配置和使用 Google 搜索工具的步骤。 [](#id-1.-shen-qing-serp-api-key) 1\. 申请 Serp API Key ---------------------------------------------------------- 请在 [Serp 平台](https://serpapi.com/dashboard) 申请 API Key。 [](#id-2.-zai-dify-nei-tian-xie-pei-zhi) 2\. 在 Dify 内填写配置 -------------------------------------------------------------- 在 Dify 导航页内轻点 `工具 > Google > 去授权` 填写 API Key。 [](#id-3.-shi-yong-gong-ju) 3\. 使用工具 ----------------------------------------- 你可以在以下应用类型中使用 Google 工具。 * **Chatflow / Workflow 应用** Chatflow 和 Workflow 应用均支持添加 `Google` 工具节点。 * **Agent 应用** 在 Agent 应用内添加 `Google` 工具，然后输入在线搜索指令，调用此工具。 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-8bc9cbaeea848b30dd0e98b279af2de820ef8dfc%252Fzh-tools-google.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=dd86c92a&sv=2) --- # 3. 设定索引方法与检索设置 | Dify [Previous2\. 指定分段模式](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/chunking-and-cleaning-text) [Next管理知识库](/zh-hans/guides/knowledge-base/knowledge-and-documents-maintenance) Last updated 1 month ago 选定内容的分段模式后，接下来设定对于结构化内容的**索引方法**与**检索设置**。 ### [](#she-ding-suo-yin-fang-fa) 设定索引方法 正如搜索引擎通过高效的索引算法匹配与用户问题最相关的网页内容，索引方式是否合理将直接影响 LLM 对知识库内容的检索效率以及回答的准确性。 提供“\*\*高质量”\*\*与”**经济“** 两种索引方法，其中分别提供不同的检索设置选项： **注意：** 原 \*\*Q&A 模式（仅适用于社区版）\*\*已成为高质量索引方法下的一个可选项。 高质量经济 **高质量** 在高质量模式下，使用 Embedding 嵌入模型将已分段的文本块转换为数字向量，帮助更加有效地压缩与存储大量文本信息；**使得用户问题与文本之间的匹配能够更加精准**。 将内容块向量化并录入至数据库后，需要通过有效的检索方式调取与用户问题相匹配的内容块。高质量模式提供向量检索、全文检索和混合检索三种检索设置。关于各个设置的详细说明，请继续阅读[检索设置](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods#retrieval_settings) 。 选择高质量模式后，当前知识库的索引方式无法在后续降级为 **“经济”索引模式**。如需切换，建议重新创建知识库并重选索引方式。 > 如需了解更多关于嵌入技术与向量的说明，请参考[《Embedding 技术与 Dify》](https://mp.weixin.qq.com/s/vmY_CUmETo2IpEBf1nEGLQ) > 。 高质量模式 **启用 Q&A 模式（可选，仅适用于**[**社区版**](/zh-hans/getting-started/install-self-hosted) **）** 开启该模式后，系统将对已上传的文本进行分段。总结内容后为每个分段自动生成 Q&A 匹配对。与常见的 「Q to P」（用户问题匹配文本段落）策略不同，QA 模式采用 「Q to Q」（问题匹配问题）策略。 这是因为 「常见问题」 文档里的文本**通常是具备完整语法结构的自然语言**，Q to Q 模式会令问题和答案的匹配更加清晰，并同时满足一些高频和高相似度问题的提问场景。 > **Q&A 模式仅支持处理 「中英日」 三语。启用该模式后可能会消耗更多的 LLM Tokens，并且无法使用**[**经济型索引方法**](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods#jing-ji) > **。** 当用户提问时，系统会找出与之最相似的问题，然后返回对应的分段作为答案。这种方式更加精确，因为它直接针对用户问题进行匹配，可以更准确地帮助用户检索真正需要的信息。 **经济** 在经济模式下，每个区块内使用 10 个关键词进行检索，降低了准确度但无需产生费用。对于检索到的区块，仅提供倒排索引方式选择最相关的区块，详细说明请阅读[下文](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods#dao-pai-suo-yin) 。 选择经济型索引方式后，若感觉实际的效果不佳，可以在知识库设置页中升级为 **“高质量”索引方式**。 ### [](#retrieval_settings) 指定检索方式 知识库在接收到用户查询问题后，按照预设的检索方式在已有的文档内查找相关内容，提取出高度相关的信息片段供语言模型生成高质量答案。这将决定 LLM 所能获取的背景信息，从而影响生成结果的准确性和可信度。 常见的检索方式包括基于向量相似度的语义检索，以及基于关键词的精准匹配：前者将文本内容块和问题查询转化为向量，通过计算向量相似度匹配更深层次的语义关联；后者通过倒排索引，即搜索引擎常用的检索方法，匹配问题与关键内容。 不同的索引方法对应差异化的检索设置。 高质量索引经济索引 **高质量索引** 在高质量索引方式下，Dify 提供向量检索、全文检索与混合检索设置： **向量检索** **定义：** 向量化用户输入的问题并生成查询文本的数学向量，比较查询向量与知识库内对应的文本向量间的距离，寻找相邻的分段内容。 **向量检索设置：** **Rerank 模型：** 默认关闭。开启后将使用第三方 Rerank 模型再一次重排序由向量检索召回的内容分段，以优化排序结果。帮助 LLM 获取更加精确的内容，辅助其提升输出的质量。开启该选项前，需前往“设置” → “模型供应商”，提前配置 Rerank 模型的 API 秘钥。 > 开启该功能后，将消耗 Rerank 模型的 Tokens，详情请参考对应模型的价格说明。 **TopK：** 用于筛选与用户问题相似度最高的文本片段。系统同时会根据选用模型上下文窗口大小动态调整片段数量。默认值为 3，数值越高，预期被召回的文本分段数量越多。 **Score 阈值：** 用于设置文本片段筛选的相似度阈值，只召回超过设置分数的文本片段，默认值为 0.5。数值越高说明对于文本与问题要求的相似度越高，预期被召回的文本数量也越少。 > TopK 和 Score 设置仅在 Rerank 步骤生效，因此需要添加并开启 Rerank 模型才能应用两者中的设置参数。 * * * **全文检索** **定义：** 关键词检索，即索引文档中的所有词汇。用户输入问题后，通过明文关键词匹配知识库内对应的文本片段，返回符合关键词的文本片段；类似搜索引擎中的明文检索。 **Rerank 模型：** 默认关闭。开启后将使用第三方 Rerank 模型再一次重排序由全文检索召回的内容分段，以优化排序结果。向 LLM 发送经过重排序的分段，辅助其提升输出的内容质量。开启该选项前，需前往“设置” → “模型供应商”，提前配置 Rerank 模型的 API 秘钥。 > 开启该功能后，将消耗 Rerank 模型的 Tokens，详情请参考对应模型的价格说明。 **TopK：** 用于筛选与用户问题相似度最高的文本片段。系统同时会根据选用模型上下文窗口大小动态调整片段数量。系统默认值为 3 。数值越高，预期被召回的文本分段数量越多。 **Score 阈值：** 用于设置文本片段筛选的相似度阈值，只召回超过设置分数的文本片段，默认值为 0.5。数值越高说明对于文本与问题要求的相似度越高，预期被召回的文本数量也越少。 > TopK 和 Score 设置仅在 Rerank 步骤生效，因此需要添加并开启 Rerank 模型才能应用两者中的设置参数。 * * * **混合检索** **定义：** 同时执行全文检索和向量检索，或 Rerank 模型，从查询结果中选择匹配用户问题的最佳结果。 在混合检索设置内可以选择启用 **“权重设置”** 或 **“Rerank 模型”**。 * **权重设置** 允许用户赋予语义优先和关键词优先自定义的权重。关键词检索指的是在知识库内进行全文检索（Full Text Search），语义检索指的是在知识库内进行向量检索（Vector Search）。 * **将语义值拉至 1** **仅启用语义检索模式**。借助 Embedding 模型，即便知识库中没有出现查询中的确切词汇，也能通过计算向量距离的方式提高搜索的深度，返回正确内容。此外，当需要处理多语言内容时，语义检索能够捕捉不同语言之间的意义转换，提供更加准确的跨语言搜索结果。 * **将关键词的值拉至 1** **仅启用关键词检索模式**。通过用户输入的信息文本在知识库全文匹配，适用于用户知道确切的信息或术语的场景。该方法所消耗的计算资源较低，适合在大量文档的知识库内快速检索。 * **自定义关键词和语义权重** 除了将不同的数值拉至 1，你还可以不断调试二者的权重，找到符合业务场景的最佳权重比例。 > 语义检索指的是比对用户问题与知识库内容中的向量距离。距离越近，匹配的概率越大。参考阅读：[《Dify：Embedding 技术与 Dify 知识库设计/规划》](https://mp.weixin.qq.com/s/vmY_CUmETo2IpEBf1nEGLQ) > 。 * * * * **Rerank 模型** 默认关闭。开启后将使用第三方 Rerank 模型再一次重排序由混合检索召回的内容分段，以优化排序结果。向 LLM 发送经过重排序的分段，辅助其提升输出的内容质量。开启该选项前，需前往“设置” → “模型供应商”，提前配置 Rerank 模型的 API 秘钥。 > 开启该功能后，将消耗 Rerank 模型的 Tokens，详情请参考对应模型的价格说明。 **“权重设置”** 和 **“Rerank 模型”** 设置内支持启用以下选项： **TopK：** 用于筛选与用户问题相似度最高的文本片段。系统同时会根据选用模型上下文窗口大小动态调整片段数量。系统默认值为 3 。数值越高，预期被召回的文本分段数量越多。 **Score 阈值：** 用于设置文本片段筛选的相似度阈值，即：只召回超过设置分数的文本片段。系统默认关闭该设置，即不会对召回的文本片段相似值过滤。打开后默认值为 0.5。数值越高，预期被召回的文本数量越少。 #### [](#jing-ji-suo-yin-1) 经济索引 **倒排索引** 在经济索引方式下，仅提供**倒排索引方式**。这是一种用于快速检索文档中关键词的索引结构，常用于在线搜索引擎。倒排索引仅支持 **TopK** 设置项。 **TopK：** 用于筛选与用户问题相似度最高的文本片段。系统同时会根据选用模型上下文窗口大小动态调整片段数量。系统默认值为 3 。数值越高，预期被召回的文本分段数量越多。 ### [](#yue-du-geng-duo) 阅读更多 指定检索设置后，你可以参考以下文档查看在实际场景下，关键词与内容块的匹配情况。 [召回测试/引用归属](/zh-hans/guides/knowledge-base/retrieval-test-and-citation) Q&A Chunking Q to P 与 Q to Q 的索引模式区别 经济模式 检索设置 向量检索 全文检索 混合检索 倒排索引 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F3b86e6b484da39452c164cb6372a7242.png&width=768&dpr=4&quality=100&sign=44801f4e&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F70960a237d4f5eaed2dbf46a2cca2bf7.png&width=768&dpr=4&quality=100&sign=a5229ff7&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F8745ccabff56290eae329a9d3592f745.png&width=768&dpr=4&quality=100&sign=8f07ada8&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F51442c8fcd05479616a3dd8279a4853a.png&width=768&dpr=4&quality=100&sign=245a5e37&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F620044faa47a5037f85b32a27a56fce5.png&width=768&dpr=4&quality=100&sign=3e1cdf6f&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F9b02fc353324221cc91f185a350775b6.png&width=768&dpr=4&quality=100&sign=e065752a&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2Fbd2621bfe8a1a8e21fca0743ec495a9e.png&width=768&dpr=4&quality=100&sign=c2942f0f&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2Fb417cd028131d34779993fbcbb8dbdd7.png&width=768&dpr=4&quality=100&sign=d1e8c7ae&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F513bff1ca38ec746b3246502b0311b39.png&width=768&dpr=4&quality=100&sign=668aab36&sv=2) --- # Bing | Dify [PreviousGoogle](/zh-hans/guides/tools/tool-configuration/google) [NextSearchApi](/zh-hans/guides/tools/tool-configuration/searchapi) Last updated 19 days ago > 工具作者 @Dify。 「ツール」は「プラグイン」エコシステムに完全アップグレードされました。詳しい使用方法については[プラグイン開発](https://docs.dify.ai/ja-jp/plugins/quick-start/install-plugins) をご参照ください。以下の内容はアーカイブされています。 Bing 搜索工具能够帮助你在使用 LLM 应用的时候，获取联网搜索结果。以下是在 Dify 中配置和使用 Bing 搜索工具的步骤。 [](#id-1.-shen-qing-bing-api-key) 1\. 申请 Bing API Key ---------------------------------------------------------- 请在 [Azure 平台](https://platform.openai.com/) 申请 API Key。 [](#id-2.-zai-dify-nei-tian-xie-pei-zhi) 2\. 在 Dify 内填写配置 -------------------------------------------------------------- 在 Dify 导航页内轻点 `工具 > Azure > 去授权` 填写 API Key。 [](#id-3.-shi-yong-gong-ju) 3\. 使用工具 ----------------------------------------- 你可以在以下应用类型中使用 Bing 工具。 * **Chatflow / Workflow 应用** Chatflow 和 Workflow 应用均支持添加 `Bing` 工具节点。 * **Agent 应用** 在 Agent 应用内添加 `Bing` 工具，然后输入在线搜索指令，调用此工具。 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fimg%2Fzh-tools-bing.png&width=768&dpr=4&quality=100&sign=72d33d13&sv=2) --- # AlphaVantage 股票分析 | Dify > 工具作者 [@zhuhao](https://github.com/hwzhuhao) > 。 “工具”已全面升级为“插件”生态，详细的使用说明请参考[插件开发](https://docs.dify.ai/zh-hans/plugins/quick-start/install-plugins) 。以下内容已归档。 AlphaVantage 一个在线平台，它提供金融市场数据和API，便于个人投资者和开发者获取股票报价、技术指标和股票分析。本 [](#id-1.-shen-qing-alphavantage-api-key) 1\. 申请 AlphaVantage API Key -------------------------------------------------------------------------- 请在 [AlphaVantage](https://www.alphavantage.co/support/#api-key) 申请 API Key。 [](#id-2.-zai-dify-nei-tian-xie-pei-zhi) 2\. 在 Dify 内填写配置 -------------------------------------------------------------- 在 Dify 导航页内轻点 `工具 > AlphaVantage > 去授权` 填写 API Key。 [](#id-3.-shi-yong-gong-ju) 3\. 使用工具 ----------------------------------------- * **Chatflow / Workflow 应用** Chatflow 和 Workflow 应用均支持添加 `AlphaVantage` 工具节点。添加后，需要在节点内的 “输入变量 → 股票代码” 通过[变量](https://docs.dify.ai/v/zh-hans/guides/workflow/variables) 引用用户输入的查询内容。最后在 “结束” 节点内使用变量引用 `AlphaVantage` 节点输出的内容。 * **Agent 应用** 在 Agent 应用内添加 `AlphaVantage` 工具，然后在对话框内发送股票代码或大致描述，调用工具得到准确的金融数据。 [PreviousPerplexity Search](/zh-hans/guides/tools/tool-configuration/perplexity) [NextYoutube](/zh-hans/guides/tools/tool-configuration/youtube) Last updated 19 days ago --- # 2. 指定分段模式 | Dify [Previous1.2 从网页导入数据](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/import-content-data/sync-from-website) [Next3\. 设定索引方法与检索设置](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods) Last updated 1 month ago 将内容上传至知识库后，接下来需要对内容进行分段与数据清洗。**该阶段是内容的预处理与数据结构化过程，长文本将会被划分为多个内容分段。** 什么是分段与清洗策略？[](#shen-me-shi-fen-duan-yu-qing-xi-ce-le) * **分段** 由于大语言模型的上下文窗口有限，无法一次性处理和传输整个知识库的内容，因此需要对文档中的长文本分段为内容块。即便部分大模型已支持上传完整的文档文件，但实验表明，检索效率依然弱于检索单个内容分段。 LLM 能否精准地回答出知识库中的内容，关键在于知识库对内容块的检索与召回效果。类似于在手册中查找关键章节即可快速得到答案，而无需逐字逐句分析整个文档。经过分段后，知识库能够基于用户问题，采用分段 TopK 召回模式，召回与问题高度相关的内容块，补全关键信息从而提高回答的精准性。 在进行问题与内容块的语义匹配时，合理的分段大小非常关键，它能够帮助模型准确地找到与问题最相关的内容，减少噪音信息。过大或过小的分段都可能影响召回的效果。 Dify 提供了 **“通用分段”** 和 **“父子分段”** 两种分段模式，分别适应不同类型的文档结构和应用场景，满足不同的知识库检索和召回的效率与准确性要求。 * **清洗** 为了保证文本召回的效果，通常需要在将数据录入知识库之前便对其进行清理。例如，文本内容中存在无意义的字符或者空行可能会影响问题回复的质量，需要对其清洗。Dify 已内置的自动清洗策略，详细说明请参考 [ETL](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/chunking-and-cleaning-text#etl) 。 LLM 收到用户问题后，能否精准地回答出知识库中的内容，取决于知识库对内容块的检索和召回效果。匹配与问题相关度高的文本分段对 AI 应用生成准确且全面的回应至关重要。 好比在智能客服场景下，仅需帮助 LLM 定位至工具手册的关键章节内容块即可快速得到用户问题的答案，而无需重复分析整个文档。在节省分析过程中所耗费的 Tokens 的同时，提高 AI 应用的问答质量。 ### [](#fen-duan-mo-shi) 分段模式 知识库支持两种分段模式：**通用模式**与**父子模式**。如果你是首次创建知识库，建议选择父子模式。 **注意**：原 **“自动分段与清洗”** 模式已自动更新为 **“通用”** 模式。无需进行任何更改，原知识库保持默认设置即可继续使用。选定分段模式并完成知识库的创建后，后续无法变更。知识库内新增的文档也将遵循同样的分段模式。 通用模式与父子分段模式 #### [](#tong-yong-mo-shi) 通用模式 系统按照用户自定义的规则将内容拆分为独立的分段。当用户输入问题后，系统自动分析问题中的关键词，并计算关键词与知识库中各内容分段的相关度。根据相关度排序，选取最相关的内容分段并发送给 LLM，辅助其处理与更有效地回答。 在该模式下，你需要根据不同的文档格式或场景要求，参考以下设置项，手动设置文本的**分段规则**。 * **分段标识符**，默认值为 `\n`，即按照文章段落进行分块。你可以遵循[正则表达式语法](https://regexr.com/) 自定义分块规则，系统将在文本出现分段标识符时自动执行分段。例如 的含义是按照句子进行分段。下图是不同语法的文本分段效果： * **分段最大长度**，指定分段内的文本字符数最大上限，超出该长度时将强制分段。默认值为 500 Tokens，分段长度的最大上限为 4000 Tokens； * **分段重叠长度**，指的是在对数据进行分段时，段与段之间存在一定的重叠部分。这种重叠可以帮助提高信息的保留和分析的准确性，提升召回效果。建议设置为分段长度 Tokens 数的 10-25%； **文本预处理规则，** 过滤知识库内部分无意义的内容。提供以下选项： * 替换连续的空格、换行符和制表符 * 删除所有 URL 和电子邮件地址 配置完成后，点击“预览区块”即可查看分段后的效果。你可以直观的看到每个区块的字符数。如果重新修改了分段规则，需要重新点击按钮以查看新的内容分段。 若同时批量上传了多个文档，轻点顶部的文档标题，快速切换并查看其它文档的分段效果。 分段规则设置完成后，接下来需指定索引方式。支持“高质量索引”和“经济索引”，详细说明请参考[设定索引方法](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods) 。 #### [](#fu-zi-mo-shi) **父子模式** 与**通用模式**相比，父子模式采用双层分段结构来平衡检索的精确度和上下文信息,让精准匹配与全面的上下文信息二者兼得。 其中，父区块（Parent-chunk）保持较大的文本单位（如段落），提供丰富的上下文信息；子区块（Child-chunk）则是较小的文本单位（如句子），用于精确检索。系统首先通过子区块进行精确检索以确保相关性，然后获取对应的父区块来补充上下文信息，从而在生成响应时既保证准确性又能提供完整的背景信息。你可以通过设置分隔符和最大长度来自定义父子区块的分段方式。 例如在 AI 智能客服场景下，用户输入的问题将定位至解决方案文档内某个具体的句子，随后将该句子所在的段落或章节，联同发送至 LLM，补全该问题的完整背景信息，给出更加精准的回答。 其基本机制包括： * **子分段匹配查询**： * 将文档拆分为较小、集中的信息单元（例如一句话），更加精准的匹配用户所输入的问题。 * 子分段能快速提供与用户需求最相关的初步结果。 * **父分段提供上下文**： * 将包含匹配子分段的更大部分（如段落、章节甚至整个文档）视作父分段并提供给大语言模型（LLM）。 * 父分段能为 LLM 提供完整的背景信息，避免遗漏重要细节，帮助 LLM 输出更贴合知识库内容的回答。 在该模式下，你需要根据不同的文档格式或场景要求，手动分别设置父子分段的**分段规则**。 **父分段：** 父分段设置提供以下分段选项： * **段落** 根据预设的分隔符规则和最大块长度将文本拆分为段落。每个段落视为父分段，适用于文本量较大，内容清晰且段落相对独立的文档。支持以下设置项： * **分段标识符**，默认值为 `\n`，即按照文本段落分段。你可以遵循[正则表达式语法](https://regexr.com/) 自定义分块规则，系统将在文本出现分段标识符时自动执行分段。 * **分段最大长度**，指定分段内的文本字符数最大上限，超出该长度时将强制分段。默认值为 500 Tokens，分段长度的最大上限为 4000 Tokens； * **全文** 不进行段落分段，而是直接将全文视为单一父分段。出于性能原因，仅保留文本内的前 10000 Tokens 字符，适用于文本量较小，但段落间互有关联，需要完整检索全文的场景。 **子分段：** 子分段文本是在父文本分段基础上，由分隔符规则切分而成，用于查找和匹配与问题关键词最相关和直接的信息。如果使用默认的子分段规则，通常呈现以下分段效果： * 当父分段为段落时，子分段对应各个段落中的单个句子。 * 父分段为全文时，子分段对应全文中各个单独的句子。 在子分段内填写以下分段设置： * **分段标识符**，默认值为 ，即按照句子进行分段。你可以遵循[正则表达式语法](https://regexr.com/) 自定义分块规则，系统将在文本出现分段标识符时自动执行分段。 * **分段最大长度**，指定分段内的文本字符数最大上限，超出该长度时将强制分段。默认值为 200 Tokens，分段长度的最大上限为 4000 Tokens； 你还可以使用**文本预处理规则**过滤知识库内部分无意义的内容： * 替换连续的空格、换行符和制表符 * 删除所有 URL 和电子邮件地址 配置完成后，点击“预览区块”即可查看分段后的效果。你可以查看父分段的整体字符数。背景标蓝的字符为子分块，同时显示当前子段的字符数。 如果重新修改了分段规则，需要重新点击“预览区块”按钮以查看新的内容分段。若同时批量上传了多个文档，轻点顶部的文档标题，快速切换至其它文档并预览内容的分段效果。 为了确保内容检索的准确性，父子分段模式仅支持使用[“高质量索引”](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/chunking-and-cleaning-text#gao-zhi-liang-suo-yin) 。 ### [](#liang-zhong-mo-shi-de-qu-bie-shi-shen-me) 两种模式的区别是什么？ 两者的主要区别在于内容区块的分段形式。**通用模式**的分段结果为多个独立的内容分段，而**父子模式**采用双层结构进行内容分段，即单个父分段的内容（文档全文或段落）内包含多个子分段内容（句子）。 不同的分段方式将影响 LLM 对于知识库内容的检索效果。在相同文档中，采用父子检索所提供的上下文信息会更全面，且在精准度方面也能保持较高水平，大大优于传统的单层通用检索方式。 ### [](#yue-du-geng-duo) 阅读更多 选定分段模式后，接下来你可以参考以下文档分别设定索引方式和检索方式，完成知识库的创建。 不同分段标识符语法的分段效果 通用模式 父子召回原理图 父子模式下的段落和全文预览 父子分段模式 通用模式与父子模式的内容检索效果对比 [3\. 设定索引方法与检索设置](/zh-hans/guides/knowledge-base/create-knowledge-and-upload-documents/setting-indexing-methods) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2Fe3814336710d445a99a9ded3d251622b.png&width=768&dpr=4&quality=100&sign=6c89023a&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F2c19c1c1a0446c00e3c07d6f4c8968e4.png&width=768&dpr=4&quality=100&sign=2442faa7&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F3e6820c10bd7c5f6884930e3a14e7b66.png&width=768&dpr=4&quality=100&sign=3b0f2bfe&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2Faf5c9a68f85120a6ea687bf93ecfb80a.png&width=768&dpr=4&quality=100&sign=f67f13b3&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2Fb3ec2ce860550563234ca22967abdd17.png&width=768&dpr=4&quality=100&sign=fb516d94&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2Fb3052a6aae6e4d0e5701dde3a859e326.png&width=768&dpr=4&quality=100&sign=91b34a69&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F0b614c6a07c6ea2151fe17d85ce6a1d1.png&width=768&dpr=4&quality=100&sign=b24059c0&sv=2) --- # StableDiffusion | Dify > 工具作者 @Dify。 “工具”已全面升级为“插件”生态，详细的使用说明请参考[插件开发](https://docs.dify.ai/zh-hans/plugins/quick-start/install-plugins) 。以下内容已归档。 StableDiffusion 是一种基于文本提示生成图像的工具，Dify 已经实现了访问 Stable Diffusion WebUI API 的接口，因此你可以直接在 Dify 中使用它。以下是在 Dify 中集成 Stable Diffusion 的步骤。 [](#id-1.-chu-shi-hua-ben-di-huan-jing) 1\. 初始化本地环境 -------------------------------------------------------- 推荐使用装有较强 GPU 的机器来安装和驱动 Stable Diffusion，但这并不是必须的，你也可以使用 CPU 来生成图像，但速度可能会很慢。 [](#id-2.-an-zhuang-bing-qi-dong-stable-diffusion-webui) 2\. 安装并启动 Stable Diffusion WebUI ---------------------------------------------------------------------------------------------- 1. 从[官方仓库](https://github.com/AUTOMATIC1111/stable-diffusion-webui) 克隆 Stable Diffusion WebUI 仓库 Copy git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui 1. 运行命令启动 Stable Diffusion WebUI。 克隆仓库后，切换到仓库目录。根据系统的不同，可能需要使用不同的命令来启动 WebUI。 #### [](#windows) Windows Copy cd stable-diffusion-webui ./webui.bat --api --listen #### [](#linux) Linux Copy cd stable-diffusion-webui ./webui.sh --api --listen 1. 准备模型 现在你可以根据终端中显示的地址在浏览器中访问 Stable Diffusion WebUI，但模型还不可用。你需要从 HuggingFace 或其他来源下载模型，并将其放在 Stable Diffusion WebUI 的 `models` 目录中。 例如，我们使用 [pastel-mix](https://huggingface.co/JamesFlare/pastel-mix) 作为模型，使用 `git lfs` 下载模型并将其放在 `stable-diffusion-webui` 的 `models` 目录中。 Copy git clone https://huggingface.co/JamesFlare/pastel-mix 1. 获取模型名称 现在你可以在模型列表中看到 `pastel-mix`，但我们仍然需要获取模型名称，访问 `http://your_id:port/sdapi/v1/sd-models`，你将看到如下的模型名称。 Copy [\ {\ "title": "pastel-mix/pastelmix-better-vae-fp32.ckpt [943a810f75]",\ "model_name": "pastel-mix_pastelmix-better-vae-fp32",\ "hash": "943a810f75",\ "sha256": "943a810f7538b32f9d81dc5adea3792c07219964c8a8734565931fcec90d762d",\ "filename": "/home/takatost/stable-diffusion-webui/models/Stable-diffusion/pastel-mix/pastelmix-better-vae-fp32.ckpt",\ "config": null\ },\ ] `model_name` 就是我们需要的，这个例子中是 `pastel-mix_pastelmix-better-vae-fp32`。 [](#id-3.-zai-dify-ji-cheng-stable-diffusion) 3\. 在 Dify 集成 Stable Diffusion --------------------------------------------------------------------------------- 在 `工具 > StableDiffusion > 去认证` 中填写你在之前步骤中获取的认证信息和模型配置。 [](#id-4.-wan-cheng) 4\. 完成 -------------------------------- * **Chatflow / Workflow 应用** Chatflow 和 Workflow 应用均支持添加 `Stable Diffusion` 工具节点。添加后，需要在节点内的 “输入变量 → 提示词” 内填写[变量](https://docs.dify.ai/v/zh-hans/guides/workflow/variables) 引用用户输入的提示词，或者是上一节点生成的内容。最后在 “结束” 节点内使用变量引用 `Stable Diffusion` 输出的图像。 * **Agent 应用** 在 Agent 应用内添加 `Stable Diffusion` 工具，然后在对话框内发送图片描述，调用工具生成 AI 图像。 [PreviousSearchApi](/zh-hans/guides/tools/tool-configuration/searchapi) [NextDall-e](/zh-hans/guides/tools/tool-configuration/dall-e) Last updated 19 days ago --- # 知识库请求频率限制 | Dify 为了维护 Dify 云服务系统的稳定性，并提升所有用户的知识库使用体验，我们将从 **2025 年 2 月 24 日** 起引入知识库请求频率限制（Knowledge Request Rate Limit）。 [](#shen-me-shi-zhi-shi-ku-qing-qiu-pinlxian-zhi) 什么是知识库请求频率限制？ -------------------------------------------------------------------- 知识库请求频率限制，指一个工作区在知识库中每分钟可执行的最大操作数。这些操作包括数据集创建、文档管理，以及在应用或工作流中的知识库查询。 [](#bu-tong-ding-yue-ban-ben-de-xian-zhi) 不同订阅版本的限制 -------------------------------------------------------- * **Sandbox**：10 次/分钟 * **Professional**：100 次/分钟 * **Team**：1,000 次/分钟 例如，对于 **Sandbox 用户**，如果在 1 分钟内执行了 10 次命中测试，该用户的工作区将在接下来的 1 分钟内暂时无法执行受知识库请求频率限制的操作。 [](#na-xie-cao-zuo-hui-shou-dao-zhi-shi-ku-qing-qiu-pinlxian-zhi) 哪些操作会受到知识库请求频率限制？ ---------------------------------------------------------------------------------------- 当你执行以下操作时，会受到知识库请求频率限制： 1. 创建空数据集 2. 删除数据集 3. 更新数据集设置 4. 上传文档 5. 删除文档 6. 更新文档 7. 禁用文档 8. 启用文档 9. 归档文档 10. 恢复文档 11. 暂停文档处理 12. 恢复文档处理 13. 新增分段 14. 删除分段 15. 更新分段 16. 批量导入分段 17. 命中测试 18. App 或 Workflow 中查询知识库（多路召回虽然会多次查询知识库，但是只记作一次请求） [Previous召回测试/引用归属](/zh-hans/guides/knowledge-base/retrieval-test-and-citation) [Next连接外部知识库](/zh-hans/guides/knowledge-base/connect-external-knowledge-base) Last updated 14 days ago --- # SiliconFlow (支持 Flux 绘图) | Dify [PreviousSerper](/zh-hans/guides/tools/tool-configuration/serper) [NextComfyUI](/zh-hans/guides/tools/tool-configuration/comfyui) Last updated 19 days ago > 工具作者 @hjlarry “工具”已全面升级为“插件”生态，详细的使用说明请参考[插件开发](https://docs.dify.ai/zh-hans/plugins/quick-start/install-plugins) 。以下内容已归档。 SiliconCloud 基于优秀的开源基础模型，提供高性价比的 GenAI 服务。你可以通过 **SiliconFlow** 在 Dify 内调用 Flux 、Stable Diffusion 绘图模型，搭建你的专属 AI 绘图应用。以下是在 Dify 中配置 SiliconFlow 工具的步骤。 ### [](#id-1.-shen-qing-siliconcloud-api-key) 1\. 申请 SiliconCloud API Key 请在 [SiliconCloud API 管理页面](https://cloud.siliconflow.cn/account/ak) 新建 API Key 并保证有足够余额。 ### [](#id-2.-zai-dify-nei-tian-xie-pei-zhi) 2\. 在 Dify 内填写配置 在 Dify 的工具页中点击 `SiliconCloud > 去授权` 填写 API Key。 ### [](#id-3.-shi-yong-gong-ju) 3\. 使用工具 * **Chatflow / Workflow 应用** Chatflow 和 Workflow 应用均支持添加 `SiliconFlow` 工具节点。 将用户输入的内容通过[变量](/zh-hans/guides/workflow/variables) 传递至 Siliconflow 工具的 Flux 或 Stable Diffusion 节点内的“提示词”“负面提示词”框中，按照需求调整内置参数，最后在“结束”节点的回复框中选中 Siliconflow 工具节点的输出内容（文本、图片等）。 * **Agent 应用** 在 Agent 应用内添加 `Stable Diffusion` 或 `Flux` 工具，然后在对话框内发送图片描述，调用工具生成 AI 图像。 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252FX2OcCKgitkyAeq7F5fZe%252F%25E6%2588%25AA%25E5%25B1%258F2024-09-26%252023.12.01.png%3Falt%3Dmedia%26token%3Df6066ba9-eca8-437c-b7f2-4832f901fbb5&width=768&dpr=4&quality=100&sign=7a3f6fc5&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fck3brAA9Lzv4ECmocBps%252F%25E6%2588%25AA%25E5%25B1%258F2024-09-27%252010.09.34.png%3Falt%3Dmedia%26token%3D7ea9212f-d080-465b-8903-9497cbde171a&width=768&dpr=4&quality=100&sign=959fe746&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252FXyzSq5iOd1YARYQXIsZh%252F%25E6%2588%25AA%25E5%25B1%258F2024-09-27%252010.18.54.png%3Falt%3Dmedia%26token%3Db86a268a-339b-4596-bc7c-97c64d69dd25&width=768&dpr=4&quality=100&sign=9ac73d31&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252F89mhsOF1Sgkk4k5LPFpi%252F%25E6%2588%25AA%25E5%25B1%258F2024-09-27%252010.23.52.png%3Falt%3Dmedia%26token%3Dd3012266-9677-41de-b898-2b9d95d73eb7&width=768&dpr=4&quality=100&sign=9f737d3a&sv=2) --- # 召回测试/引用归属 | Dify [Previous在应用内集成知识库](/zh-hans/guides/knowledge-base/integrate-knowledge-within-application) [Next知识库请求频率限制](/zh-hans/guides/knowledge-base/knowledge-request-rate-limit) Last updated 1 month ago ### [](#id-1-zhao-hui-ce-shi) 1 召回测试 Dify 知识库内提供了文本召回测试的功能，用于模拟用户输入关键词后调用知识库内容区块。召回的区块将按照分数高低进行排序并发送至 LLM。一般而言，问题与内容块的匹配度越高，LLM 所输出的答案也就更加贴近源文档，文本“训练效果”越好。 你可以使用不同的检索方式及参数配置，查看召回的内容区块质量与效果。不同的知识库分段模式对应不同的召回测试方法。 通用模式父子分段模式 **通用模式** 在 **源文本** 输入框输入常见的用户问题，点击 **测试** 按钮即可在右侧的 **召回段落** 内查看召回结果。 在通用模式下，内容区块相互独立；内容块右上角的分数为内容与关键词的匹配分数。得分越高，说明问题关键词与内容块的的匹配度越高。 通用模式 - 召回内容块 轻点内容块即可查看所引用的内容详情。每个内容块底部将展示所引用的文档信息源，你可以借此判断该内容分段是否合理。 **父子分段模式** 在 **源文本** 输入框输入常见的用户问题，点击 **测试** 并在右侧的 **召回段落** 查看召回结果。在父子分段模式下，问题的关键词将命中子分段中的内容块，以取得更加精准的匹配效果。区块右上角的得分指的是子区块与关键词之间的匹配得分。 你可以在预览区内查看具体的命中段落内容；匹配后将召回子分段所在父分段的完整上下文，向 AI 应用提供更加完整的信息。 每个内容块底部将展示所引用的文档源，通常是文档中的某个段落或句子。轻点引用源右侧的“打开”按钮即可查看被引用的内容。 分段详情页的左侧为父分段信息，右侧为被命中的子分段。关键词可能命中多个子分段，同时在开头显示与关键词的匹配分数。你可以基于详情信息判断当前的内容分段是否合理。 在 **记录** 内可以查看到历史的查询记录；若知识库已关联至应用内，由应用内发起的知识库查询记录也可以在此查看。 #### [](#xiu-gai-wen-ben-jian-suo-fang-shi) 修改文本检索方式 点击源文本输入框右上角的图标即可更换当前知识库的检索方式与具体参数，保存之后仅在当前召回测试的调试过程中生效，你可以借此比较不同检索设置的效果。如果你想要修改当前知识库的检索方式，前往“知识库设置” > “检索设置”中进行设置。 **召回测试建议步骤：** 1. 设计和整理能够覆盖用户常见问题的测试用例/测试问题集/指引内容； 2. 根据内容特点和使用场景（是否为问答内容、是否涉及多语言问答等），选择合适的检索策略。关于不同检索方式的优缺点，请参考扩展阅读[检索增强生成（RAG）](/zh-hans/learn-more/extended-reading/retrieval-augment) ； 3. 调整召回分段数量（TopK）和召回分数阈值（Score），根据实际的应用场景、包括文档本身的质量来选择合适的参数组合。 **TopK 值和召回阈值（Score ）如何配置** * **TopK 代表按相似分数倒排时召回分段的最大个数**。TopK 值调小，将会召回更少分段，可能导致召回的相关文本不全；TopK 值调大，将召回更多分段，可能导致召回语义相关性较低的分段使得 LLM 回复质量降低。 * **召回阈值（Score）代表允许召回分段的最低相似分数。** 召回分数调小，将会召回更多分段，可能导致召回相关度较低的分段；召回分数阈值调大，将会召回更少分段，过大时将会导致丢失相关分段。 * * * ### [](#id-2-yin-yong-yu-gui-shu) 2 引用与归属 在应用内的“上下文”添加知识库后，可以在 **“添加功能”** 内开启 **“引用与归属”**。在应用内输入问题后，若涉及已关联的知识库文档，将标注内容的引用来源。你可以通过此方式检查知识库所召回的内容分段是否符合预期。 开启功能后，当 LLM 引用知识库内容来回答问题时，可以在回复内容下面查看到具体的引用段落信息，包括**原始分段文本、分段序号、匹配度**等。点击引用分段上方的 **跳转至知识库**，可以快捷访问该分段所在的知识库分段列表，方便开发者进行调试编辑。 #### [](#cha-kan-zhi-shi-ku-nei-yi-guan-lian-de-ying-yong) 查看知识库内已关联的应用 知识库将会在左侧信息栏中显示已关联的应用数量。将鼠标悬停至圆形信息图标时将显示所有已关联的 Apps 列表，点击右侧的跳转按钮即可快速查看对应的应用。 查看召回内容详情 召回测试 - 父子分段模式 查看召回内容详情 召回测试-检索设置 查看知识库内已关联的应用 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F28899b9b0eba8996f364fb74e5b94c7f.png&width=768&dpr=4&quality=100&sign=de00f8f&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F806967bb36e74fc744b34887cd3ebe52.png&width=768&dpr=4&quality=100&sign=e9cf0f4d&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F22103227f8a25069d147160254f69512.png&width=768&dpr=4&quality=100&sign=fe2caaec&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F86b78cb114a843c9dedcba1fe12e3b02.png&width=768&dpr=4&quality=100&sign=7ce55ec5&sv=2) 打开引用与归属功能 查看回复内容的引用信息 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-7b0bcb4b6b6a56edc4d6ec874937a0879257f1c7%252Fcitation-and-attribution.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=2155c535&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252FNOoFoYBE8uPRlryImi0D%252Fimage.png%3Falt%3Dmedia%26token%3Deffb6115-4cfa-45f9-ad5b-0fd784192541&width=768&dpr=4&quality=100&sign=d1a3f2cb&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F6f0b99f97b138805bf4665d0c5c16f26.png&width=768&dpr=4&quality=100&sign=c91d3391&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2Fassets-docs.dify.ai%2F2024%2F12%2F419ac78ad21ea198b08f89c4f5fde485.png&width=768&dpr=4&quality=100&sign=e23b9b7f&sv=2) --- # ComfyUI | Dify [PreviousSiliconFlow (支持 Flux 绘图)](/zh-hans/guides/tools/tool-configuration/siliconflow) [Next发布](/zh-hans/guides/application-publishing) Last updated 19 days ago “工具”已全面升级为“插件”生态，详细的使用说明请参考[插件开发](https://docs.dify.ai/zh-hans/plugins/quick-start/install-plugins) 。以下内容已归档。 [ComfyUI](https://www.comfy.org/) 是一个强大的、模块化的生成图形的平台。现在你可以在 Dify 中使用它， 传入图片的提示词或图片文件， 得到生成的图片。 [](#id-1.-que-bao-yi-neng-zheng-chang-yun-xing-comfyui-de-gong-zuo-liu) 1\. 确保已能正常运行 ComfyUI 的工作流 ------------------------------------------------------------------------------------------------------ 请参考其[官方文档](https://docs.comfy.org/get_started/gettingstarted) ，确保 ComfyUI 可以正常运行并生成图片。 [](#id-2.-ti-shi-ci-she-zhi) 2\. 提示词设置 ------------------------------------------- 如果你不需要通过dify传入提示词，可以跳过此步。如果你的提示词节点连接到了 ComfyUI 中唯一的 `KSampler` 节点，那么你可以跳过此步。 否则，请使用字符串 `{{positive_prompt}}` 替换掉正向提示词内容，`{{negative_prompt}}` 替换掉负向提示词内容。 [](#id-3.-dao-chu-gong-zuo-liu-de-api-wen-jian) 3\. 导出工作流的 API 文件 ---------------------------------------------------------------------- 如图所示，在工具栏中选择 \`Save(API Format)\`，如果没有该选择，则需要在设置中开启 \`Dev Mode\`。 [](#id-4.-zai-dify-zhong-ji-cheng-comfyui) 4\. 在 Dify 中集成 ComfyUI ---------------------------------------------------------------------- 在 `工具 > ComfyUI > 去认证` 中填写访问地址，如果你使用的 docker 部署的 Dify，这个地址一般是 `http://host.docker.internal:8188`。 [](#id-5.-zai-dify-zhong-shi-yong-comfyui) 5\. 在 Dify 中使用 ComfyUI ---------------------------------------------------------------------- 打开其 `工作流` 工具，在 `WORKFLOW JSON` 中填入刚刚导出的 API 文件中的内容，就可以正常生成了。 [](#id-6.-tu-pian-shu-ru) 6\. 图片输入 --------------------------------------- 有的 ComfyUI 工作流需要输入多张图片，在 dify 中会查找到 `WORKFLOW JSON` 中的每一个 `LoadImage` 节点，并按顺序填充用户输入的图片文件。 当你想改变这个顺序时，就可以通过填写 `图片节点ID列表` 来调整。例如你的工作流中35号、69号、87号节点需要传入图片，那么输入`69,35,87`则会向69号节点传入第一张图片。 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-bce6acfd0434aef41c6511affa394f961b8a10d6%252Fcomfyui_prompt.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=e0af7535&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-bfec05141aa9195bfc97f0349eae8c5e42ef7845%252Fcomfyui.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=95ca241&sv=2) --- # Dall-e | Dify [PreviousStableDiffusion](/zh-hans/guides/tools/tool-configuration/stable-diffusion) [NextPerplexity Search](/zh-hans/guides/tools/tool-configuration/perplexity) Last updated 19 days ago > 工具作者 @Dify。 “工具”已全面升级为“插件”生态，详细的使用说明请参考[插件开发](https://docs.dify.ai/zh-hans/plugins/quick-start/install-plugins) 。以下内容已归档。 DALL-E 是由 OpenAI 开发的一种基于文本提示生成图像的工具。Dify 已接入 DALL-E 工具，以下是在 Dify 中配置和使用 DALL-E 绘图工具的步骤。 [](#id-1.-shen-qing-openai-de-api-key) 1\. 申请 OpenAI 的 API Key ------------------------------------------------------------------- 请在 [OpenAI Platform](https://platform.openai.com/) 申请 API Key，并确保账户内有足够的 Credits。 [](#id-2.-zai-dify-nei-tian-xie-pei-zhi) 2\. 在 Dify 内填写配置 -------------------------------------------------------------- 在 Dify 导航页内轻点 `工具 > DALL-E > 去授权` 填写 API Key。 [](#id-3.-shi-yong-gong-ju) 3\. 使用工具 ----------------------------------------- * **Chatflow / Workflow 应用** Chatflow 和 Workflow 应用均支持添加 `DALL-E 绘图` 工具节点。添加后，需要在节点内的 “输入变量 → 提示词” 内填写[变量](https://docs.dify.ai/v/zh-hans/guides/workflow/variables) 引用用户输入的提示词，或者是上一节点生成的内容。最后在 “结束” 节点内使用变量引用 `DALL-E 绘图` 输出的图像。 * **Agent 应用** 在 Agent 应用内添加 `DALL-E` 工具，然后在对话框内发送图片描述，调用工具生成 AI 图像。 ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-514b5401cbc0073e3d1734179ef400fd14027a6b%252Fzh-tools-dalle.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=4343ce91&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-109b15dda74d34ba80e6f30ad4202493b0f33932%252Fzh-dalle3-node.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=c4c25c7c&sv=2) ![](https://docs.dify.ai/~gitbook/image?url=https%3A%2F%2F1288284732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FCdDIVDY6AtAz028MFT4d%252Fuploads%252Fgit-blob-11402a369e05b048134e03310bdb103f51433ead%252Fzh-agent-dalle3.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=df1efb3f&sv=2) ---