diff --git a/en/api-reference/openapi_service.json b/en/api-reference/openapi_service.json index af181b01b..77566802d 100644 --- a/en/api-reference/openapi_service.json +++ b/en/api-reference/openapi_service.json @@ -9954,7 +9954,7 @@ } } }, - "description": "- `moderation_unavailable` : The app's content moderation, set to Keywords or Custom Endpoint, couldn't complete its check on the input or output, for example because the endpoint couldn't be reached or returned an invalid response.\n- `moderation_unavailable` : On Dify Cloud, Dify's own moderation couldn't complete its check on the input or output of a model running on AI credits. (Chatbot and Legacy Agent apps)" + "description": "- `moderation_unavailable` : The app's content moderation, set to Keywords or Custom Endpoint, couldn't complete its check on the input or output, for example because the endpoint couldn't be reached or returned an invalid response.\n- `moderation_unavailable` : On Dify Cloud, Dify's own moderation couldn't complete its check on the input or output of a model running on AI credits. (Chatbot and Legacy Agent apps)\n- `moderation_unavailable` : The app's content moderation is set to OpenAI Moderation, and the workspace has no working OpenAI API key in Model Provider. On Dify Cloud, this happens only in Chatbot and Legacy Agent apps whose model uses the workspace's own API key." } }, "summary": "Send Chat Message", @@ -10268,7 +10268,7 @@ } } }, - "description": "- `moderation_unavailable` : The app's content moderation, set to Keywords or Custom Endpoint, couldn't complete its check on the input or output, for example because the endpoint couldn't be reached or returned an invalid response.\n- `moderation_unavailable` : On Dify Cloud, Dify's own moderation couldn't complete its check on the input or output of a model running on AI credits." + "description": "- `moderation_unavailable` : The app's content moderation, set to Keywords or Custom Endpoint, couldn't complete its check on the input or output, for example because the endpoint couldn't be reached or returned an invalid response.\n- `moderation_unavailable` : On Dify Cloud, Dify's own moderation couldn't complete its check on the input or output of a model running on AI credits.\n- `moderation_unavailable` : The app's content moderation is set to OpenAI Moderation, and the workspace has no working OpenAI API key in Model Provider. On Dify Cloud, this happens only when the app's model uses the workspace's own API key." } }, "summary": "Send Completion Message", diff --git a/en/cloud/use-dify/nodes/knowledge-retrieval.mdx b/en/cloud/use-dify/nodes/knowledge-retrieval.mdx index 12ec6fc93..18ac872da 100644 --- a/en/cloud/use-dify/nodes/knowledge-retrieval.mdx +++ b/en/cloud/use-dify/nodes/knowledge-retrieval.mdx @@ -74,11 +74,13 @@ To fine-tune how the node processes retrieval results after they are fetched fro Retrieval settings exist at two layers: the knowledge base level and the knowledge retrieval node level. - Think of them as two consecutive filters: the knowledge base settings determine the initial pool of results, and the node settings further rerank the results or narrow down the pool. + Think of them as two consecutive filters: the knowledge base settings determine the initial pool of results, and the node settings narrow down the pool, reranking it first when the node searches two or more knowledge bases. - **Rerank Settings** + These apply only when the node searches two or more knowledge bases. With one, that knowledge base's own retrieval settings decide the order. + - **Weighted Score** The relative weight between semantic similarity and keyword matching during reranking. Higher semantic weight favors meaning relevance, while higher keyword weight favors exact matches. diff --git a/en/cloud/use-dify/workspace/tools.mdx b/en/cloud/use-dify/workspace/tools.mdx index 2a6982812..7de4c6820 100644 --- a/en/cloud/use-dify/workspace/tools.mdx +++ b/en/cloud/use-dify/workspace/tools.mdx @@ -30,7 +30,9 @@ Manage all your tools from **Integrations** > **Tools**. Turn any Workflow that starts with a User Input node into a tool, so you can reuse multi-step logic across apps. Chatflows cannot be used as tools. - In the workflow editor, click **Publish** > **Workflow as Tool**. This publishes the workflow first, so the tool matches the workflow as it stands. + Publish the workflow first, then click **Publish** > **Workflow as Tool**. + + The tool keeps running the version it was saved with. After you publish changes to the workflow, save the tool again. If the workflow contains a Human Input node, the tool works only as a standalone Tool node in Workflow and Chatflow apps. Agent nodes, Agent apps, legacy Agent apps, and knowledge pipelines can't use it. To test it, run the whole workflow rather than the Tool node alone. diff --git a/en/self-host/use-dify/build/additional-features.mdx b/en/self-host/use-dify/build/additional-features.mdx index 7081bd89b..d925363bc 100644 --- a/en/self-host/use-dify/build/additional-features.mdx +++ b/en/self-host/use-dify/build/additional-features.mdx @@ -104,6 +104,8 @@ Filter inappropriate content in user inputs, AI outputs, or both. Choose a moder - **OpenAI Moderation**: Use OpenAI's dedicated moderation model to detect harmful content across multiple categories. + It checks content with your workspace's OpenAI API key, so add one in **Model Provider**. Without it, each message fails with an error instead of a reply. + - **Keywords**: Define a list of blocked terms. Any match triggers the preset response. - **Custom Endpoint**: Connect a custom moderation endpoint for your own filtering logic. diff --git a/en/self-host/use-dify/nodes/knowledge-retrieval.mdx b/en/self-host/use-dify/nodes/knowledge-retrieval.mdx index bed94d71c..71c6b89e8 100644 --- a/en/self-host/use-dify/nodes/knowledge-retrieval.mdx +++ b/en/self-host/use-dify/nodes/knowledge-retrieval.mdx @@ -68,11 +68,13 @@ To fine-tune how the node processes retrieval results after they are fetched fro Retrieval settings exist at two layers: the knowledge base level and the knowledge retrieval node level. - Think of them as two consecutive filters: the knowledge base settings determine the initial pool of results, and the node settings further rerank the results or narrow down the pool. + Think of them as two consecutive filters: the knowledge base settings determine the initial pool of results, and the node settings narrow down the pool, reranking it first when the node searches two or more knowledge bases. - **Rerank Settings** + These apply only when the node searches two or more knowledge bases. With one, that knowledge base's own retrieval settings decide the order. + - **Weighted Score** The relative weight between semantic similarity and keyword matching during reranking. Higher semantic weight favors meaning relevance, while higher keyword weight favors exact matches. diff --git a/en/self-host/use-dify/workspace/personal-account-management.mdx b/en/self-host/use-dify/workspace/personal-account-management.mdx index 89e41ba6a..2112275da 100644 --- a/en/self-host/use-dify/workspace/personal-account-management.mdx +++ b/en/self-host/use-dify/workspace/personal-account-management.mdx @@ -47,7 +47,7 @@ Click **Create token** and give the token only what its job needs, since anyone For the `difyctl` commands that **Resources** and **Manage workspaces** each allow, see [Choose the Account and Scopes](/en/cli/personal-access-tokens#choose-the-account-and-scopes). -Within its scopes, the token can do only what your role allows in each workspace. A change to your role, or your removal from a workspace, applies from the token's next use. If your account is disabled, your tokens stop working. +Within its scopes, the token can do only what your role allows in each workspace. A change to your role, or your removal from a workspace, applies from the token's next use. Once it's created, [give the token to `difyctl`](/en/cli/personal-access-tokens#give-the-token-to-difyctl). diff --git a/en/self-host/use-dify/workspace/tools.mdx b/en/self-host/use-dify/workspace/tools.mdx index ff6474f4e..0f65a2a45 100644 --- a/en/self-host/use-dify/workspace/tools.mdx +++ b/en/self-host/use-dify/workspace/tools.mdx @@ -30,7 +30,9 @@ Manage all your tools from **Integrations** > **Tools**. Turn any Workflow that starts with a User Input node into a tool, so you can reuse multi-step logic across apps. Chatflows cannot be used as tools, and neither can workflows with the new [Human Input](/en/self-host/use-dify/nodes/human-input) node. - In the workflow editor, click **Publish** > **Workflow as Tool**. This publishes the workflow first, so the tool matches the workflow as it stands. + Publish the workflow first, then click **Publish** > **Workflow as Tool**. + + The tool keeps running the version it was saved with. After you publish changes to the workflow, save the tool again. If the workflow contains an old Human Input node, the tool works only as a standalone Tool node in Workflow and Chatflow apps. Agent nodes, Agent apps, legacy Agent apps, and knowledge pipelines can't use it. To test it, run the whole workflow rather than the Tool node alone. diff --git a/ja/api-reference/openapi_service.json b/ja/api-reference/openapi_service.json index e2876b5cf..23262a874 100644 --- a/ja/api-reference/openapi_service.json +++ b/ja/api-reference/openapi_service.json @@ -9954,7 +9954,7 @@ } } }, - "description": "- `moderation_unavailable` : アプリのコンテンツモデレーション(キーワードまたはカスタム API)が、入力または出力のチェックを完了できませんでした。エンドポイントに接続できない場合や、無効なレスポンスが返された場合などです。\n- `moderation_unavailable` : Dify Cloud で、AI クレジットで動作するモデルの入力または出力に対し、Dify 独自のモデレーションがチェックを完了できませんでした。(チャットボット、レガシー Agent アプリ)" + "description": "- `moderation_unavailable` : アプリのコンテンツモデレーション(キーワードまたはカスタム API)が、入力または出力のチェックを完了できませんでした。エンドポイントに接続できない場合や、無効なレスポンスが返された場合などです。\n- `moderation_unavailable` : Dify Cloud で、AI クレジットで動作するモデルの入力または出力に対し、Dify 独自のモデレーションがチェックを完了できませんでした。(チャットボット、レガシー Agent アプリ)\n- `moderation_unavailable` : アプリのコンテンツモデレーションが OpenAI モデレーションに設定されていますが、ワークスペースのモデルプロバイダーに有効な OpenAI API キーがありません。Dify Cloud では、モデルがワークスペース独自の API キーを使うチャットボットとレガシー Agent アプリでのみ発生します。" } }, "summary": "チャットメッセージを送信", @@ -10268,7 +10268,7 @@ } } }, - "description": "- `moderation_unavailable` : アプリのコンテンツモデレーション(キーワードまたはカスタム API)が、入力または出力のチェックを完了できませんでした。エンドポイントに接続できない場合や、無効なレスポンスが返された場合などです。\n- `moderation_unavailable` : Dify Cloud で、AI クレジットで動作するモデルの入力または出力に対し、Dify 独自のモデレーションがチェックを完了できませんでした。" + "description": "- `moderation_unavailable` : アプリのコンテンツモデレーション(キーワードまたはカスタム API)が、入力または出力のチェックを完了できませんでした。エンドポイントに接続できない場合や、無効なレスポンスが返された場合などです。\n- `moderation_unavailable` : Dify Cloud で、AI クレジットで動作するモデルの入力または出力に対し、Dify 独自のモデレーションがチェックを完了できませんでした。\n- `moderation_unavailable` : アプリのコンテンツモデレーションが OpenAI モデレーションに設定されていますが、ワークスペースのモデルプロバイダーに有効な OpenAI API キーがありません。Dify Cloud では、アプリのモデルがワークスペース独自の API キーを使う場合にのみ発生します。" } }, "summary": "完了メッセージを送信", diff --git a/ja/cloud/use-dify/nodes/knowledge-retrieval.mdx b/ja/cloud/use-dify/nodes/knowledge-retrieval.mdx index 5ea18d439..d44d6b74d 100644 --- a/ja/cloud/use-dify/nodes/knowledge-retrieval.mdx +++ b/ja/cloud/use-dify/nodes/knowledge-retrieval.mdx @@ -76,11 +76,13 @@ description: 従来型ナレッジベースから関連コンテンツを検索 検索設定には、ナレッジベースレベルと知識検索ノードレベルという 2 つのレイヤーがあります。 - これらは 2 つの連続したフィルターと考えてください:ナレッジベースの設定が最初の結果プールを決定し、ノードの設定がさらに結果を再ランク付けまたは絞り込みます。 + この 2 つは、順に働くフィルターです。まずナレッジベースの設定で検索結果の候補が決まり、ノードの設定がそれをさらに絞り込みます。ノードが 2 つ以上のナレッジベースを検索する場合は、その前に結果を再ランク付けします。 - **Rerank 設定** + ノードが 2 つ以上のナレッジベースを検索する場合にのみ適用されます。1 つだけの場合は、そのナレッジベース自体の検索設定で順位が決まります。 + - **ウェイト設定** 再ランク付け時におけるセマンティック類似度とキーワード一致の相対的な比重です。セマンティックの比重を高くすると意味的関連性を重視し、キーワードの比重を高くすると正確な一致を重視します。 diff --git a/ja/cloud/use-dify/workspace/tools.mdx b/ja/cloud/use-dify/workspace/tools.mdx index 689b88255..506813532 100644 --- a/ja/cloud/use-dify/workspace/tools.mdx +++ b/ja/cloud/use-dify/workspace/tools.mdx @@ -32,7 +32,9 @@ description: "LLM が外部サービスや API と連携するためのツール ユーザー入力ノードで始まる Workflow アプリをツールに変換し、マルチステップのロジックを複数のアプリで再利用できます。Chatflow はツールとして使用できません。 - ワークフローエディターで **公開する** > **ワークフローをツールとして利用** をクリックします。この操作でまずワークフローが公開されるため、ツールは公開時点のワークフローと同じ内容になります。 + 先にワークフローを公開してから、**公開する** > **ワークフローをツールとして利用** をクリックします。 + + ツールは保存時のバージョンで動作し続けます。ワークフローの変更を公開したら、ツールをもう一度保存してください。 ワークフローに人間の入力ノードが含まれる場合、そのツールは Workflow アプリまたは Chatflow アプリの独立したツールノードとしてのみ使用できます。Agent ノード、Agent アプリ、レガシー Agent アプリ、ナレッジパイプラインでは使用できません。テストする際は、ツールノードを単独で実行せず、ワークフロー全体を実行してください。 diff --git a/ja/self-host/use-dify/build/additional-features.mdx b/ja/self-host/use-dify/build/additional-features.mdx index 2fa6e604f..f2cc2615d 100644 --- a/ja/self-host/use-dify/build/additional-features.mdx +++ b/ja/self-host/use-dify/build/additional-features.mdx @@ -106,6 +106,8 @@ AI の応答の背後にあるソースドキュメントを表示します。 - **OpenAI モデレーション**:OpenAI の専用モデレーションモデルを使用して、複数のカテゴリにわたる有害コンテンツを検出します。 + チェックにはワークスペースの OpenAI API キーを使うため、**モデルプロバイダー** で追加してください。追加していないと、メッセージを送るたびにエラーになり、回答は返りません。 + - **キーワード**:ブロックする用語のリストを定義します。一致するものがあると、プリセット応答がトリガーされます。 - **カスタム API**:カスタムモデレーションエンドポイントに接続して、独自のフィルタリングロジックを適用します。 diff --git a/ja/self-host/use-dify/nodes/knowledge-retrieval.mdx b/ja/self-host/use-dify/nodes/knowledge-retrieval.mdx index 704c87121..8a8cb313b 100644 --- a/ja/self-host/use-dify/nodes/knowledge-retrieval.mdx +++ b/ja/self-host/use-dify/nodes/knowledge-retrieval.mdx @@ -70,11 +70,13 @@ description: ナレッジベースから関連コンテンツを検索し、下 検索設定には、ナレッジベースレベルと知識検索ノードレベルという 2 つのレイヤーがあります。 - これらは 2 つの連続したフィルターと考えてください:ナレッジベースの設定が最初の結果プールを決定し、ノードの設定がさらに結果を再ランク付けまたは絞り込みます。 + この 2 つは、順に働くフィルターです。まずナレッジベースの設定で検索結果の候補が決まり、ノードの設定がそれをさらに絞り込みます。ノードが 2 つ以上のナレッジベースを検索する場合は、その前に結果を再ランク付けします。 - **Rerank 設定** + ノードが 2 つ以上のナレッジベースを検索する場合にのみ適用されます。1 つだけの場合は、そのナレッジベース自体の検索設定で順位が決まります。 + - **ウェイト設定** 再ランク付け時におけるセマンティック類似度とキーワード一致の相対的な比重です。セマンティックの比重を高くすると意味的関連性を重視し、キーワードの比重を高くすると正確な一致を重視します。 diff --git a/ja/self-host/use-dify/workspace/personal-account-management.mdx b/ja/self-host/use-dify/workspace/personal-account-management.mdx index 82ed55959..af5d31ad1 100644 --- a/ja/self-host/use-dify/workspace/personal-account-management.mdx +++ b/ja/self-host/use-dify/workspace/personal-account-management.mdx @@ -49,7 +49,7 @@ description: プロフィール、ログイン、インターフェース設定 **リソース** と **ワークスペースの管理** でそれぞれ使えるようになる `difyctl` コマンドについては、[アカウントとアクセス範囲の選択](/ja/cli/personal-access-tokens#アカウントとアクセス範囲の選択) を参照してください。 -アクセス範囲内であっても、トークンで行えるのは、各ワークスペースであなたのロールが許可する操作だけです。ロールが変更された場合や、ワークスペースから削除された場合、その変更はトークンを次に使うときから反映されます。アカウントが無効になると、トークンは使えなくなります。 +アクセス範囲内であっても、トークンで行えるのは、各ワークスペースであなたのロールが許可する操作だけです。ロールが変更された場合や、ワークスペースから削除された場合、その変更はトークンを次に使うときから反映されます。 作成したら、[トークンを `difyctl` に渡します](/ja/cli/personal-access-tokens#difyctl-へのトークンの受け渡し)。 diff --git a/ja/self-host/use-dify/workspace/tools.mdx b/ja/self-host/use-dify/workspace/tools.mdx index 8ec2ad175..7b20faea3 100644 --- a/ja/self-host/use-dify/workspace/tools.mdx +++ b/ja/self-host/use-dify/workspace/tools.mdx @@ -32,7 +32,9 @@ description: LLM が外部サービスや API と連携するためのツール ユーザー入力ノードで始まる Workflow アプリをツールに変換し、マルチステップのロジックを複数のアプリで再利用できます。Chatflow アプリと、新しい [人間の入力](/ja/self-host/use-dify/nodes/human-input) ノードを含む Workflow アプリは、ツールとして使用できません。 - ワークフローエディターで **公開する** > **ワークフローをツールとして利用** をクリックします。この操作でまずワークフローが公開されるため、ツールは公開時点のワークフローと同じ内容になります。 + 先にワークフローを公開してから、**公開する** > **ワークフローをツールとして利用** をクリックします。 + + ツールは保存時のバージョンで動作し続けます。ワークフローの変更を公開したら、ツールをもう一度保存してください。 旧バージョンの人間の入力ノードを含むワークフローは、Workflow アプリと Chatflow アプリの独立したツールノードとしてのみ使えます。Agent ノード、Agent アプリ、レガシー Agent アプリ、ナレッジパイプラインでは使用できません。テストする際は、ツールノードを単独で実行せず、ワークフロー全体を実行してください。 diff --git a/zh/api-reference/openapi_service.json b/zh/api-reference/openapi_service.json index 81edfbcd7..11c925d20 100644 --- a/zh/api-reference/openapi_service.json +++ b/zh/api-reference/openapi_service.json @@ -9954,7 +9954,7 @@ } } }, - "description": "- `moderation_unavailable` : 应用的内容审核(关键词或自定义端点)未能完成对输入或输出的检查,例如无法连接端点,或端点返回的响应无效。\n- `moderation_unavailable` : 在 Dify Cloud 上,模型使用 AI 消息额度时,Dify 自带的审核未能完成对其输入或输出的检查。(聊天助手、旧版 Agent 应用)" + "description": "- `moderation_unavailable` : 应用的内容审核(关键词或自定义端点)未能完成对输入或输出的检查,例如无法连接端点,或端点返回的响应无效。\n- `moderation_unavailable` : 在 Dify Cloud 上,模型使用 AI 消息额度时,Dify 自带的审核未能完成对其输入或输出的检查。(聊天助手、旧版 Agent 应用)\n- `moderation_unavailable` : 应用的内容审核设为 OpenAI Moderation,但工作空间没有在模型供应商中配置可用的 OpenAI API 密钥。在 Dify Cloud 上,只有聊天助手和旧版 Agent 应用的模型使用工作空间自己的 API 密钥时,才会出现这种情况。" } }, "summary": "发送对话消息", @@ -10268,7 +10268,7 @@ } } }, - "description": "- `moderation_unavailable` : 应用的内容审核(关键词或自定义端点)未能完成对输入或输出的检查,例如无法连接端点,或端点返回的响应无效。\n- `moderation_unavailable` : 在 Dify Cloud 上,模型使用 AI 消息额度时,Dify 自带的审核未能完成对其输入或输出的检查。" + "description": "- `moderation_unavailable` : 应用的内容审核(关键词或自定义端点)未能完成对输入或输出的检查,例如无法连接端点,或端点返回的响应无效。\n- `moderation_unavailable` : 在 Dify Cloud 上,模型使用 AI 消息额度时,Dify 自带的审核未能完成对其输入或输出的检查。\n- `moderation_unavailable` : 应用的内容审核设为 OpenAI Moderation,但工作空间没有在模型供应商中配置可用的 OpenAI API 密钥。在 Dify Cloud 上,只有应用的模型使用工作空间自己的 API 密钥时才会出现这种情况。" } }, "summary": "发送消息", diff --git a/zh/cloud/use-dify/nodes/knowledge-retrieval.mdx b/zh/cloud/use-dify/nodes/knowledge-retrieval.mdx index 9ddf316e6..dfe5e74b6 100644 --- a/zh/cloud/use-dify/nodes/knowledge-retrieval.mdx +++ b/zh/cloud/use-dify/nodes/knowledge-retrieval.mdx @@ -76,11 +76,13 @@ description: 从经典知识库中检索相关内容,作为下游节点的上 检索设置分为知识库级和节点级两层。 - 可将其理解为先后两道筛选:知识库设置决定初步的检索结果池,而节点设置对结果进行重排序(Rerank)或进一步筛选。 + 可将其理解为先后两道筛选:知识库设置决定初步的检索结果池,节点设置再进一步筛选。节点检索两个及以上知识库时,还会先对结果重排序(Rerank)。 - **Rerank 设置** + 仅在节点检索两个及以上知识库时生效。只检索一个知识库时,由该知识库自身的检索设置决定排序。 + - **权重设置** 语义相似度与关键词匹配的权重。语义权重高则更注重语义相关性,关键词权重高则更偏向精确匹配。 diff --git a/zh/cloud/use-dify/workspace/tools.mdx b/zh/cloud/use-dify/workspace/tools.mdx index 43ed3bc81..54b2d5df2 100644 --- a/zh/cloud/use-dify/workspace/tools.mdx +++ b/zh/cloud/use-dify/workspace/tools.mdx @@ -32,7 +32,9 @@ description: "管理使 LLM 能够与外部服务和 API 交互的工具" 将任意以用户输入节点开始的 Workflow 应用转化为工具,在多个应用间复用多步逻辑。Chatflow 无法用作工具。 - 在工作流编辑器中,点击 **发布** > **工作流作为工具**。点击后会先发布工作流,工具与工作流当前的版本保持一致。 + 先发布工作流,再点击 **发布** > **工作流作为工具**。 + + 工具会一直运行保存时的版本。工作流发布新的改动后,重新保存一次工具。 如果工作流包含人工介入节点,这个工具只能在 Workflow 或 Chatflow 应用中作为独立的工具节点使用。Agent 节点、Agent 应用、旧版 Agent 应用和知识流水线都无法使用。测试时要运行整个工作流,不要单独运行工具节点。 diff --git a/zh/self-host/use-dify/build/additional-features.mdx b/zh/self-host/use-dify/build/additional-features.mdx index c6eea7fb5..55b66ef04 100644 --- a/zh/self-host/use-dify/build/additional-features.mdx +++ b/zh/self-host/use-dify/build/additional-features.mdx @@ -106,6 +106,8 @@ Dify 应用内置了多项可选功能,开启后可提升终端用户的使用 - **OpenAI Moderation**:使用 OpenAI 专用审核模型,检测多个类别的有害内容。 + 审核时使用工作空间的 OpenAI API 密钥,因此需要在 **模型供应商** 中添加。没有的话,每条消息都会报错,不会给出回复。 + - **关键词**:定义屏蔽词列表,任何匹配项都会触发预设回复。 - **自定义端点**:接入自定义审核端点,实现你自己的过滤逻辑。 diff --git a/zh/self-host/use-dify/nodes/knowledge-retrieval.mdx b/zh/self-host/use-dify/nodes/knowledge-retrieval.mdx index aaff70065..8c780a20c 100644 --- a/zh/self-host/use-dify/nodes/knowledge-retrieval.mdx +++ b/zh/self-host/use-dify/nodes/knowledge-retrieval.mdx @@ -70,11 +70,13 @@ description: 从知识库中检索相关内容,作为下游节点的上下文 检索设置分为知识库级和节点级两层。 - 可将其理解为先后两道筛选:知识库设置决定初步的检索结果池,而节点设置对结果进行重排序(Rerank)或进一步筛选。 + 可将其理解为先后两道筛选:知识库设置决定初步的检索结果池,节点设置再进一步筛选。节点检索两个及以上知识库时,还会先对结果重排序(Rerank)。 - **Rerank 设置** + 仅在节点检索两个及以上知识库时生效。只检索一个知识库时,由该知识库自身的检索设置决定排序。 + - **权重设置** 语义相似度与关键词匹配的权重。语义权重高则更注重语义相关性,关键词权重高则更偏向精确匹配。 diff --git a/zh/self-host/use-dify/workspace/personal-account-management.mdx b/zh/self-host/use-dify/workspace/personal-account-management.mdx index 4824a8a5f..7a5eb64cc 100644 --- a/zh/self-host/use-dify/workspace/personal-account-management.mdx +++ b/zh/self-host/use-dify/workspace/personal-account-management.mdx @@ -49,7 +49,7 @@ description: 管理你的个人资料、登录方式、界面偏好与个人访 **资源** 和 **管理工作空间** 各自允许哪些 `difyctl` 命令,详见 [选择账户和访问范围](/zh/cli/personal-access-tokens#选择账户和访问范围)。 -即使在访问范围之内,令牌在每个工作空间中也只能做你的角色允许的事。你的角色变更,或你被移出某个工作空间,都会从令牌下次使用时生效。账户被停用后,你的所有令牌都将失效。 +即使在访问范围之内,令牌在每个工作空间中也只能做你的角色允许的事。你的角色变更,或你被移出某个工作空间,都会从令牌下次使用时生效。 创建完成后,[把令牌交给 `difyctl`](/zh/cli/personal-access-tokens#把令牌交给-difyctl)。 diff --git a/zh/self-host/use-dify/workspace/tools.mdx b/zh/self-host/use-dify/workspace/tools.mdx index 3da3eed0f..9c96a6ad1 100644 --- a/zh/self-host/use-dify/workspace/tools.mdx +++ b/zh/self-host/use-dify/workspace/tools.mdx @@ -32,7 +32,9 @@ description: 管理工具,让 LLM 调用外部服务和 API 将任意以用户输入节点开始的 Workflow 应用转化为工具,在多个应用间复用多步逻辑。Chatflow 应用和包含新版 [人工介入](/zh/self-host/use-dify/nodes/human-input) 节点的 Workflow 应用都无法用作工具。 - 在工作流编辑器中,点击 **发布** > **工作流作为工具**。点击后会先发布工作流,工具与工作流当前的版本保持一致。 + 先发布工作流,再点击 **发布** > **工作流作为工具**。 + + 工具会一直运行保存时的版本。工作流发布新的改动后,重新保存一次工具。 如果工作流包含旧版人工介入节点,这个工具只能在 Workflow 或 Chatflow 应用中作为独立的工具节点使用。Agent 节点、Agent 应用、旧版 Agent 应用和知识流水线都无法使用该工具。测试时要运行整个工作流,不要单独运行工具节点。