diff --git a/ja-jp/documentation/pages/build/additional-features.mdx b/ja-jp/documentation/pages/build/additional-features.mdx new file mode 100644 index 00000000..a2c89d37 --- /dev/null +++ b/ja-jp/documentation/pages/build/additional-features.mdx @@ -0,0 +1,103 @@ +> ⚠️ この文書は AI によって自動翻訳されています。不正確な箇所がある場合は、[英語版原文](../../../../en/documentation/pages/build/additional-features.mdx)を参照してください。 + +--- +title: "追加機能" +icon: "circle-plus" +--- + +機能を追加して、あなたのアプリケーションをより実用的にします。右上角の **機能** をクリックして機能を追加してください。 + + + +## ワークフローアプリケーション + + + ワークフローアプリケーションでは、「機能」を通じてファイルをアップロードする方法は廃止されました。代わりに[開始ノードのファイル変数](/zh/guides/workflow/node/start)を使用してください。 + + +ワークフローアプリケーションは「機能」を通じて**画像アップロード**のみをサポートします: + + + +**設定方法:** +1. 「機能」で画像アップロードを有効にする +2. ビジョン機能を持つ LLM ノードを追加する +3. VISION を有効にして `sys.files` 変数を選択する +4. 終了ノードに接続する + +## チャットフローアプリケーション + +チャットフローアプリケーションはより多くの機能をサポートします: + +- **会話の開始挨拶** - AI が先に挨拶をする +- **フォローアップ質問の提案** - 各回答後に次の質問を提案する +- **テキスト音声変換** - 回答内容を読み上げる(モデルプロバイダーで TTS の設定が必要) +- **ファイルアップロード** - ユーザーがファイルをアップロードできる +- **引用と帰属** - 知識検索使用時に情報源を表示する +- **コンテンツ審査** - 不適切なコンテンツをフィルタリングする + +## ファイルアップロード + +ほとんどの機能は有効にすると自動的に動作します。ファイルアップロードはより多くの設定が必要です。 + +**ユーザー向け**:クリップアイコンをクリックしてファイルをアップロード + +![ファイルアップロード](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/b18af11da3f339c496193d9732906849.png) + +**開発者向け**:ファイルは `sys.files` 変数に表示されます。異なるファイル形式には異なる処理方法が必要です: + +### 文書 + +大規模言語モデルはファイルを直接読み取ることができません。まず「文書抽出器」を使用してください。 + +1. ファイル形式で「文書」を有効にする +2. 「文書抽出器」ノードを追加し、`sys.files` を入力として使用する +3. LLM ノードを追加し、文書抽出器の出力を使用する +4. 「回答」ノードを追加し、LLM の出力を使用する + + + この方法では複数回の対話でファイルを記憶しません。ユーザーは毎回再アップロードする必要があります。永続化ファイルについては、[開始ノードのファイル変数](/zh/guides/workflow/node/start)を使用してください。 + + +### 画像 + +一部の大規模言語モデルは画像を直接分析できます。 + +1. ファイル形式で「画像」を有効にする加する +3. `sys.files` 変数を選択する +4. 「回答」ノードを追加し、LLM の出力を使用する + +![ビジョン機能を有効にする](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/3a3582bd9bc8ea94bbdbfeefe6a78571.png) + +### 混合ファイル形式 + +文書と画像を同時に処理する: + +1. 「画像」と「文書」を同時に有効にする +2. 2つの「リスト操作」ノードを追加してファイル形式をフィルタリングする +3. 画像をビジョン機能を持つ LLM に送信する +4. 文書を「文書抽出器」に送信する +5. 「回答」ノードで結果を統合する + +![混合ファイル形式](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/66471e8e67b2ede0c94bfa1cffeab834.png) + +### 音声と動画 + +大規模言語モデルはこれらのファイルを直接処理できません。音声/動画を処理するには[外部ツール](/zh/guides/extension/api-based-extension/external-data-tool)を使用する必要があります。 + +## 制限 + +- 各ファイル最大 15MB +- 一度に最大 10 ファイル \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/build/additional-features.mdx b/ja-jp/documja-jptation/pages/build/additional-features.mdx new file mode 100644 index 00000000..8158a816 --- /dev/null +++ b/ja-jp/documja-jptation/pages/build/additional-features.mdx @@ -0,0 +1,104 @@ +```mdx +--- +title: "追加機能" +icon: "circle-plus" +--- + +アプリをより便利にするために機能を追加します。右上の**Features**をクリックして機能を追加してください。 + + + +## ワークフローアプリ + + + ワークフローアプリでのFeaturesを介したファイルアップロードは廃止されました。[Startノードのファイル変数](/en/guides/workflow/node/start)を代わりに使用してください。 + + +ワークフローアプリでは、**画像アップロード**のみがFeatures経由でサポートされています: + + + +**設定方法:** +1. Featuresで画像アップロードを有効にする +2. 视觉能力があるLLMノードを追加する +3. VISIONを有効にし、`sys.files`変数を選択する +4. Endノードに接続する + +## チャットフローアプリ + +チャットフローアプリはより多くの機能を持っています: + +- **会話の開始** - AIが最初に挨拶 +- **フォローアップ** - レスポンス後に次の質問を提案 +- **文本转语音** - レスポンスを音声で読み上げる(モデルプロバイダーでTTSの設定が必要) +- **ファイルアップロード** - ユーザーがファイルをアップロード可能 +- **引用** - 知识检索を使用する際に情報源を表示 +- **コンテンツモデレーション** - 不適切なコンテンツをフィルタリング + +## ファイルアップロード + +大部分の機能は有効化すると自動的に動作しますが、ファイルアップロードには追加の設定が必要です。 + +**ユーザー向け**: クリップアイコンをクリックしてファイルをアップロード + +![ファイルをアップロード](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/b18af11da3f339c496193d9732906849.png) + +**開発者向け**: ファイルは`sys.files`変数に表示されます。異なるファイルタイプには異なる処理が必要です: + +### ドキュメント + +LLMはファイルを直接読み取れません。最初にドキュメント抽出器を使用してください。 + +1. ファイルタイプで「ドキュメント」を有効にする +2. `sys.files`を入力としてドキュメント抽出器ノードを追加する +3. ドキュメント抽出器の出力を使用してLLMノードを追加する +4. LLMの出力を持つ回答ノードを追加する + + + これでは会話間でファイルを記憶しません。ユーザーは毎回再アップロードする必要があります。永続的なファイルには、[Startノードのファイル変数](/en/guides/workflow/node/start)を使用してください。 + + +### 画像 + +一部のLLMは画像を直接分析することができます。 + +1. ファイルタイプで「画像」を有効にする +2. VISIONを有効にしたLLMノードを追加する +3. `sys.files`変数を選択する +4. LLMの出力を持つ回答ノードを追加する + +![ビジョンを有効にする](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/3a3582bd9bc8ea94bbdbfeefe6a78571.png) + +### 混合ファイルタイプ + +ドキュメントと画像の両方を処理します: + +1. 「画像」と「ドキュメント」の両方を有効にする +2. ファイルタイプをフィルタリングするための2つのリスト操作ノードを追加する +3. 画像をビジョンを持つLLMに送る +4. ドキュメントをドキュメント抽出器に送る +5. 結果を回答ノードで結合する + +![混合ファイルタイプ](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/66471e8e67b2ede0c94bfa1cffeab834.png) + +### オーディオとビデオ + +LLMはこれらを直接処理できません。オーディオ/ビデオ処理には[外部ツール](/en/guides/extension/api-based-extension/external-data-tool)が必要です。 + +## 制限 + +- ファイルあたり最大15MB +- 一度に最大10ファイル +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/build/mcp.mdx b/ja-jp/documja-jptation/pages/build/mcp.mdx new file mode 100644 index 00000000..cc24bc16 --- /dev/null +++ b/ja-jp/documja-jptation/pages/build/mcp.mdx @@ -0,0 +1,106 @@ +--- +title: "MCPツールの使用" +icon: "microchip" +--- + +[MCPサーバー](https://modelcontextprotocol.io/introduction)から外部ツールをDifyアプリに接続します。組み込みツールだけでなく、成長する[MCPエコシステム](https://mcpservers.org/)のツールを使用できます。 + + + これはDifyでMCPツールを使用することについて説明しています。DifyアプリをMCPサーバーとして公開するには、[こちら](/en/guides/application-publishing/publish-mcp)を参照してください。 + + + + 現在は[HTTPトランスポート](https://modelcontextprotocol.io/docs/concepts/architecture#transport-layer)を持つMCPサーバーのみサポートしています。 + + +## MCPサーバーの追加 + +ワークスペースで**ツール** → **MCP**に移動します。 + +![](/images/6cef1436fcc13a65ccedb54bcf5ab77eb87b8faba1098a85951839fb1907f2d2.png) + +**MCPサーバーを追加(HTTP)**をクリック: + +![](/images/b5429131836c1caae84f4ce8b3b806221e39636723644961ce2f2a97d5421f16.png) + +**サーバーURL**: MCPサーバーの場所(例:`https://api.notion.com/mcp`) + +**名前とアイコン**: 有用な名前を付けてください。Difyは自動的にアイコンを取得しようとします。 + +**サーバーID**: 一意の識別子(小文字、数字、アンダースコア、ハイフン、最大24文字) + + + 使用を開始したら、サーバーIDを変更しないでください。このサーバーのツールを使用するアプリが壊れます。 + + +## 次に何が起こるか + +Difyが自動的に: +1. サーバーに接続 +2. OAuth関連の処理を実行 +3. 利用可能なツールのリストを取得 +4. アプリビルダーで使用できるように設定 + +ツールが見つかるとサーバーカードが表示されます: + +![](/images/fcef5ecad1deca82a1d8988c4bcb7cec745a0cd47945ff05fca588502cfaafbc.png) + +## サーバーの管理 + +任意のサーバーカードをクリックして: + +**ツールを更新**: 外部サービスが新しいツールを追加したときに更新 + +![](/images/7b526a64ff34b10a357511b2cd3e42f251a6786210eac71c58ca7bfccdf63f0c.png) + +**再認証**: トークンが期限切れになったときに認証を修正 + +**設定を編集**: サーバーの詳細を変更(ただしIDは除く!) + +**削除**: サーバーを切断(そのツールを使用するアプリが壊れます) + +## MCPツールの使用 + +接続されると、MCPツールは期待される場所すべてに表示されます: + +**エージェント内**: ツールはサーバーごとにグループ化されて表示(「Notion MCP » ページを作成」) + +**ワークフロー内**: MCPツールがノードとして利用可能 + +**エージェントノード内**: 通常のエージェントと同様 + +## ツールのカスタマイズ + +MCPツールを追加するときにカスタマイズできます: + +![](/images/CleanShot2025-07-07at07.41.33@2x.png) + +**説明**: デフォルトの説明をより具体的なものにオーバーライド + +**パラメータ**: 各ツールパラメータに対して選択: +- **自動**: AIに値を決定させる +- **固定**: 変更されない特定の値を設定 + +**例**: 検索ツールの場合、`numResults`を5(ままにします。 + +## アプリの共有 + +MCPツールを使用するアプリをエクスポートするとき: +- エクスポートにはサーバーIDが含まれます +- 他の場所でアプリを使用するには、同じIDで同じサーバーを追加 +- アプリが必要とするMCPサーバーを文書化 + +## トラブルシューティング + +**「未設定サーバー」**: URLを確認して再認証 + +**ツールが見つからない**: 「ツールを更新」をクリック + +**アプリが壊れた**: おそらくサーバーIDを変更しました。元のIDで再度追加してください。 + +## ヒント + +- `github-prod`や`crm-system`のような永続的で説明的なサーバーIDを使用 +- 開発/ステージング/本番環境で同じMCP設定を維持 +- 設定項目には固定値を、動的入力には自動を設定 +- デプロイ前にMCPインテグレーションをテスト \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/build/orchestrate-node.mdx b/ja-jp/documja-jptation/pages/build/orchestrate-node.mdx new file mode 100644 index 00000000..6cd08d28 --- /dev/null +++ b/ja-jp/documja-jptation/pages/build/orchestrate-node.mdx @@ -0,0 +1,36 @@ +```mdx +--- +title: "フローロジック" +icon: "diagram-project" +--- + +ノードは接続方法に応じて異なる方法で実行されます。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/3984e13db72e2bd19870f5764ec000cf.jpeg) + +## 直列実行 + +ノードを次々と接続すると、それらは順番に実行されます。各ノードは、前のノードが終了するのを待ってから開始します。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/e8e884e146994b5f95cb16ec31cdd81b.png) + +各ノードは、チェーン内でそれ以前に実行された任意のノードから変数を使用できます。 + +## 並列実行 + +複数のノードを同じ開始ノードに接続すると、それらは同時に実行されます。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/5ba85864454880561ec95a37db382f20.png) + + +1つのノードから最大10個の並列ブランチを持つことができ、最大3レベルの入れ子になった並列構造を持つことができます。 + + +## 変数アクセス + +直列フローでは、ノードはチェーン内の任意の前のノードから変数にアクセスできます。 + +並列フローでは、ノードは並列分岐前に実行されたノードから変数にアクセスできますが、同時に実行されている他の並列ノードからは変数にアクセスできません。 + +並列ブランチが終了した後、下流のノードはすべての並列出力から変数にアクセスできます。 +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/build/predefined-error-handling-logic.mdx b/ja-jp/documja-jptation/pages/build/predefined-error-handling-logic.mdx new file mode 100644 index 00000000..2bbe1e86 --- /dev/null +++ b/ja-jp/documja-jptation/pages/build/predefined-error-handling-logic.mdx @@ -0,0 +1,88 @@ +```mdx +--- +title: "エラーの処理" +icon: "arrow-rotate-right" +--- + +![](https://assets-docs.dify.ai/2024/12/6e2655949889d4d162945d840d698649.png) +[大規模言語モデル](/en/guides/workflow/node/llm), [HTTP](/en/guides/workflow/node/http-request), [コード](/en/guides/workflow/node/code), および [ツール](/en/guides/workflow/node/tools) ノードは、エラー処理を標準でサポートしています。ノードが失敗した場合、以下の3つの動作のいずれかを取ることができます。 + + + + デフォルトの動作です。ノードが失敗した場合、全体のワークフローが停止し、元のエラーメッセージが表示されます。 + + 以下のような場合に使用します: + - テスト中で何が壊れたのかを確認したい時 + - このステップなしではワークフローを続行できない時 + + + ノードが失敗した場合に、代替値を使用します。ワークフローは継続します。 + + ![](https://assets-docs.dify.ai/2024/12/e9e5e757090679243e0c9976093c7e6c.png) + + **要件** + - デフォルト値はノードの出力タイプと一致している必要があります。文字列を出力する場合、デフォルトも文字列でなければなりません。 + + **例** + + 通常、あなたの大規模言語モデルノードは分析を返しますが、時折レート制限のために失敗します。このようなデフォルト値を設定します: + + ``` + "申し訳ありませんが、一時的に利用できません。数分後に再試行してください。" + ``` + + これにより、ユーザーは壊れたワークフローではなく、役立つメッセージを受け取ります。 + + + ノードが失敗した場合、エラーを処理するための別のフローをトリガーします。 + + ![](https://assets-docs.dify.ai/2024/12/e5ea1af947818bd9e27cab3042c1c4f3.png) + + 失敗分岐はオレンジ色で表示されます。以下のことができます: + - エラーメッセージを送信する + - 別のアプローチを試みる + - デバッグのためにエラーをログに記録する + - 代替サービスを使用する + **例** + + メインのAPIが失敗した場合、失敗分岐が代替APIを呼び出します。ユーザーは問題があったことを知りません。 + + + +## ループ/イテレーションノードでのエラー + +ループやイテレーション内で子ノードが失敗した場合、これらの制御フローノードには独自のエラー動作があります。 + +**ループノード**は、子ノードが失敗した場合、常に即座に停止します。ループ全体が終了し、エラーを返し、以降のイテレーションは実行されません。 + +**イテレーションノード**は、エラー処理モード設定を通じて子ノードの失敗をどのように処理するかを選択できます: + +- `terminated` - いずれかの項目が失敗した場合、即座に処理を停止します(デフォルト) +- `continue-on-error` - 失敗した項目をスキップし、次の項目を続行します +- `remove-abnormal-output` - 処理を続行しますが、失敗した項目を最終出力から除外します + +イテレーションを `continue-on-error` に設定すると、失敗した項目は出力配列で `null` を返します。 `remove-abnormal-output` を使用すると、出力配列には成功した結果のみが含まれるため、入力配列よりも短くなります。 + +## エラー変数 + +デフォルト値または失敗分岐を使用する場合、2つの特別な変数を取得します: + +- `error_type` - どのような種類のエラーが発生したか([エラーの種類](en/guides/workflow/error-handling/error-type)を参照) +- `error_message` - 実際のエラーの詳細 + +これを使用して: +- ユーザーに役立つメッセージを表示する +- チームに警告を送信する +- 異なる回復戦略を選択する +- デバッグのためにエラーを記録する + +**例** + +``` +{% if error_type == "rate_limit" %} +リクエストが多すぎます。少し待ってから再試行してください。 +{% else %} +何か問題が発生しました。私たちのチームが通知されました。 +{% endif %} +``` +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/build/shortcut-key.mdx b/ja-jp/documja-jptation/pages/build/shortcut-key.mdx new file mode 100644 index 00000000..1e9217dc --- /dev/null +++ b/ja-jp/documja-jptation/pages/build/shortcut-key.mdx @@ -0,0 +1,150 @@ +```mdx +--- +title: "ホットキー" +icon: "keyboard" +--- + +キーボードショートカットでワークフローの構築をスピードアップします。 + +## ノード操作 +キャンバス上で選択されたノードに対して: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
WindowsmacOSアクション
Ctrl + CCmd + Cノードをコピー
Ctrl + VCmd + Vノードをペースト
Ctrl + DCmd + Dノードを複製
DeleteDelete選択したノードを削除
Ctrl + OCmd + Oノードを自動配置
ShiftShift変数の依存関係を可視化(単一ノードのみ)
+ +## キャンバスナビゲーション + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
WindowsmacOSアクション
Ctrl + 1Cmd + 1表示に合わせる
Ctrl + -Cmd + -ズームアウト
Ctrl + =Cmd + =ズームイン
Shift + 1Shift + 1100%にリセット
Shift + 5Shift + 550%に設定
HH手のひらツール(パン)
VV選択ツール
+ +## 履歴 + + + + + + + + + + + + + + + + + + + + + + + + + + +
WindowsmacOSアクション
Ctrl + ZCmd + Z元に戻す
Ctrl + YCmd + Yやり直し
Ctrl + Shift + ZCmd + Shift + Zやり直し
+ +## テスト + + + + + + + + + + + + + + + + +
WindowsmacOSアクション
Alt + ROption + Rワークフローを実行
+``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/build/version-control.mdx b/ja-jp/documja-jptation/pages/build/version-control.mdx new file mode 100644 index 00000000..eec0260e --- /dev/null +++ b/ja-jp/documja-jptation/pages/build/version-control.mdx @@ -0,0 +1,103 @@ +```mdx +--- +title: "バージョン管理" +icon: "layer-group" +--- + +ChatflowとWorkflowアプリで変更を追跡し、バージョンを管理します。 + + + 現在、ChatflowとWorkflowアプリでのみ利用可能です。 + + +## 仕組み + +**現在のドラフト**: あなたの作業バージョンです。ここで変更を行います。ユーザーには公開されません。 + +![](https://assets-docs.dify.ai/2025/03/38296a597c0ca31b5fb70be2234f2363.png) + +**最新バージョン**: ユーザーが見るライブバージョンです。 + +![](https://assets-docs.dify.ai/2025/03/e4c06a0817c30cf9e8893487c889cb02.png) + +**以前のバージョン**: 以前に公開されたバージョンです。 + +![](https://assets-docs.dify.ai/2025/03/4cd05033b93d84b53496f3d02e88601f.png) + +## バージョンの公開 + +**公開** → **更新を公開**をクリックして、ドラフトをライブにします。 + +![](https://assets-docs.dify.ai/2025/03/26f3f324ab4ecb965708d553ddd78d97.png) + +あなたのドラフトは新しい最新バージョンになり、新しいドラフトが作成されます。 + +![](https://assets-docs.dify.ai/2025/03/67e95de17577bc272addad6c33f8ea59.png) + +## バージョンの表示 + +履歴アイコンをクリックしてすべてのバージョンを確認します: + +![](https://assets-docs.dify.ai/2025/03/eed667bbc9498425342c09039054cf98.png) + +以下でフィルタリング: +- **すべてのバージョン** または **自分のもののみ** +- **名前付きバージョンのみ**(自動生成された名前は除外) + +![](https://assets-docs.dify.ai/2025/03/0bf8fef8858671a8fef160f49dd83dad.jpg) + +## バージョンの管理 + +**バージョンに名前を付ける**: 自動生成された名前の代わりに適切な名前を付けます + +![](https://assets-docs.dify.ai/2025/03/ac149f63da6611d7080d305dd3fad65c.jpg) + +**バージョン情報を編集**: 名前を変更し、リリースノートを追加します + +![](https://assets-docs.dify.ai/2025/03/1d840edf979132a9bbf1e065f95e663c.jpg) + +**古いバージョンを削除**: 不要なバージョンを整理します + +![](https://assets-docs.dify.ai/2025/03/25ad1999fc9f6f44fcac04526ac5563a.jpg) + + + 現在のドラフトや最新バージョンを削除することはできません。 + + +**バージョンを復元**: 古いバージョンをドラフトに戻します + +![](https://assets-docs.dify.ai/2025/03/c96b714accc29df8e46e711782a7a6a9.jpg) + + + これにより現在のドラフトが完全に置き換えられます。未保存の作業がないことを確認してください。 + + +## 例示的なワークフロー + +典型的な開発サイクルでバージョンがどのように機能するかを示します: + +### 1. ドラフトから始める +![](https://assets-docs.dify.ai/2025/03/35ece9d5d5d4d8c46a3fb5ceae4d0c15.jpeg) + +### 2. 最初のバージョンを公開 +![](https://assets-docs.dify.ai/2025/03/3d1f66cdeb08710f01462a6b0f3ed0a8.jpeg) + +### 3. 二番目のバージョンを公開 +![](https://assets-docs.dify.ai/2025/03/92ffbf88a3cbeeeeab47c1bd8b4f7198.jpeg) + +### 4. 古いバージョンをドラフトに復元 +![](https://assets-docs.dify.ai/2025/03/541f1891416af90dab5b51bfec833249.jpeg) + +### 5. 復元したバージョンを公開 +![](https://assets-docs.dify.ai/2025/03/3572a4f2edef166c3f14e4ec4e68b297.jpeg) + +完全なデモ: +![](https://assets-docs.dify.ai/2025/03/dc7c15a4dfafb72ce7fffea294d5b5e5.gif) + +## ヒント + +- 公開前に必ずドラフトでテストする +- 重要なリリースには説明的なバージョン名を使用する +- 迅速にロールバックする必要がある場合にバージョンを復元する +- 参照用に古いバージョンを保持しておく +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/debug/error-type.mdx b/ja-jp/documja-jptation/pages/debug/error-type.mdx new file mode 100644 index 00000000..6fbfde69 --- /dev/null +++ b/ja-jp/documja-jptation/pages/debug/error-type.mdx @@ -0,0 +1,108 @@ +```mdx +--- +title: エラータイプ +icon: "circle-xmark" +--- + +各ノードタイプは、何が間違っていたのか、どのように修正するかを理解するのに役立つ特定のエラークラスをスローします。 + +## ノード固有のエラー + + + + +`CodeNodeError` +Python または JavaScript コードが実行中に例外をスローしました + +![コードエラー](https://assets-docs.dify.ai/2024/12/c86b11af7f92368180ea1bac38d77083.png) + +`OutputValidationError` +コードが返したデータ型が設定された出力変数の型と一致しません + +`DepthLimitError` +コードが5レベル以上のネストされたデータ構造を作成しました + +`CodeExecutionError` +サンドボックスサービスがコードを実行できませんでした - 通常はサービスがダウンしていることを意味します + +![](https://assets-docs.dify.ai/2024/12/ab8cae01a590b037017dfe9ea4dbbb8b.png) + + + + +`VariableNotFoundError` +プロンプトテンプレートが、ワークフローコンテキストに存在しない変数を参照しています + +![](https://assets-docs.dify.ai/2024/12/f20c5fbde345144de6183374ab277662.png) + +`InvalidContextStructureError` +コンテキストフィールドに文字列のみを受け入れる配列またはオブジェクトを渡しました + +`NoPromptFoundError` +プロンプトフィールドが完全に空です + +`ModelNotExistError` +LLMノード設定でモデルが選択されていません + +`LLMModeRequiredError` +選択されたモデルに有効なAPIクレデンシャルが設定されていません + +`InvalidVariableTypeError` +プロンプトテンプレートがJinja2の構文またはプレーンテキスト形式として有効ではありません + +![](https://assets-docs.dify.ai/2024/12/9882f7a5ee544508ba11b51fb469a911.png) + + + + +`AuthorizationConfigError` +APIエンドポイントの認証設定が欠落しているか無効です + +`InvalidHttpMethodError` +HTTPメソッドはGET、HEAD、POST、PUT、PATCH、またはDELETEでなければなりません + +`ResponseSizeError` +API応答が10MBのサイズ制限を超えました + +`FileFetchError` +リクエストで参照されているファイル変数を取得できませんでした + +`InvalidURLError` +URL形式が正しくないか、到達不能です + + + + +`ToolParameterError` +ツールに渡されたパラメータが期待されるスキーマと一致しません + +`ToolFileError` +ツールが必要なファイルにアクセスできませんでした + +`ToolInvokeError` +外部ツールAPIが実行中にエラーを返しました + +

