diff --git a/zh/quick-start.mdx b/zh/quick-start.mdx index 118aac26e..6646cbf1e 100644 --- a/zh/quick-start.mdx +++ b/zh/quick-start.mdx @@ -6,14 +6,14 @@ description: "通过示例应用深入了解 Dify" > 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/quick-start)。 - 本快速入门使用 **Dify Cloud**，这是上手最快的方式：免费开始、自带 AI 额度、无需任何安装。想自行部署？你可以[自部署 Dify](/zh/self-host/deploy/quick-start/docker-compose)，然后在自己的实例上按相同步骤操作。 + 本快速入门使用 **Dify Cloud**，这是最快的上手方式：免费开始、自带 AI 额度、无需任何安装。想自行部署？你可以[自部署 Dify](/zh/self-host/deploy/quick-start/docker-compose)，然后在自己的实例上按相同步骤操作。 这个分步教程将带你从零开始创建一个多平台内容生成器。 -除了基本的 LLM 集成，你还将发现如何使用强大的 Dify 节点来更快、更轻松地编排复杂的 AI 应用。 +除了基本的 LLM 集成，你还将了解如何使用强大的 Dify 节点来更快、更轻松地编排复杂的 AI 应用。 -在本教程结束时，你将拥有一个工作流，它可以接受你提供的任何内容（文本、文档或图像），添加你偏好的语音和语调，并生成针对你选择语言的精美的、特定平台的社交媒体帖子。 +在本教程结束时，你将拥有一个工作流，它可以接受你提供的任何内容（文本、文档或图片），添加你偏好的语气与风格，并针对你选择的语言生成精美的、适用于特定平台的社交媒体帖子。 完整的工作流如下所示。在构建过程中，可以随时参考它以保持正轨，并了解所有节点如何协同工作。 @@ -45,7 +45,7 @@ description: "通过示例应用深入了解 Dify" - 1. 在 **模型供应商** 页面右上角，点击 **默认模型**。 + 1. 在 **模型供应商** 页面右上角，点击 **默认模型设置**。 2. 将 **系统推理模型** 设为 `gpt-5.2`，它将成为工作流中的默认模型。 @@ -54,7 +54,7 @@ description: "通过示例应用深入了解 Dify" ## 步骤 1：创建新工作流 -1. 前往 **工作室**，然后选择 **从空白创建** > **工作流**。 +1. 前往 **工作室**，然后选择 **创建空白应用** > **工作流**。 2. 将工作流命名为 `多平台内容生成器`，然后点击 **创建**。你将自动进入工作流画布开始构建。 @@ -73,51 +73,51 @@ description: "通过示例应用深入了解 Dify" ### 1. 收集用户输入：用户输入节点 - 首先，我们需要定义从用户那里收集什么信息来运行我们的内容生成器，例如草稿文本、目标平台、期望的语调以及任何参考材料。 + 首先，我们需要定义从用户处获取何种信息来运行我们的内容生成器，例如草稿文本、目标平台、期望的语调以及任何参考材料。 - 用户输入节点是我们可以轻松设置这些的地方。我们在这里添加的每个输入字段都会成为所有下游节点可以引用和使用的变量。 + 在用户输入节点，可以轻松完成这些设置。我们在这里添加的每个输入字段都会成为所有下游节点可以引用和使用的变量。 点击用户输入节点，打开其配置面板，然后添加以下输入字段。 - 字段类型：`段落` - - 变量名：`draft` - - 标签名：`草稿` + - 变量名称：`draft` + - 显示名称：`草稿` - 最大长度：`2048` - 必填：`是` - 字段类型：`文件列表` - - 变量名：`user_file` - - 标签名：`上传文件 (≤ 10)` - - 支持文件类型：`文档`、`图片` + - 变量名称：`user_file` + - 显示名称：`上传文件 (≤ 10)` + - 支持的文件类型：`文档`、`图片` - 上传文件类型：`两者` - - 最大上传数量：`10` + - 最大上传数：`10` - 必填：`否` - + - 字段类型：`段落` - - 变量名：`voice_and_tone` - - 标签名：`语音与语调` + - 变量名称：`voice_and_tone` + - 显示名称：`语气与风格` - 最大长度：`2048` - 必填：`否` - - 字段类型：`短文本` - - 变量名：`platform` - - 标签名：`目标平台 (≤ 10)` + - 字段类型：`文本` + - 变量名称：`platform` + - 显示名称：`目标平台 (≤ 10)` - 最大长度：`256` - 必填：`是` - - 字段类型：`选择` - - 变量名：`language` - - 标签名：`语言` + - 字段类型：`下拉选项` + - 变量名称：`language` + - 显示名称：`语言` - 选项： - `English` - `日本語` @@ -132,16 +132,16 @@ description: "通过示例应用深入了解 Dify" ### 2. 识别目标平台：参数提取器节点 - 由于我们的平台字段接受自由格式的文本输入，用户可能会以各种方式输入：`x 和 linkedIn`、`在 Twitter 和 LinkedIn 上发布`，甚至 `Twitter + LinkedIn please`。 + 由于我们的平台字段接受自由格式的文本输入，用户可能会以各种方式输入：`x 和 linkedIn`、`在 Twitter 和 LinkedIn 上发布`，甚至 `帮我发 Twitter + LinkedIn`。 - 然而，我们需要一个干净、结构化的列表，如 `["Twitter", "LinkedIn"]`，下游节点可以可靠地使用。 + 然而，我们需要一个干净、结构化的列表，如 `["Twitter", "LinkedIn"]`，以便于下游节点可靠地使用。 - 这正是参数提取器节点的完美工作。在我们的场景中，它使用 gpt-5.2 模型来分析用户的自然语言，识别所有这些变化，并输出标准化的数组。 + 这正是参数提取器节点的用武之地。在我们的场景中，它使用 gpt-5.2 模型来分析用户的自然语言，识别出各种不同的表述方式，并输出标准化的数组。 -在用户输入节点之后，添加一个参数提取器节点并配置它： +在用户输入节点之后，添加一个参数提取器节点并配置： -1. 在 **输入变量** 字段中，选择 `User Input/platform`。 +1. 在 **输入变量** 字段中，选择 `用户输入/platform`。 2. 添加一个提取参数： @@ -149,7 +149,7 @@ description: "通过示例应用深入了解 Dify" - 类型：`Array[String]` - - 描述：`The platform(s) for which the user wants to create tailored content.` + - 描述：`用户定制内容的目标平台。` - 必填：`是` @@ -185,61 +185,61 @@ description: "通过示例应用深入了解 Dify" ![参数提取器](/images/use-dify/get-started/deeper-dive-parameter-extractor.png) -### 3. 验证平台提取结果：IF/ELSE 节点 +### 3. 验证平台提取结果：条件分支节点 - 如果用户输入了无效的平台名称，比如 `ohhhhhh` 或 `BookFace` 怎么办？我们不想浪费时间和令牌生成无用的内容。 + 如果用户输入了无效的平台名称，比如 `ohhhhhh` 或 `BookFace` 怎么办？我们不想浪费时间和词元生成无用的内容。 - 在这种情况下，我们可以使用 IF/ELSE 节点创建一个分支，提前停止工作流。我们将设置一个条件来检查参数提取器节点的错误消息；如果检测到该消息，工作流将直接路由到输出节点并结束。 + 在这种情况下，可以使用条件分支节点创建一个分支，提前停止工作流。我们将设置一个条件来检查参数提取器节点的错误消息；如果检测到该消息，工作流将直接路由到输出节点并结束。 ![IF 分支](/images/use-dify/get-started/deeper-dive-if.png) -1. 在参数提取器节点之后，添加一个 IF/ELSE 节点。 +1. 在参数提取器节点之后，添加一个条件分支节点。 -2. 在 IF/ELSE 节点的面板上，定义 **IF** 条件： +2. 在条件分支节点的面板上，定义 **IF** 条件： - **IF** `Parameter Extractor/platform` **包含** `No platforms identified. Please enter a valid platform name.` + **IF** `参数提取器/platform` **包含** `No platforms identified. Please enter a valid platform name.` -3. 在 IF/ELSE 节点之后，向 IF 分支添加一个输出节点。 +3. 在条件分支节点之后，向 IF 分支添加一个输出节点。 -4. 在输出节点的面板上，将 `Parameter Extractor/platform` 设置为输出变量。 +4. 在输出节点的面板上，将 `参数提取器/platform` 设置为输出变量。 -### 4. 按类型分离上传的文件：列表操作器节点 +### 4. 按类型分离上传的文件：列表操作节点 - 我们的用户可以上传图像和文档作为参考材料，但这两种类型在使用 `gpt-5.2` 时需要不同的处理：图像可以通过其视觉能力直接解释，而文档必须先转换为文本，模型才能处理。 + 用户可以上传图片和文档作为参考材料，但这两种类型在使用 `gpt-5.2` 时需要不同的处理方式：图片可以通过其视觉能力直接解读，而文档必须先转换为文本，模型才能处理。 - 为了管理这一点，我们将使用两个列表操作器节点来过滤和将上传的文件分成单独的分支：一个用于图像，一个用于文档。 + 为此，我们将使用两个列表操作节点，将上传文件按类型分别过滤到图片和文档两个独立分支中。 - ![列表操作器](/images/use-dify/get-started/deeper-dive-list-operator.png) + ![列表操作](/images/use-dify/get-started/deeper-dive-list-operator.png) -1. 在 IF/ELSE 节点之后，向 ELSE 分支添加 **两个** 并行的列表操作器节点。 +1. 在条件分支节点之后，向 ELSE 分支添加 **两个** 并行的列表操作节点。 -2. 将一个节点重命名为 `图像`，另一个重命名为 `文档`。 +2. 将一个节点重命名为 `图片`，另一个重命名为 `文档`。 -3. 配置图像节点： - 1. 将 `User Input/user_file` 设置为输入变量。 +3. 配置图片节点： + 1. 将 `用户输入/user_file` 设置为输入变量。 - 2. 启用 **过滤条件**：`{x}type` **在** `Image`。 + 2. 启用 **过滤条件**：`{x}type` **在** `图片`。 4. 配置文档节点： - 1. 将 `User Input/user_file` 设置为输入变量。 + 1. 将 `用户输入/user_file` 设置为输入变量。 - 2. 启用 **过滤条件**：`{x}type` **在** `Doc`。 + 2. 启用 **过滤条件**：`{x}type` **在** `文档`。 ### 5. 从文档中提取文本：文档提取器节点 - `gpt-5.2` 不能直接读取像 PDF 或 DOCX 这样的上传文档，因此我们必须先将它们转换为纯文本。 + `gpt-5.2` 不能直接处理诸如 PDF 或 DOCX 这样的上传文档，必须先将它们转换为纯文本。 - 这正是文档提取器节点所做的。它将文档文件作为输入，并为下一步输出干净、可用的文本。 + 这正是文档提取器节点的工作。它接受文档文件作为输入，并输出干净可用的文本为后续步骤使用。 @@ -248,14 +248,14 @@ description: "通过示例应用深入了解 Dify" 1. 在文档节点之后，添加一个文档提取器节点。 -2. 在文档提取器节点的面板上，将 `Document/result` 设置为输入变量。 +2. 在文档提取器节点的面板上，将 `文档/result` 设置为输入变量。 ### 6. 整合所有参考材料：LLM 节点 - 当用户同时提供多种参考类型（草稿文本、文档和图像）时，我们需要将它们整合成一个连贯的摘要。 + 当用户同时提供多种类型的参考资料（草稿文本、文档和图片）时，我们需要将它们整合成一个连贯的摘要。 - LLM 节点将通过分析所有分散的片段来处理此任务，创建一个指导后续内容生成的综合上下文。 + LLM 节点将分析这些零散的内容，汇总生成一个用于指导后续内容生成的综合上下文。 @@ -264,13 +264,13 @@ description: "通过示例应用深入了解 Dify" 1. 在文档提取器节点之后，添加一个 LLM 节点。 -2. 将图像节点也连接到这个 LLM 节点。 +2. 将图片节点也连接到这个 LLM 节点。 3. 点击 LLM 节点进行配置： 1. 将其重命名为 `整合信息`。 - 2. 启用 **VISION** 并将 `Image/result` 设置为视觉变量。 + 2. 启用 **视觉** 并将 `图片/result` 设置为视觉变量。 3. 在系统指令字段中，粘贴以下内容： @@ -335,9 +335,9 @@ description: "通过示例应用深入了解 Dify" ### 7. 为每个平台创建定制内容：迭代节点 - 现在整合的参考和目标平台已准备就绪，让我们使用迭代节点为每个平台生成定制的帖子。 + 现在整合好的参考内容和目标平台都已准备就绪，接下来让我们使用迭代节点为每个平台生成定制的帖子。 - 该节点将遍历平台列表并为每个平台运行子工作流：首先分析特定平台的风格指南和最佳实践，然后基于所有可用信息生成优化的内容。 + 该节点将遍历平台列表，并为每个平台运行子工作流：先分析该平台的风格指南和最佳实践，再基于所有可用信息生成优化的内容。 @@ -346,7 +346,7 @@ description: "通过示例应用深入了解 Dify" 1. 在整合信息节点之后，添加一个迭代节点。 -2. 在迭代节点内部，添加一个 LLM 节点并配置它： +2. 在迭代节点内部，添加一个 LLM 节点并配置： 1. 将其重命名为 `识别风格`。 @@ -394,7 +394,7 @@ description: "通过示例应用深入了解 Dify" ```markdown USER Platform: Current Iteration/item ``` -3. 在识别风格节点之后，添加另一个 LLM 节点并配置它： +3. 在识别风格节点之后，添加另一个 LLM 节点并配置： 1. 将其重命名为 `创建内容`。 @@ -449,9 +449,9 @@ description: "通过示例应用深入了解 Dify" ![结构化输出](/images/use-dify/get-started/deeper-dive-structured-output.png) - 1. 在 **输出变量** 旁边，将 **结构化** 切换为开启。`structured_output` 变量将出现在下方。点击 **配置**。 + 1. 在 **输出变量** 旁，开启 **结构化输出**，将出现 `structured_output` 变量。点击 **配置**。 - 2. 在弹出的架构编辑器中，点击右上角的 **从 JSON 导入**，并粘贴以下内容： + 2. 在弹出的 schema 编辑器中，点击右上角的 **从 JSON 导入**，并粘贴以下内容： ```json { @@ -465,35 +465,35 @@ description: "通过示例应用深入了解 Dify" 4. 点击迭代节点进行配置： - 1. 将 `Parameter Extractor/platform` 设置为输入变量。 + 1. 将 `参数提取器/platform` 设置为输入变量。 - 2. 将 `Create Content/structured_output` 设置为输出变量。 + 2. 将 `创建内容/structured_output` 设置为输出变量。 3. 启用 **并行模式** 并将最大并行度设置为 `10`。 - 这就是为什么我们在用户输入节点的目标平台字段的标签名称中包含了 `(≤10)`。 + 这就是我们在用户输入节点的目标平台字段的显示名称中包含了 `(≤10)` 的原因。 ![迭代配置](/images/use-dify/get-started/deeper-dive-iteration-config.png) -### 8. 格式化最终输出：模板节点 +### 8. 格式化最终输出：模板转换节点 - 迭代节点为每个平台生成一个帖子，但其输出是原始数据数组（例如，`[{"platform_name": "Twitter", "post_content": "..."}]`），不太可读。我们需要以更清晰的格式呈现结果。 + 迭代节点为每个平台生成一个帖子，但其输出是原始数据数组（例如，`[{"platform_name": "Twitter", "post_content": "..."}]`），可读性较差。我们需要以更清晰的格式呈现结果。 - 这就是模板节点的用武之地，它允许我们使用 [Jinja2](https://jinja.palletsprojects.com/en/stable/) 模板将这些原始数据格式化为组织良好的文本，确保最终输出用户友好且易于阅读。 + 这时可以借助模板转换节点，它支持使用 [Jinja2](https://jinja.palletsprojects.com/en/stable/) 模板将这些原始数据格式化为结构清晰的文本，使得最终输出更加友好易读。 - ![模板节点](/images/use-dify/get-started/deeper-dive-template.png) + ![模板转换节点](/images/use-dify/get-started/deeper-dive-template.png) -1. 在迭代节点之后，添加一个模板节点。 +1. 在迭代节点之后，添加一个模板转换节点。 -2. 在模板节点的面板上，将 `Iteration/output` 设置为输入变量并命名为 `output`。 +2. 在模板转换节点的面板上，将 `迭代/output` 设置为输入变量并命名为 `output`。 3. 粘贴以下 Jinja2 代码： @@ -505,43 +505,43 @@ description: "通过示例应用深入了解 Dify" {% endfor %} ``` - - `{% for item in output %}` / `{% endfor %}`：遍历输入数组中的每个平台 - 内容对。 - - `{{ item.platform_name }}`：显示平台名称作为带有手机表情符号的 H1 标题。 + - `{% for item in output %}` / `{% endfor %}`：遍历输入数组中的每个“平台 - 内容”对。 + - `{{ item.platform_name }}`：显示带有手机表情符号的平台名称作为一级标题。 - `{{ item.post_content }}`：显示为该平台生成的内容。 - `{{ item.post_content }}` 和 `{% endfor %}` 之间的空行在最终输出中为各平台之间添加间距。 - 虽然 LLM 也可以处理输出格式化，但它们的输出可能不一致且不可预测。对于不需要推理的基于规则的格式化，模板节点以更稳定可靠的方式完成任务，且成本为零令牌。 + 虽然 LLM 也可以处理输出格式化，但它们的输出往往不一致且难以预测。对于不需要推理的、基于规则的格式化任务，模板转换节点能以更稳定可靠的方式完成，且不消耗任何词元。 - LLM 非常强大，但知道何时使用正确的工具是构建更可靠和经济高效的 AI 应用的关键。 + LLM 固然强大，但懂得在合适的场景选择合适的工具，才是构建更可靠、更具经济效益的 AI 应用的关键。 ### 9. 将结果返回给用户：输出节点 -1. 在模板节点之后，添加一个输出节点。 -2. 在输出节点的面板上，将 `Template/output` 设置为输出变量。 +1. 在模板转换节点之后，添加一个输出节点。 +2. 在输出节点的面板上，将 `模板转换/output` 设置为输出变量。 ## 步骤 3：测试 你的工作流现在已完成！让我们测试一下。 -1. 确保你的检查列表已清除。 +1. 确保你的检查清单为空。 - ![检查检查列表](/images/use-dify/get-started/deeper-dive-checklist-clear.png) + ![检查清单](/images/use-dify/get-started/deeper-dive-checklist-clear.png) 2. 对照开头提供的参考图检查你的工作流，确保所有节点和连接都匹配。 -3. 点击右上角的 **运行测试**，填写输入字段，然后点击 **开始运行**。 +3. 点击右上角的 **测试运行**，填写输入字段，然后点击 **开始运行**。 - 如果你不确定要输入什么，可以尝试以下示例输入： + 如果不确定要输入什么，可以尝试输入以下示例： - **草稿**：`We just launched a new AI writing assistant that helps teams create content 10x faster.` - **上传文件**：留空 - - **语音与语调**：`Friendly and enthusiastic, but professional` + - **语气与风格**：`Friendly and enthusiastic, but professional` - **目标平台**：`Twitter and LinkedIn` @@ -554,14 +554,14 @@ description: "通过示例应用深入了解 Dify" - 你的结果可能会因使用的模型不同而有所差异。能力更强的模型通常会产生更高质量的输出。 + 结果可能会因使用的模型不同而有所差异。能力更强的模型通常会产生更高质量的输出。 - 要测试节点对来自先前节点的不同输入的反应，你不需要重新运行整个工作流。只需点击画布底部的 **查看缓存变量**，从列表中找到要更改的变量，然后编辑其值。 + 要测试节点如何响应上游节点传来的不同输入，无需重新运行整个工作流。只需点击画布底部的 **查看缓存**，从列表中找到要更改的变量，然后编辑其值。 -如果遇到任何错误，请检查相应节点的 **最后运行** 日志以确定问题的确切原因。 +如果遇到任何错误，请检查相应节点的 **上次运行** 日志以确定问题的确切原因。 ## 步骤 4：发布和共享 @@ -569,4 +569,4 @@ description: "通过示例应用深入了解 Dify" 如果你稍后进行任何更改，请始终记住再次发布，以便更新生效。 - \ No newline at end of file +