Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions en/api-reference/openapi_service.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down Expand Up @@ -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",
Expand Down
4 changes: 3 additions & 1 deletion en/cloud/use-dify/nodes/knowledge-retrieval.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -74,11 +74,13 @@ To fine-tune how the node processes retrieval results after they are fetched fro
<Info>
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.
</Info>

- **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.
Expand Down
4 changes: 3 additions & 1 deletion en/cloud/use-dify/workspace/tools.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,9 @@ Manage all your tools from **Integrations** > **Tools**.
<Tab title="Workflow" id="workflow">
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.
</Tab>
Expand Down
2 changes: 2 additions & 0 deletions en/self-host/use-dify/build/additional-features.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
4 changes: 3 additions & 1 deletion en/self-host/use-dify/nodes/knowledge-retrieval.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,11 +68,13 @@ To fine-tune how the node processes retrieval results after they are fetched fro
<Info>
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.
</Info>

- **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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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).

Expand Down
4 changes: 3 additions & 1 deletion en/self-host/use-dify/workspace/tools.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,9 @@ Manage all your tools from **Integrations** > **Tools**.
<Tab title="Workflow" id="workflow">
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.
</Tab>
Expand Down
4 changes: 2 additions & 2 deletions ja/api-reference/openapi_service.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": "チャットメッセージを送信",
Expand Down Expand Up @@ -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": "完了メッセージを送信",
Expand Down
4 changes: 3 additions & 1 deletion ja/cloud/use-dify/nodes/knowledge-retrieval.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -76,11 +76,13 @@ description: 従来型ナレッジベースから関連コンテンツを検索
<Info>
検索設定には、ナレッジベースレベルと知識検索ノードレベルという 2 つのレイヤーがあります。

これらは 2 つの連続したフィルターと考えてください:ナレッジベースの設定が最初の結果プールを決定し、ノードの設定がさらに結果を再ランク付けまたは絞り込みます。
この 2 つは、順に働くフィルターです。まずナレッジベースの設定で検索結果の候補が決まり、ノードの設定がそれをさらに絞り込みます。ノードが 2 つ以上のナレッジベースを検索する場合は、その前に結果を再ランク付けします。
</Info>

- **Rerank 設定**

ノードが 2 つ以上のナレッジベースを検索する場合にのみ適用されます。1 つだけの場合は、そのナレッジベース自体の検索設定で順位が決まります。

- **ウェイト設定**

再ランク付け時におけるセマンティック類似度とキーワード一致の相対的な比重です。セマンティックの比重を高くすると意味的関連性を重視し、キーワードの比重を高くすると正確な一致を重視します。
Expand Down
4 changes: 3 additions & 1 deletion ja/cloud/use-dify/workspace/tools.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,9 @@ description: "LLM が外部サービスや API と連携するためのツール
<Tab title="Workflow" id="workflow">
ユーザー入力ノードで始まる Workflow アプリをツールに変換し、マルチステップのロジックを複数のアプリで再利用できます。Chatflow はツールとして使用できません。

ワークフローエディターで **公開する** > **ワークフローをツールとして利用** をクリックします。この操作でまずワークフローが公開されるため、ツールは公開時点のワークフローと同じ内容になります。
先にワークフローを公開してから、**公開する** > **ワークフローをツールとして利用** をクリックします。

ツールは保存時のバージョンで動作し続けます。ワークフローの変更を公開したら、ツールをもう一度保存してください。

ワークフローに人間の入力ノードが含まれる場合、そのツールは Workflow アプリまたは Chatflow アプリの独立したツールノードとしてのみ使用できます。Agent ノード、Agent アプリ、レガシー Agent アプリ、ナレッジパイプラインでは使用できません。テストする際は、ツールノードを単独で実行せず、ワークフロー全体を実行してください。
</Tab>
Expand Down
2 changes: 2 additions & 0 deletions ja/self-host/use-dify/build/additional-features.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,8 @@ AI の応答の背後にあるソースドキュメントを表示します。