+ +

+ +`ToolProviderNotFoundError` +ツールプロバイダーがインストールされていないか、正しく設定されていません + +
+
+ +## システムレベルのエラー + +`InvokeConnectionError` +外部サービスへのネットワーク接続が失敗しました + +`InvokeServerUnavailableError` +外部サービスが503ステータスを返したか、一時的にダウンしています + +`InvokeRateLimitError` +APIまたはモデルプロバイダーのレート制限に達しました + +`QuotaExceededError` +このサービスの使用クォータを超えました +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/debug/history-and-logs.mdx b/ja-jp/documja-jptation/pages/debug/history-and-logs.mdx new file mode 100644 index 00000000..551878d4 --- /dev/null +++ b/ja-jp/documja-jptation/pages/debug/history-and-logs.mdx @@ -0,0 +1,46 @@ +```mdx +--- +title: "ログ" +icon: "memo" +--- + +Difyは、あなたのワークフローが実行されるたびに詳細なログを記録します。アプリケーションレベルと個々のノードの両方で何が起こったかを見ることができます。 + + +公開後のライブユーザーからのログについては、[ログとアノテーション](/en/guides/annotation/logs)を参照してください。 + + +## アプリケーションログ + +各ワークフロー実行は完全なログエントリを作成します。任意のエントリをクリックすると、次の3つのセクションが表示されます: + +![](https://assets-docs.dify.ai/2025/04/08a885858cfa6e8863faac891a5be319.png) + +### 結果 + +ユーザーが見る最終的な出力を表示します。ワークフローが失敗した場合、ここにエラーメッセージが表示されます。 + +![](https://assets-docs.dify.ai/2025/06/22856751d278ffad99d0533d2d96e125.png) + + +ワークフローアプリケーションのみ利用可能です。 + + +### 詳細 + +実行からの元の入力、最終出力、システムのメタデータを表示します。 + +![](https://assets-docs.dify.ai/2025/06/882b783cd843ab666f5bc3c06f78521d.png) + +### トレース + +ワークフローがどのように実行されたかを正確に示し、どのノードがどの順序で実行され、各ノードがどのくらいの時間を要したか、データがどのように流れたかを表示します。これは、ボトルネックを見つけたり、分岐やループを持つ複雑なワークフローを理解するのに役立ちます。 + +![](https://assets-docs.dify.ai/2025/06/9e614ac01b1f6e0aeadda78c91ce93b7.png) + +## ノードログ + +個別のノードの最後の実行も確認できます。ノードの設定パネルで「最後の実行」をクリックすると、その最近の入力、出力、およびタイミングの詳細が表示されます。 + +![](https://assets-docs.dify.ai/2025/06/9c6e57236d85f426a930424863042d7d.png) +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/debug/step-run.mdx b/ja-jp/documja-jptation/pages/debug/step-run.mdx new file mode 100644 index 00000000..d7948bfc --- /dev/null +++ b/ja-jp/documja-jptation/pages/debug/step-run.mdx @@ -0,0 +1,34 @@ +```mdx +--- +title: "シングルノード" +icon: "code-commit" +--- + +個別のノードをテストするか、ワークフローをステップバイステップで実行して公開前に問題を見つけます。 + +## シングルノードテスト + +ワークフロー全体を実行せずに任意のノードを個別にテストできます。ノードを選択し、設定パネルでテスト入力を行い、「実行」をクリックして出力を確認します。 + +![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) + +テスト後、「最終実行」をクリックして、入力、出力、タイミング、エラーメッセージなどの実行詳細を確認します。 + + +AnswerノードとEndノードはシングルノードテストをサポートしていません。 + + +## ステップバイステップの実行 + +ノードを一度に一つずつ実行する際、その出力は変数インスペクターにキャッシュされます。これらのキャッシュされた変数を編集して、上流のノードを再実行せずに異なるシナリオをテストできます。 + +![](https://assets-docs.dify.ai/2025/06/f8656d8deeeaefeab0a8d9169f0ed2d3.png) + +これは、ノードが異なるデータにどのように反応するかをテストしたいときに便利です。インスペクターで変数の値を変更し、再度ノードを実行するだけです。 + +## 実行履歴の表示 + +各ノードの実行は記録を作成します。任意のノードで「最終実行」をクリックして、最新の実行詳細を確認し、どのデータが入力され、何が出力され、どのくらい時間がかかったかを確認します。 + +![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/debug/variable-inspect.mdx b/ja-jp/documja-jptation/pages/debug/variable-inspect.mdx new file mode 100644 index 00000000..fa197e00 --- /dev/null +++ b/ja-jp/documja-jptation/pages/debug/variable-inspect.mdx @@ -0,0 +1,34 @@ +```mdx +--- +title: "ワークフロー" +icon: "arrow-progress" +--- + +Variable Inspectorは、ワークフローを通じて流れるすべてのデータを表示します。各ノードが実行された後の入力と出力をキャプチャし、何が起こっているのかを確認し、さまざまなシナリオをテストすることができます。 + +![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png) + +## 変数の表示 + +任意のノードが実行された後、その出力変数は画面下部のインスペクターパネルに表示されます。任意の変数をクリックすると、その全内容を確認できます。 + +![](https://assets-docs.dify.ai/2025/06/94a4741c25204db5fd1281ec475093d9.png) + +## 変数の編集 + +ほとんどの変数の値はクリックして編集できます。下流のノードを実行するとき、編集した値が元のものの代わりに使用されます。これにより、ワークフロー全体を再実行せずに異なるシナリオをテストすることができます。 + + +ここで変数を編集しても、元のノードの「最後の実行」記録は変更されません。 + + +例えば、大型言語モデル(LLM)ノードが `SELECT * FROM users` のようなSQLを生成する場合、インスペクターで `SELECT username FROM users` に編集して、データベースノードのみを再実行して異なる結果を見ることができます。 + +![](https://assets-docs.dify.ai/2025/06/fb8c49fc0c8c63866f1a9379e8752d9e.png) + +## 変数のリセット + +任意の変数の横にあるリバートアイコンをクリックして元の値を復元するか、「すべてリセット」をクリックしてすべてのキャッシュされた変数を一度にクリアします。 + +![](https://assets-docs.dify.ai/2025/06/b713290543a0feb95ecab65336e97483.png) +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/getting-started/faq.md b/ja-jp/documja-jptation/pages/getting-started/faq.md new file mode 100644 index 00000000..56c28daf --- /dev/null +++ b/ja-jp/documja-jptation/pages/getting-started/faq.md @@ -0,0 +1,114 @@ +```mdx +# よくある質問 + +Dify の FAQ セクションへようこそ。ここでは、Dify の使用に関してよくある質問への回答を見つけることができます。 + +## 入門 + +### Dify とは何ですか? + +Dify は、AI アプリケーションを構築するためのオープンソースプラットフォームです。広範なツールと機能を提供し、広範なコーディング知識がなくても AI アプリケーションを構築、デプロイ、管理するのを支援します。 + +### Dify の始め方は? + +Dify を始めるには: + +1. [dify.ai](https://dify.ai) で Dify アカウントに**サインアップ**します +2. 直感的なインターフェイスを使用して**最初のアプリケーションを作成**します +3. OpenAI、Anthropic、その他のプロバイダーに接続して**AI モデルを構成**します +4. アプリケーションで**テストと反復**を行います +5. AI アプリケーションを**本番環境にデプロイ**します + +### Dify ではどのような種類のアプリケーションを構築できますか? + +Dify を使用してさまざまな種類の AI アプリケーションを構築できます: + +- カスタマーサービス用の**チャットボット** +- ドキュメントに関する質問に回答できる**知識ベースアシスタント** +- データをインテリジェントに処理する**ワークフロー自動化ツール** +- マーケティングやライティングのための**コンテンツ生成ツール** +- 複雑なタスクを実行できる**AI エージェント** + +## 技術的な質問 + +### Dify はどの AI モデルをサポートしていますか? + +Dify は以下を含む幅広い AI モデルをサポートしています: + +- **OpenAI モデル**:GPT-4、GPT-3.5 など +- **Anthropic モデル**:Claude 3 および Claude 2 +- **オープンソースモデル**:Hugging Face、Ollama などのプロバイダーを通じて +- **ローカルモデル**:独自にホストできます + +### Dify は私のデータをどのように処理しますか? + +データのセキュリティとプライバシーは私たちの最優先事項です: + +- **あなたのデータはあなたのもの** - 私たちはあなたのプライベートデータでトレーニングを行いません +- **転送中および保存時の暗号化** +- エンタープライズ顧客向けの**SOC2 準拠** +- ヨーロッパのユーザー向けの**GDPR 準拠** + +### Dify は商業目的で使用できますか? + +はい! Dify は以下を提供しています: + +- 自己ホスティング用の Apache 2.0 ライセンスを持つ**オープンソースバージョン** +- マネージドホスティング用の商用プランを持つ**クラウドバージョン** +- 高度な機能とサポートを備えた**エンタープライズプラン** + +## トラブルシューティング + +### 私の AI アプリケーションが誤った応答を返しています + +これらのトラブルシューティング手順を試してください: + +1. **プロンプトを確認** - 明確で具体的であることを確認します +2. **知識ベースを確認** - 関連するドキュメントがアップロードされていることを確認します +3. **モデルパラメータを調整** - 異なる温度または TopK 設定を試してください +4. **異なるモデルでテスト** - 特定のタスクに対してより良いモデルが存在する場合があります + +### 応答時間が遅くなっています + +応答時間を改善するには: + +1. **モデルの構成を確認** - 一部のモデルは他のモデルより高速です +2. **知識ベースを最適化** - 不要なドキュメントを削除します +3. **キャッシュを使用** - よくある質問に対して応答キャッシュを有効にします +4. より良いパフォーマンスのために**プランのアップグレードを検討** + +### サポートを受けるにはどうすればよいですか? + +サポートを受ける方法: + +- **コミュニティフォーラム** - 他の Dify ユーザーとつながる +- **ドキュメント** - 包括的なガイドとチュートリアル +- **GitHub の問題** - バグ報告と機能リクエスト +- **メールサポート** - 有料プランの顧客向け +- **エンタープライズサポート** - エンタープライズ顧客向けの専用サポート + +## 請求とプラン + +### 異なる料金プランは何ですか? + +Dify はいくつかのプランを提供しています: + +- **無料ティア** - 始めるのに最適で、小規模プロジェクト向け +- **プロプラン** - 使用量の多い成長企業向け +- **エンタープライズプラン** - 大規模組織向けのカスタムソリューション + +### 使用量はどのように計算されますか? + +使用量は通常、以下に基づいて計算されます: + +- AI モデルへの**API コール** +- ドキュメントとデータの**ストレージ** +- アプリケーション上の**アクティブユーザー** +- プランに応じた**カスタム機能** + +詳細な料金情報については、[料金ページ](https://dify.ai/pricing)をご覧ください。 + +--- + +さらにサポートが必要ですか?サポートチームに連絡するか、[包括的なドキュメント](../../../guides/)をご覧ください。 +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/getting-started/faq.mdx b/ja-jp/documja-jptation/pages/getting-started/faq.mdx new file mode 100644 index 00000000..ba89b7ed --- /dev/null +++ b/ja-jp/documja-jptation/pages/getting-started/faq.mdx @@ -0,0 +1,128 @@ +```mdx +--- +title: "よくある質問" +description: "Difyの使用に関する一般的な質問と回答" +icon: "circle-question" +--- + +DifyのFAQセクションへようこそ。ここでは、Difyの使用に関する最も一般的な質問への回答を見つけることができます。 + +## はじめに + + + + DifyはAIアプリケーションを構築するためのオープンソースプラットフォームです。広範なツールと機能を提供し、広範なコーディング知識なしでAIアプリケーションを構築、展開、管理するのをサポートします。 + + + + Difyを始めるには: + + 1. [dify.ai](https://dify.ai)でDifyアカウントに**サインアップ**します + 2. 直感的なインターフェースを使用して**最初のアプリケーションを作成**します + 3. OpenAI、Anthropic、その他のプロバイダに接続して**AIモデルを設定**します + 4. アプリケーションを**テストして反復**します + 5. AIアプリケーションを**本番環境に展開**します + + + + Difyを使用して構築できるAIアプリケーションの種類: + + - カスタマーサービス用の**チャットボット** + - ドキュメントに関する質問に答えられる**知識庫アシスタント** + - データをインテリジェントに処理する**ワークフロー自動化ツール** + - マーケティングやライティング向けの**コンテンツ生成ツール** + - 複雑なタスクを実行できる**AIエージェント** + + + +## 技術的な質問 + + + + Difyは幅広いAIモデルをサポートしています: + + - **OpenAIモデル**: GPT-4、GPT-3.5など + - **Anthropicモデル**: Claude 3およびClaude 2 + - **オープンソースモデル**: Hugging Face、Ollamaなどのプロバイダを通じて + - **ローカルモデル**: 自分のモデルをホストすることができます + + + + データのセキュリティとプライバシーは最優先事項です: + + - **データはあなたのものです** - 私たちはあなたのプライベートデータを使って学習しません + - **転送中および保存時の暗号化** + - エンタープライズ顧客向けの**SOC2準拠** + - ヨーロッパのユーザー向けの**GDPR準拠** + + + + はい!Difyは以下を提供しています: + + - 自己ホスティング用のApache 2.0ライセンスを持つ**オープンソースバージョン** + - マネージドホスティング用の商業プランを持つ**クラウドバージョン** + - 高度な機能とサポートを備えた**エンタープライズプラン** + + + +## トラブルシューティング + + + + 次のトラブルシューティング手順を試してください: + + 1. **プロンプトを見直す** - 明確で具体的であることを確認してください + 2. **知識ベースを確認** - 関連するドキュメントがアップロードされていることを確認してください + 3. **モデルのパラメータを調整** - 異なる温度やTopK設定を試してください + 4. **異なるモデルでテスト** - 特定のタスクに対してはより良いモデルがあります + + + + 応答時間を改善するには: + + 1. **モデル設定を確認** - いくつかのモデルは他のものよりも速いです + 2. **知識ベースを最適化** - 不必要なドキュメントを削除します + 3. **キャッシングを使用** - よくある質問の応答キャッシングを有効にします + 4. パフォーマンス向上のために**プランをアップグレード**を検討してください + + + + サポートを受けるには: + + - **コミュニティフォーラム** - 他のDifyユーザーとの交流 + - **ドキュメント** - 包括的なガイドとチュートリアル + - **GitHubの問題** - バグ報告や機能リクエスト + - **メールサポート** - 有料プランの顧客向け + - **エンタープライズサポート** - エンタープライズ顧客向けの専用サポート + + + +## 請求とプラン + + + + Difyは以下のプランを提供しています: + + - **無料ティア** - 始めるのに最適で、小規模プロジェクト向け + - **プロプラン** - 高い使用量が必要な成長中のビジネス向け + - **エンタープライズプラン** - 大規模組織向けのカスタムソリューション + + + + 使用量は通常以下に基づいて計算されます: + + - AIモデルへの**APIコール** + - ドキュメントとデータの**ストレージ** + - アプリケーション上の**アクティブユーザー** + - プランに応じた**カスタム機能** + + 詳細な料金情報については、[料金ページ](https://dify.ai/pricing)をご覧ください。 + + + +--- + + + もっと助けが必要ですか? サポートチームに連絡するか、[包括的なドキュメント](../../../guides/)を確認してください。 + +``` \ No newline at end of file diff --git a/ja-jp/documja-jptation/pages/getting-started/quick-start.mdx b/ja-jp/documja-jptation/pages/getting-started/quick-start.mdx new file mode 100644 index 00000000..76d401b7 --- /dev/null +++ b/ja-jp/documja-jptation/pages/getting-started/quick-start.mdx @@ -0,0 +1,165 @@ +```mdx +--- +title: "10分でクイックスタート" +description: "Difyを使った簡単なアプリの作成" +icon: "forward" +--- + +Difyの本当の価値は、どんなに複雑なアイデアでも簡単に構築、展開、スケールできる点にあります。迅速なプロトタイピング、スムーズな反復、信頼性のある展開をあらゆるレベルで実現するために構築されています。 + +まずは、信頼できる大規模言語モデル(LLM)の統合を学びましょう。このガイドでは、ユーザーの質問を分類し、LLMを使用して直接応答し、国ごとの面白い事実で応答を強化するシンプルなチャットボットを構築します。 + + + +## 工作流应用 + + + 工作流应用中的功能文件上传已被弃用。请改用[启动节点上的文件变量](/en/guides/workflow/node/start)。 + + +工作流应用仅支持通过功能进行**图像上传**: + + + +**设置方法:** +1. 在功能中启用图像上传 +2. 添加具有视觉能力的LLM节点 +3. 启用视觉并选择`sys.files`变量 +4. 连接到结束节点 + +## 对话流应用 + +对话流应用获得更多功能: + +- **对话开启者** - AI首先打招呼 +- **跟进** - 在响应后建议下一个问题 +- **文本转语音** - 大声朗读响应(需要在模型提供商中设置TTS) +- **文件上传** - 用户可以上传文件 +- **引用** - 在使用知识检索时显示来源 +- **内容审核** - 过滤不当内容 + +## 文件上传 + +大多数功能在启用后会自动工作。文件上传需要更多设置。 + +**对于用户**:点击回形针图标上传文件 + +![上传文件](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/b18af11da3f339c496193d9732906849.png) + +**对于开发者**:文件显示在`sys.files`变量中。不同的文件类型需要不同的处理方式: + +### 文档 + +LLM不能直接读取文件。请先使用文档提取器。 + +1. 在文件类型中启用“文档” +2. 添加文档提取器节点,将`sys.files`作为输入 +3. 添加使用文档提取器输出的LLM节点 +4. 添加答案节点,使用LLM输出 + + + 这不会在对话之间记住文件。用户需要每次重新上传。对于持久文件,请使用[启动节点文件变量](/en/guides/workflow/node/start)。 + + +### 图像 + +某些LLM可以直接分析图像。 + +1. 在文件类型中启用“图像” +2. 添加启用视觉的LLM节点 +3. 选择`sys.files`变量 +4. 添加答案节点,使用LLM输出 + +![启用视觉](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/3a3582bd9bc8ea94bbdbfeefe6a78571.png) + +### 混合文件类型 + +同时处理文档和图像: + +1. 启用“图像”和“文档” +2. 添加两个列表操作节点以筛选文件类型 +3. 将图像发送到具有视觉的LLM +4. 将文档发送到文档提取器 +5. 在答案节点中合并结果 + +![混合文件类型](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/66471e8e67b2ede0c94bfa1cffeab834.png) + +### 音频和视频 + +LLM不能直接处理这些。您需要[外部工具](/en/guides/extension/api-based-extension/external-data-tool)来处理音频/视频。 + +## 限制 + +- 每个文件最大15MB +- 一次最多10个文件 +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/build/mcp.mdx b/zh-hans/documzh-hanstation/pages/build/mcp.mdx new file mode 100644 index 00000000..f790fe95 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/build/mcp.mdx @@ -0,0 +1,108 @@ +```mdx +--- +title: "使用 MCP 工具" +icon: "microchip" +--- + +将外部工具从 [MCP 服务器](https://modelcontextprotocol.io/introduction) 连接到您的 Dify 应用程序。除了内置工具外,您还可以使用不断增长的 [MCP 生态系统](https://mcpservers.org/)中的工具。 + + + 本文涵盖在 Dify 中使用 MCP 工具。要将 Dify 应用程序发布为 MCP 服务器,请参见[此处](/en/guides/application-publishing/publish-mcp)。 + + + + 目前仅支持具有 [HTTP 传输](https://modelcontextprotocol.io/docs/concepts/architecture#transport-layer)的 MCP 服务器。 + + +## 添加 MCP 服务器 + +前往您的工作区中的 **工具** → **MCP**。 + +![](/images/6cef1436fcc13a65ccedb54bcf5ab77eb87b8faba1098a85951839fb1907f2d2.png) + +点击 **添加 MCP 服务器 (HTTP)**: + +![](/images/b5429131836c1caae84f4ce8b3b806221e39636723644961ce2f2a97d5421f16.png) + +**服务器 URL**:MCP 服务器所在位置(例如 `https://api.notion.com/mcp`) + +**名称和图标**:将其命名为有用的名称。Dify 会尝试自动获取图标。 + +**服务器 ID**:唯一标识符(小写字母、数字、下划线、连字符,最多 24 个字符) + + + 一旦开始使用,切勿更改服务器 ID。这将导致使用该服务器工具的应用程序无法运行。 + + +## 接下来会发生什么 + +Dify 自动: +1. 连接到服务器 +2. 处理任何 OAuth 相关问题 +3. 获取可用工具列表 +4. 在您的应用程序构建器中提供这些工具 + +一旦找到工具,您将看到一个服务器卡片: + +![](/images/fcef5ecad1deca82a1d8988c4bcb7cec745a0cd47945ff05fca588502cfaafbc.png) + +## 管理服务器 + +点击任何服务器卡片以: + +**更新工具**:当外部服务添加新工具时刷新 + +![](/images/7b526a64ff34b10a357511b2cd3e42f251a6786210eac71c58ca7bfccdf63f0c.png) + +**重新授权**:在令牌过期时修复授权 + +**编辑设置**:更改服务器详细信息(但不能更改 ID!) + +**移除**:断开与服务器的连接(这将导致使用其工具的应用程序无法运行) + +## 使用 MCP 工具 + +连接后,MCP 工具将在您期望的地方出现: + +**在智能代理中**:工具按服务器分组显示(例如“Notion MCP » 创建页面”) + +**在工作流中**:MCP 工具可用作节点 + +**在智能代理节点中**:与常规智能代理相同 + +## 自定义工具 + +添加 MCP 工具时,您可以自定义它: + +![](/images/CleanShot2025-07-07at07.41.33@2x.png) + +**描述**:覆盖默认描述以更具体 + +**参数**:对于每个工具参数,选择: +- **自动**:让 AI 决定值 +- **固定**:设置一个永不改变的特定值 + +**示例**:对于搜索工具,将 `numResults` 设置为 5(固定),但将 `query` 保持为自动。 + +## 共享应用程序 + +当您导出使用 MCP 工具的应用程序时: +- 导出包括服务器 ID +- 要在其他地方使用应用程序,请添加具有相同 ID 的相同服务器 +- 记录您的应用程序需要哪些 MCP 服务器 + +## 疑难解答 + +**“未配置的服务器”**:检查 URL 并重新授权 + +**缺少工具**:点击“更新工具” + +**应用程序损坏**:您可能更改了服务器 ID。使用原始 ID 添加回去。 + +## 提示 + +- 使用永久性、描述性的服务器 ID,如 `github-prod` 或 `crm-system` +- 在开发/测试/生产环境中保持相同的 MCP 设置 +- 为配置项目设置固定值,为动态输入保持自动 +- 在部署前测试 MCP 集成 +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/build/orchestrate-node.mdx b/zh-hans/documzh-hanstation/pages/build/orchestrate-node.mdx new file mode 100644 index 00000000..b2650501 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/build/orchestrate-node.mdx @@ -0,0 +1,36 @@ +```mdx +--- +title: "流程逻辑" +icon: "diagram-project" +--- + +节点的执行方式取决于你如何连接它们。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/3984e13db72e2bd19870f5764ec000cf.jpeg) + +## 串行执行 + +当你一个接一个地连接节点时,它们按顺序执行。每个节点在前一个节点完成后才开始。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/e8e884e146994b5f95cb16ec31cdd81b.png) + +每个节点可以使用链中之前运行的任何节点的变量。 + +## 并行执行 + +当你将多个节点连接到同一个起始节点时,它们会同时运行。 + +![](https://assets-docs.dify.ai/dify-enterprise-mintlify/en/guides/workflow/5ba85864454880561ec95a37db382f20.png) + + +从一个节点最多可以有10个并行分支,以及最多3级嵌套的并行结构。 + + +## 变量访问 + +在串行流程中,节点可以访问链中任何前面节点的变量。 + +在并行流程中,节点只能访问并行分支之前运行的节点的变量,因为它们是同时运行的,不能访问其他并行节点的变量。 + +在并行分支完成后,下游节点可以访问所有并行输出的变量。 +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/build/predefined-error-handling-logic.mdx b/zh-hans/documzh-hanstation/pages/build/predefined-error-handling-logic.mdx new file mode 100644 index 00000000..554c2c25 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/build/predefined-error-handling-logic.mdx @@ -0,0 +1,88 @@ +``` +--- +title: "处理错误" +icon: "arrow-rotate-right" +--- + +![](https://assets-docs.dify.ai/2024/12/6e2655949889d4d162945d840d698649.png) +[大型语言模型](/en/guides/workflow/node/llm), [HTTP](/en/guides/workflow/node/http-request), [代码](/en/guides/workflow/node/code), 和 [工具](/en/guides/workflow/node/tools) 节点支持开箱即用的错误处理。当一个节点失败时,它可以采取以下三种行为之一: + + + + 默认行为。当一个节点失败时,整个工作流停止。您将获得原始错误信息。 + + 在以下情况下使用此选项: + - 您正在测试并希望查看哪个部分出错 + - 工作流无法在没有此步骤的情况下继续 + + + 当一个节点失败时,使用备份值代替。工作流继续运行。 + + ![](https://assets-docs.dify.ai/2024/12/e9e5e757090679243e0c9976093c7e6c.png) + + **要求** + - 默认值必须与节点的输出类型匹配 —— 如果它输出一个字符串,您的默认值也必须是一个字符串。 + + **示例** + + 您的LLM节点通常返回分析结果,但有时由于速率限制而失败。设置一个默认值,例如: + + ``` + "抱歉,我暂时不可用。请稍后再试。" + ``` + + 现在,用户将收到一条帮助信息,而不是一个中断的工作流。 + + + 当一个节点失败时,触发一个单独的流程来处理错误。 + + ![](https://assets-docs.dify.ai/2024/12/e5ea1af947818bd9e27cab3042c1c4f3.png) + + 失败分支用橙色高亮显示。您可以: + - 发送错误通知 + - 尝试不同的方法 + - 记录错误以进行调试 + - 使用备份服务 + **示例** + + 您的主要API失败,因此失败分支调用备份API。用户永远不会知道有问题存在。 + + + +## 循环/迭代节点中的错误 + +当子节点在循环和迭代中失败时,这些控制流节点有自己的错误行为。 + +**循环节点**总是在任何子节点失败时立即停止。整个循环终止并返回错误,防止运行任何进一步的迭代。 + +**迭代节点**允许您通过错误处理模式设置选择如何处理子节点失败: + +- `terminated` - 当任何项目失败时立即停止处理(默认) +- `continue-on-error` - 跳过失败的项目并继续下一个 +- `remove-abnormal-output` - 继续处理但从最终输出中过滤掉失败的项目 + +当您将迭代设置为`continue-on-error`时,失败的项目在输出数组中返回`null`。当您使用`remove-abnormal-output`时,输出数组仅包含成功的结果,使其比输入数组更短。 + +## 错误变量 + +使用默认值或失败分支时,您将获得两个特殊变量: + +- `error_type` - 发生了什么类型的错误(参见[错误类型](en/guides/workflow/error-handling/error-type)) +- `error_message` - 实际的错误详情 + +使用这些变量来: +- 向用户显示有帮助的信息 +- 向您的团队发送警报 +- 选择不同的恢复策略 +- 记录错误以进行调试 + +**示例** + +``` +{% if error_type == "rate_limit" %} +请求过多。请稍等片刻再试。 +{% else %} +出现问题。我们的团队已收到通知。 +{% endif %} +``` +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/build/shortcut-key.mdx b/zh-hans/documzh-hanstation/pages/build/shortcut-key.mdx new file mode 100644 index 00000000..22d7bda0 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/build/shortcut-key.mdx @@ -0,0 +1,150 @@ +```mdx +--- +title: "快捷键" +icon: "keyboard" +--- + +使用键盘快捷键加速您的工作流构建。 + +## 节点操作 +在画布上选择任意节点时: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
WindowsmacOS操作
Ctrl + CCmd + C复制节点
Ctrl + VCmd + V粘贴节点
Ctrl + DCmd + D复制节点
DeleteDelete删除选择的节点
Ctrl + OCmd + O自动排列节点
ShiftShift可视化变量依赖关系(仅限单个节点)
+ +## 画布导航 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
WindowsmacOS操作
Ctrl + 1Cmd + 1适应视图
Ctrl + -Cmd + -缩小
Ctrl + =Cmd + =放大
Shift + 1Shift + 1重置为100%
Shift + 5Shift + 5设置为50%
HH手动工具(平移)
VV选择工具
+ +## 历史记录 + + + + + + + + + + + + + + + + + + + + + + + + + + +
WindowsmacOS操作
Ctrl + ZCmd + Z撤销
Ctrl + YCmd + Y重做
Ctrl + Shift + ZCmd + Shift + Z重做
+ +## 测试 + + + + + + + + + + + + + + + + +
WindowsmacOS操作
Alt + ROption + R运行工作流
+``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/build/version-control.mdx b/zh-hans/documzh-hanstation/pages/build/version-control.mdx new file mode 100644 index 00000000..fac82a64 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/build/version-control.mdx @@ -0,0 +1,103 @@ +```mdx +--- +title: "版本控制" +icon: "layer-group" +--- + +在对话流和工作流应用中跟踪更改和管理版本。 + + + 目前仅适用于对话流和工作流应用。 + + +## 工作原理 + +**当前草稿**:您的工作版本。这是您进行更改的地方。用户不可见。 + +![](https://assets-docs.dify.ai/2025/03/38296a597c0ca31b5fb70be2234f2363.png) + +**最新版本**:用户可见的实时版本。 + +![](https://assets-docs.dify.ai/2025/03/e4c06a0817c30cf9e8893487c889cb02.png) + +**以前版本**:已发布的旧版本。 + +![](https://assets-docs.dify.ai/2025/03/4cd05033b93d84b53496f3d02e88601f.png) + +## 发布版本 + +点击 **发布** → **发布更新** 以使您的草稿上线。 + +![](https://assets-docs.dify.ai/2025/03/26f3f324ab4ecb965708d553ddd78d97.png) + +您的草稿将成为新的最新版本,并且您将获得一个新的草稿来进行工作。 + +![](https://assets-docs.dify.ai/2025/03/67e95de17577bc272addad6c33f8ea59.png) + +## 查看版本 + +点击历史图标查看所有版本: + +![](https://assets-docs.dify.ai/2025/03/eed667bbc9498425342c09039054cf98.png) + +过滤条件: +- **所有版本**或**仅您的版本** +- **仅命名版本**(跳过自动生成的名称) + +![](https://assets-docs.dify.ai/2025/03/0bf8fef8858671a8fef160f49dd83dad.jpg) + +## 管理版本 + +**命名版本**:给它一个合适的名字,而不是自动生成的名字 + +![](https://assets-docs.dify.ai/2025/03/ac149f63da6611d7080d305dd3fad65c.jpg) + +**编辑版本信息**:更改名称并添加发布说明 + +![](https://assets-docs.dify.ai/2025/03/1d840edf979132a9bbf1e065f95e663c.jpg) + +**删除旧版本**:清理不需要的版本 + +![](https://assets-docs.dify.ai/2025/03/25ad1999fc9f6f44fcac04526ac5563a.jpg) + + + 您无法删除当前草稿或最新版本。 + + +**恢复版本**:将旧版本加载回您的草稿 + +![](https://assets-docs.dify.ai/2025/03/c96b714accc29df8e46e711782a7a6a9.jpg) + + + 这将完全替换您当前的草稿。确保您没有未保存的工作。 + + +## 示例工作流 + +以下是版本在典型开发周期中的工作方式: + +### 1. 从草稿开始 +![](https://assets-docs.dify.ai/2025/03/35ece9d5d5d4d8c46a3fb5ceae4d0c15.jpeg) + +### 2. 发布第一个版本 +![](https://assets-docs.dify.ai/2025/03/3d1f66cdeb08710f01462a6b0f3ed0a8.jpeg) + +### 3. 发布第二个版本 +![](https://assets-docs.dify.ai/2025/03/92ffbf88a3cbeeeeab47c1bd8b4f7198.jpeg) + +### 4. 将旧版本恢复为草稿 +![](https://assets-docs.dify.ai/2025/03/541f1891416af90dab5b51bfec833249.jpeg) + +### 5. 发布恢复的版本 +![](https://assets-docs.dify.ai/2025/03/3572a4f2edef166c3f14e4ec4e68b297.jpeg) + +完整演示: +![](https://assets-docs.dify.ai/2025/03/dc7c15a4dfafb72ce7fffea294d5b5e5.gif) + +## 提示 + +- 在发布前始终在草稿中测试 +- 对重要发布使用描述性版本名称 +- 需要快速回滚时恢复版本 +- 保留旧版本以供参考 +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/debug/error-type.mdx b/zh-hans/documzh-hanstation/pages/debug/error-type.mdx new file mode 100644 index 00000000..c98519cd --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/debug/error-type.mdx @@ -0,0 +1,108 @@ +```mdx +--- +title: 错误类型 +icon: "circle-xmark" +--- + +每种节点类型都会抛出特定的错误类,帮助您了解问题所在及如何解决。 + +## 节点特定错误 + + + + +`CodeNodeError` +您的 Python 或 JavaScript 代码在执行期间抛出了异常 + +![代码错误](https://assets-docs.dify.ai/2024/12/c86b11af7f92368180ea1bac38d77083.png) + +`OutputValidationError` +您的代码返回的数据类型与您配置的输出变量类型不匹配 + +`DepthLimitError` +您的代码创建了超过 5 层深的嵌套数据结构 + +`CodeExecutionError` +沙箱服务无法执行您的代码 - 通常意味着服务已宕机 + +![](https://assets-docs.dify.ai/2024/12/ab8cae01a590b037017dfe9ea4dbbb8b.png) + + + + +`VariableNotFoundError` +您的提示词模板引用了工作流上下文中不存在的变量 + +![](https://assets-docs.dify.ai/2024/12/f20c5fbde345144de6183374ab277662.png) + +`InvalidContextStructureError` +您向上下文字段传递了数组或对象,而该字段仅接受字符串 + +`NoPromptFoundError` +提示词字段完全为空 + +`ModelNotExistError` +在 LLM 节点配置中没有选择模型 + +`LLMModeRequiredError` +所选模型未配置有效的 API 凭据 + +`InvalidVariableTypeError` +您的提示词模板不是有效的 Jinja2 语法或纯文本格式 + +![](https://assets-docs.dify.ai/2024/12/9882f7a5ee544508ba11b51fb469a911.png) + + + + +`AuthorizationConfigError` +API 端点的身份验证配置缺失或无效 + +`InvalidHttpMethodError` +HTTP 方法必须是 GET、HEAD、POST、PUT、PATCH 或 DELETE + +`ResponseSizeError` +API 响应超过 10MB 大小限制 + +`FileFetchError` +无法检索请求中引用的文件变量 + +`InvalidURLError` +URL 格式错误或无法访问 + + + + +`ToolParameterError` +传递给工具的参数与其预期的模式不匹配 + +`ToolFileError` +工具无法访问所需的文件 + +`ToolInvokeError` +外部工具 API 在执行期间返回了错误 + +