- **OpenAI モデレーション**:OpenAI の専用モデレーションモデルを使用して、複数のカテゴリにわたる有害コンテンツを検出します。

チェックにはワークスペースの OpenAI API キーを使うため、**モデルプロバイダー** で追加してください。追加していないと、メッセージを送るたびにエラーになり、回答は返りません。

- **キーワード**:ブロックする用語のリストを定義します。一致するものがあると、プリセット応答がトリガーされます。

- **カスタム API**:カスタムモデレーションエンドポイントに接続して、独自のフィルタリングロジックを適用します。
Expand Down
4 changes: 3 additions & 1 deletion ja/self-host/use-dify/nodes/knowledge-retrieval.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -70,11 +70,13 @@ description: ナレッジベースから関連コンテンツを検索し、下
<Info>
検索設定には、ナレッジベースレベルと知識検索ノードレベルという 2 つのレイヤーがあります。

これらは 2 つの連続したフィルターと考えてください:ナレッジベースの設定が最初の結果プールを決定し、ノードの設定がさらに結果を再ランク付けまたは絞り込みます。
この 2 つは、順に働くフィルターです。まずナレッジベースの設定で検索結果の候補が決まり、ノードの設定がそれをさらに絞り込みます。ノードが 2 つ以上のナレッジベースを検索する場合は、その前に結果を再ランク付けします。
</Info>

- **Rerank 設定**

ノードが 2 つ以上のナレッジベースを検索する場合にのみ適用されます。1 つだけの場合は、そのナレッジベース自体の検索設定で順位が決まります。

- **ウェイト設定**

再ランク付け時におけるセマンティック類似度とキーワード一致の相対的な比重です。セマンティックの比重を高くすると意味的関連性を重視し、キーワードの比重を高くすると正確な一致を重視します。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ description: プロフィール、ログイン、インターフェース設定

**リソース** と **ワークスペースの管理** でそれぞれ使えるようになる `difyctl` コマンドについては、[アカウントとアクセス範囲の選択](/ja/cli/personal-access-tokens#アカウントとアクセス範囲の選択) を参照してください。

アクセス範囲内であっても、トークンで行えるのは、各ワークスペースであなたのロールが許可する操作だけです。ロールが変更された場合や、ワークスペースから削除された場合、その変更はトークンを次に使うときから反映されます。アカウントが無効になると、トークンは使えなくなります。
アクセス範囲内であっても、トークンで行えるのは、各ワークスペースであなたのロールが許可する操作だけです。ロールが変更された場合や、ワークスペースから削除された場合、その変更はトークンを次に使うときから反映されます。

作成したら、[トークンを `difyctl` に渡します](/ja/cli/personal-access-tokens#difyctl-へのトークンの受け渡し)。

Expand Down
4 changes: 3 additions & 1 deletion ja/self-host/use-dify/workspace/tools.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,9 @@ description: LLM が外部サービスや API と連携するためのツール
<Tab title="Workflow" id="workflow">
ユーザー入力ノードで始まる Workflow アプリをツールに変換し、マルチステップのロジックを複数のアプリで再利用できます。Chatflow アプリと、新しい [人間の入力](/ja/self-host/use-dify/nodes/human-input) ノードを含む Workflow アプリは、ツールとして使用できません。

ワークフローエディターで **公開する** > **ワークフローをツールとして利用** をクリックします。この操作でまずワークフローが公開されるため、ツールは公開時点のワークフローと同じ内容になります。
先にワークフローを公開してから、**公開する** > **ワークフローをツールとして利用** をクリックします。

ツールは保存時のバージョンで動作し続けます。ワークフローの変更を公開したら、ツールをもう一度保存してください。

旧バージョンの人間の入力ノードを含むワークフローは、Workflow アプリと Chatflow アプリの独立したツールノードとしてのみ使えます。Agent ノード、Agent アプリ、レガシー Agent アプリ、ナレッジパイプラインでは使用できません。テストする際は、ツールノードを単独で実行せず、ワークフロー全体を実行してください。
</Tab>
Expand Down
Loading
Loading