+ +

+ +`ToolProviderNotFoundError` +工具提供者未安装或配置不正确 + +
+
+ +## 系统级错误 + +`InvokeConnectionError` +与外部服务的网络连接失败 + +`InvokeServerUnavailableError` +外部服务返回了 503 状态或暂时宕机 + +`InvokeRateLimitError` +您已达到 API 或模型提供者的速率限制 + +`QuotaExceededError` +您已超出此服务的使用配额 +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/debug/history-and-logs.mdx b/zh-hans/documzh-hanstation/pages/debug/history-and-logs.mdx new file mode 100644 index 00000000..7d880711 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/debug/history-and-logs.mdx @@ -0,0 +1,46 @@ +```mdx +--- +title: "日志" +icon: "memo" +--- + +Dify 记录了每次工作流运行时的详细日志。您可以看到应用程序级别和各个节点发生了什么。 + + +有关发布后来自实时用户的日志,请参见[日志与注释](/en/guides/annotation/logs)。 + + +## 应用程序日志 + +每次工作流运行都会创建一个完整的日志条目。点击任意条目查看三个部分: + +![](https://assets-docs.dify.ai/2025/04/08a885858cfa6e8863faac891a5be319.png) + +### 结果 + +显示用户看到的最终输出。如果工作流失败,您将在此处看到错误信息。 + +![](https://assets-docs.dify.ai/2025/06/22856751d278ffad99d0533d2d96e125.png) + + +仅适用于工作流应用程序。 + + +### 详情 + +显示执行的原始输入、最终输出和系统元数据。 + +![](https://assets-docs.dify.ai/2025/06/882b783cd843ab666f5bc3c06f78521d.png) + +### 跟踪 + +准确显示您的工作流如何执行,包括哪些节点按什么顺序运行,每个节点花费的时间,以及数据在它们之间的流动情况。这对于查找瓶颈和理解具有分支或循环的复杂工作流非常有用。 + +![](https://assets-docs.dify.ai/2025/06/9e614ac01b1f6e0aeadda78c91ce93b7.png) + +## 节点日志 + +您还可以检查任何单个节点的最后一次执行。点击节点配置面板中的“最后运行”查看其最近的输入、输出和时间详情。 + +![](https://assets-docs.dify.ai/2025/06/9c6e57236d85f426a930424863042d7d.png) +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/debug/step-run.mdx b/zh-hans/documzh-hanstation/pages/debug/step-run.mdx new file mode 100644 index 00000000..bd9f3dd8 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/debug/step-run.mdx @@ -0,0 +1,34 @@ +```mdx +--- +title: "单节点" +icon: "code-commit" +--- + +在发布之前,通过逐步运行您的工作流或测试单个节点来捕捉问题。 + +## 单节点测试 + +您可以在不运行整个工作流的情况下单独测试任何节点。选择节点,在其设置面板中提供测试输入,然后点击“运行”以查看输出。 + +![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png) + +测试后,点击“上次运行”查看执行详情,包括输入、输出、时间和任何错误信息。 + + +Answer 和 End 节点不支持单节点测试。 + + +## 逐步执行 + +当您一次运行一个节点时,其输出会缓存到变量检查器中。您可以编辑这些缓存的变量,以不同的场景进行测试,而无需重新运行上游节点。 + +![](https://assets-docs.dify.ai/2025/06/f8656d8deeeaefeab0a8d9169f0ed2d3.png) + +当您想测试一个节点对不同数据的响应时,这非常有用,而无需修改并重新运行之前的所有节点。只需在检查器中更改变量值,然后再次运行该节点。 + +## 查看执行历史 + +每次节点执行都会创建一个记录。点击任何节点上的“上次运行”以查看其最近的执行详情,包括输入了哪些数据,输出了什么,以及所用时间。 + +![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png) +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/debug/variable-inspect.mdx b/zh-hans/documzh-hanstation/pages/debug/variable-inspect.mdx new file mode 100644 index 00000000..d0b2b6bb --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/debug/variable-inspect.mdx @@ -0,0 +1,32 @@ +--- +title: "工作流" +icon: "arrow-progress" +--- + +变量检查器显示流经工作流的所有数据。它会在每个节点运行后捕获输入和输出,这样你就能了解正在发生的情况并测试不同的场景。 + +![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png) + +## 查看变量 + +任何节点运行后,其输出变量都会出现在屏幕底部的检查器面板中。点击任何变量可以查看其完整内容。 + +![](https://assets-docs.dify.ai/2025/06/94a4741c25204db5fd1281ec475093d9.png) + +## 编辑变量 + +你可以通过点击来编辑大多数变量值。当你运行下游节点时,它们将使用你编辑的值而不是原始值。这让你能够测试不同场景而无需重新运行整个工作流。 + + +在此处编辑变量不会更改最初创建这些变量的节点的"最后运行"记录。 + + +例如,如果一个大型语言模型节点生成了类似 `SELECT * FROM users` 的 SQL,你可以在检查器中将其编辑为 `SELECT username FROM users`,然后只重新运行数据库节点来查看不同的结果。 + +![](https://assets-docs.dify.ai/2025/06/fb8c49fc0c8c63866f1a9379e8752d9e.png) + +## 重置变量 + +点击任何变量旁边的还原图标来恢复其原始值,或者点击"全部重置"来一次性清除所有缓存的变量。 + +![](https://assets-docs.dify.ai/2025/06/b713290543a0feb95ecab65336e97483.png) \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/getting-started/faq.md b/zh-hans/documzh-hanstation/pages/getting-started/faq.md new file mode 100644 index 00000000..2b852810 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/getting-started/faq.md @@ -0,0 +1,114 @@ +```mdx +# 常见问题解答 + +欢迎来到 Dify 的常见问题解答部分。在这里,您将找到关于使用 Dify 的最常见问题的答案。 + +## 入门 + +### 什么是 Dify? + +Dify 是一个用于构建 AI 应用的开源平台。它提供了一整套工具和功能,帮助您在无需广泛编程知识的情况下构建、部署和管理 AI 应用。 + +### 如何开始使用 Dify? + +要开始使用 Dify: + +1. **注册** 在 [dify.ai](https://dify.ai) 创建一个 Dify 账户 +2. 使用我们直观的界面 **创建您的第一个应用程序** +3. **配置您的 AI 模型**,通过连接 OpenAI、Anthropic 或其他供应商 +4. **测试并迭代** 您的应用程序 +5. **部署** 您的 AI 应用程序到生产环境 + +### 我可以用 Dify 构建哪些类型的应用程序? + +您可以使用 Dify 构建各种类型的 AI 应用程序: + +- 用于客户服务的 **聊天机器人** +- 可以回答文档问题的 **知识库助手** +- 智能处理数据的 **工作流自动化工具** +- 用于营销和写作的 **内容生成工具** +- 能执行复杂任务的 **智能代理** + +## 技术问题 + +### Dify 支持哪些 AI 模型? + +Dify 支持多种 AI 模型,包括: + +- **OpenAI 模型**:GPT-4、GPT-3.5 等 +- **Anthropic 模型**:Claude 3 和 Claude 2 +- **开源模型**:通过 Hugging Face、Ollama 等提供商 +- **本地模型**:您可以托管自己的模型 + +### Dify 如何处理我的数据? + +数据安全和隐私是我们的首要任务: + +- **您的数据仍然是您的** - 我们不会在您的私人数据上进行训练 +- **传输和静态加密** +- **企业客户的 SOC2 合规性** +- **欧洲用户的 GDPR 合规性** + +### 我可以将 Dify 用于商业用途吗? + +可以!Dify 提供: + +- **开源版本**,使用 Apache 2.0 许可证进行自托管 +- **云版本**,提供商业计划用于托管 +- **企业计划**,提供高级功能和支持 + +## 故障排除 + +### 我的 AI 应用程序产生了错误的响应 + +尝试以下故障排除步骤: + +1. **检查您的提示词** - 确保其清晰且具体 +2. **检查您的知识库** - 确保上传了相关文档 +3. **调整模型参数** - 尝试不同的温度或 TopK 设置 +4. **尝试不同的模型** - 一些模型在特定任务上表现更好 + +### 我遇到响应时间较慢的问题 + +要改善响应时间: + +1. **检查您的模型配置** - 有些模型比其他模型更快 +2. **优化您的知识库** - 删除不必要的文档 +3. **使用缓存** - 为常见问题启用响应缓存 +4. **考虑升级** 您的计划以提高性能 + +### 我如何获得支持? + +您可以通过以下方式获得支持: + +- **社区论坛** - 与其他 Dify 用户交流 +- **文档** - 全面的指南和教程 +- **GitHub 问题** - 用于错误报告和功能请求 +- **电子邮件支持** - 针对付费计划客户 +- **企业支持** - 为企业客户提供专属支持 + +## 计费和计划 + +### 不同的定价计划有哪些? + +Dify 提供多个计划: + +- **免费层** - 适合入门和小型项目 +- **专业计划** - 适用于有较高使用需求的成长型企业 +- **企业计划** - 为大型组织提供定制解决方案 + +### 如何计算使用量? + +使用量通常基于以下几点计算: + +- 对 AI 模型的 **API 调用** +- 文档和数据的 **存储** +- 应用程序上的 **活跃用户** +- 取决于您的计划的 **定制功能** + +有关详细的定价信息,请访问我们的 [定价页面](https://dify.ai/pricing)。 + +--- + +需要更多帮助?请联系我们的支持团队或查看我们的 [全面文档](../../../guides/)。 +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/getting-started/faq.mdx b/zh-hans/documzh-hanstation/pages/getting-started/faq.mdx new file mode 100644 index 00000000..31ac8715 --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/getting-started/faq.mdx @@ -0,0 +1,128 @@ +```mdx +--- +title: "常见问题解答" +description: "关于使用 Dify 的常见问题和答案" +icon: "circle-question" +--- + +欢迎来到 Dify 常见问题解答部分。在这里,您会找到关于如何使用 Dify 的一些常见问题的答案。 + +## 入门 + + + + Dify 是一个用于构建 AI 应用程序的开源平台。它提供了一整套工具和功能,帮助您在不需要广泛编码知识的情况下,构建、部署和管理您的 AI 应用程序。 + + + + 要开始使用 Dify: + + 1. **注册** 一个 Dify 账户,访问 [dify.ai](https://dify.ai) + 2. 使用我们的直观界面 **创建您的第一个应用程序** + 3. **配置您的 AI 模型**,通过连接 OpenAI、Anthropic 或其他提供商 + 4. **测试和迭代** 您的应用程序 + 5. **部署** 您的 AI 应用程序到生产环境 + + + + 您可以使用 Dify 构建各种类型的 AI 应用程序: + + - 用于客户服务的 **聊天机器人** + - 能够回答有关您文档问题的 **知识库助手** + - 智能处理数据的 **工作流自动化工具** + - 用于营销和写作的 **内容生成工具** + - 能够执行复杂任务的 **智能代理** + + + +## 技术问题 + + + + Dify 支持多种 AI 模型,包括: + + - **OpenAI 模型**:GPT-4、GPT-3.5 等 + - **Anthropic 模型**:Claude 3 和 Claude 2 + - **开源模型**:通过 Hugging Face、Ollama 等提供商 + - **本地模型**:您可以托管自己的模型 + + + + 数据安全和隐私是我们的首要任务: + + - **您的数据仍然属于您** - 我们不会使用您的私人数据进行训练 + - **传输和存储加密** + - **企业客户的 SOC2 合规性** + - **欧洲用户的 GDPR 合规性** + + + + 可以!Dify 提供以下版本: + + - 适用于自托管的 Apache 2.0 许可证的 **开源版本** + - 适用于托管服务的商业计划的 **云版本** + - 提供高级功能和支持的 **企业计划** + + + +## 疑难解答 + + + + 尝试以下故障排除步骤: + + 1. **检查您的提示词** - 确保其清晰且具体 + 2. **检查您的知识库** - 确保上传了相关文档 + 3. **调整模型参数** - 尝试不同的温度或 TopK 设置 + 4. **使用不同的模型进行测试** - 某些模型在特定任务上表现更好 + + + + 要提高响应时间: + + 1. **检查您的模型配置** - 某些模型速度更快 + 2. **优化您的知识库** - 删除不必要的文档 + 3. **使用缓存** - 启用常见问题的响应缓存 + 4. **考虑升级** 您的计划以获得更好的性能 + + + + 您可以通过以下方式获得支持: + + - **社区论坛** - 与其他 Dify 用户交流 + - **文档** - 全面的指南和教程 + - **GitHub 问题** - 用于错误报告和功能请求 + - **电子邮件支持** - 针对付费计划客户 + - **企业支持** - 为企业客户提供专门支持 + + + +## 计费和计划 + + + + Dify 提供多种计划: + + - **免费层** - 适合入门和小型项目 + - **专业计划** - 适用于有更高使用需求的成长型企业 + - **企业计划** - 针对大型组织的定制解决方案 + + + + 使用量通常基于以下因素计算: + + - 对 AI 模型的 **API 调用** + - **文档和数据的存储** + - 您应用程序的 **活跃用户** + - **自定义功能** 视您的计划而定 + + 有关详细的定价信息,请访问我们的 [定价页面](https://dify.ai/pricing)。 + + + +--- + + + 需要更多帮助?请联系支持团队或查看我们的 [全面文档](../../../guides/)。 + +``` \ No newline at end of file diff --git a/zh-hans/documzh-hanstation/pages/getting-started/quick-start.mdx b/zh-hans/documzh-hanstation/pages/getting-started/quick-start.mdx new file mode 100644 index 00000000..4c8d49ac --- /dev/null +++ b/zh-hans/documzh-hanstation/pages/getting-started/quick-start.mdx @@ -0,0 +1,165 @@ +```mdx +--- +title: "10分钟快速入门" +description: "通过一个简单的应用程序快速进入Dify" +icon: "forward" +--- + +Dify的真正价值在于,无论想法多么复杂,都能轻松地构建、部署和扩展。它为快速原型设计、流畅迭代和任何级别的可靠部署而构建。 + +让我们开始学习如何将可靠的大型语言模型(LLM)集成到您的应用程序中。在本指南中,您将构建一个简单的聊天机器人,该机器人可以分类用户的问题,直接使用大型语言模型响应,并通过国家特定的趣味事实增强响应。 + +