> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-docs-new-agent-experience.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 第 3 课：工作流的大脑（LLM 节点）

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/learn/tutorials/workflow-101/lesson-03)。

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/llm-node.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=37af9e1748825383d9555f0f579aabba" alt="LLM 节点" width="284" height="154" data-path="images/use-dify/tutorial/workflow-101-lesson-03/llm-node.png" />
</Frame>

目标：为邮件助理装上大脑，掌握 AI 节点（LLM）的用法，并学会如何测试与调试工作流。

如果说开始节点是准备材料，结束节点是出菜，那么大型语言模型（LLM）节点就是负责烹饪的主厨。它是工作流的大脑和核心，负责执行所有思考、分析、创作等智能任务。你想让 AI 总结文章、写代码、回答问题或是创作文案，都是通过这个节点来完成的。

## 配置大型语言模型

我们需要在 LLM 节点选择使用大型语言模型，让我们来快速配置一下。

<Steps>
  <Step title="打开集成">
    前往 **集成** > **模型供应商**。

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/llm-node-01.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=95f1f62206ccb71d100edb87034bfe98" alt="模型供应商" width="421" height="179" data-path="images/use-dify/tutorial/workflow-101-lesson-03/llm-node-01.png" />
    </Frame>
  </Step>

  <Step title="安装 OpenAI 模型供应商">
    在安装模型供应商里选择 OpenAI，点击 **安装**。

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/llm-node-02.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=9b80e2eb4e60ccb9f6b33db996a929b0" alt="选择 OpenAI" width="1034" height="506" data-path="images/use-dify/tutorial/workflow-101-lesson-03/llm-node-02.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/install.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=3868bb29e1b30579ece79b6ac641b7fb" alt="安装 OpenAI" width="1028" height="785" data-path="images/use-dify/tutorial/workflow-101-lesson-03/install.png" />
    </Frame>
  </Step>

  <Step title="返回编排窗口">
    安装成功，你会在模型列表中看到名为 OpenAI 的大型语言模型。点击右上角 **ESC**，回到编排窗口。
  </Step>
</Steps>

## 看懂大语言模型的能力标签

正如每位主厨都有自己的拿手菜系，不同的大语言模型也有自己擅长的领域。在 Dify 里选择模型时，你会看到它们身上挂着一些标签，这些标签就是为了告诉我们它擅长什么。

<AccordionGroup>
  <Accordion title="CHAT（聊天）">
    拥有这个标签的模型，擅长对话、写文章、做总结。我们今天的邮件助理工作流就需要带有这个标签的大型语言模型。
  </Accordion>

  <Accordion title="1048K（记忆力）">
    这个数字代表模型的上下文窗口，可以理解为它的 **短期记忆有多强**。

    K 代表千，1048K 就意味着它能一次性处理大约一百万个词（Token）的超长信息，比如读完一本很厚的书，还能记住开头的情节。

    <Info>
      包含这个标签的大型语言模型，对于处理长文档、长对话非常有帮助。
    </Info>
  </Accordion>

  <Accordion title="多模态能力 (Multi-modal)">
    模态指的是信息的类型。多模态就是指模型能处理多种类型的信息，而不仅仅是文字。

    **VISION（看图识字）**

    带有这个标签的模型，不仅能理解文字，还能看见图片！你可以给它发送一张图，然后问它图里包含什么？

    **AUDIO（声音辨识）**

    带有这个标签的模型，可以听懂音频文件。你可以给它一段录音，让它转写成文字或者总结内容。

    **VIDEO（视频分析）**

    该模型能理解视频内容。

    **DOCUMENT（文档阅读）**

    该模型可以直接阅读和理解你上传的文档，比如 PDF 或者 Word 文件，然后回答相关问题。
  </Accordion>
</AccordionGroup>

了解这些标签，能帮助你在未来为不同的任务，挑选最合适的主厨。对于我们今天的邮件助理，选择一个基础的 **CHAT** 模型就足够了。

## 动手实践 1：添加 LLM 节点

<Steps>
  <Step title="打开你的应用">
    打开刚刚第二课创建的邮件助理工作流。
  </Step>

  <Step title="添加节点">
    在开始和结束节点中的空白处，点击右键选择添加节点 - LLM 节点。选中 LLM 节点，在右侧面板的模型内，选择模型 **gpt-4o-mini**。

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/add-the-node.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=6610c7662e783ee222876f2ab862921b" alt="添加节点" width="781" height="398" data-path="images/use-dify/tutorial/workflow-101-lesson-03/add-the-node.png" />
    </Frame>
  </Step>

  <Step title="连接节点">
    点击 LLM 节点两侧的加号，分别连接开始和结束节点。

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/connect-the-nodes.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=7ede07a289d19802f6dd76f708eb1252" alt="连接节点" width="941" height="186" data-path="images/use-dify/tutorial/workflow-101-lesson-03/connect-the-nodes.png" />
    </Frame>
  </Step>
</Steps>

接下来，我们需要告诉大型语言模型需要做什么。点击 LLM 节点，在右侧的面板中，找到 System 输入框。在这里，你可以给 AI 输入具体的任务指令（Prompt）。

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/prompt.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=a0a9c8123539e15f88ccdac056e77a6f" alt="添加提示词" width="707" height="452" data-path="images/use-dify/tutorial/workflow-101-lesson-03/prompt.png" />
</Frame>

### 核心概念：提示词 (Prompt)

你可以理解为给 AI 下达的具体任务指令，你告诉 AI 做什么以及怎么做。

最关键的是，你可以在 Prompt 中，使用来自开始节点的变量。这样，AI 就能根据你每次提供的不同材料而变化。在 Dify 中，你只需要用变量名称这样的格式（我们在第一课动手实践开始节点里的：`customer_name` 和 `email_content`），就可以把变量嵌入到你的指令中。

## 动手实践 2：编写 Prompt

现在，我们将一起编写提示词，同时把变量融入其中。

<Steps>
  <Step title="编写指令">
    回到刚才的邮件助理工作流，我们将在 LLM 节点中的 System 输入框内输入 Prompt，让我们用简洁明确的方式写出指令。

    ```plaintext wrap theme={null}
    You are a professional customer service manager. Based on the customer's email, please draft a professional reply.
    Requirements:
    1. Start by addressing the customer name with a friendly tone.
    2. Thank them for their email.
    3. Let them know we have received it.
    4. Sign off as Anne.
    ```
  </Step>

  <Step title="添加用户消息（User Message）">
    用户消息是你发送给模型的内容：可以是提问、请求或模型需要完成的任务。在此工作流中，客户姓名和邮件内容每次都会发生变化。与其手动输入，我们不如在用户消息中添加 **变量（Variables）**。

    1. 点击系统框下方的 **Add Message（添加消息）** 按钮。
    2. 在用户消息框中，输入 `customer name:`。
    3. 按下键盘上的 `/` 键。
    4. 此时会弹出变量选择菜单，点击 **customer\_name**。
    5. 按下 **Enter** 键开始新的一行，输入 `email content:`。
    6. 再次按下 `/` 键并点击 **email\_content**。

           <Frame>
             <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/add-user-message.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=4d533904bc9645035e1b6bfb100dc2fa" alt="添加用户消息" width="1042" height="210" data-path="images/use-dify/tutorial/workflow-101-lesson-03/add-user-message.png" />
           </Frame>

    <Tip>
      想插入变量的时候，只要按下键盘上的 `/`，在弹出的菜单里选中你需要的变量，就能轻松搞定。
    </Tip>

    4. 最终的 Prompt 如下图所示。

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/final-prompt.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=3f1ca0553064961f3d22b9db803df278" alt="提示词预览" width="1044" height="630" data-path="images/use-dify/tutorial/workflow-101-lesson-03/final-prompt.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  至此，你已经完成了首个工作流的完整编排。
</Check>

## 运行与调试

材料备好了，主厨也到位了，指令也写好了，那么工作流的出品如何呢？在正式出菜之前，让我们先试个菜。

测试是确保工作流稳定运行的关键一步，它能帮助我们提前发现并解决潜在的问题。

### 小科普：检查清单（Checklist）

检查清单就像你的私人体检医生，它会实时扫描你的工作流，自动找出配置不完整或者明显的错误（比如有节点没有连接好）。

在点击运行前先看一眼这里，能帮你提前了解工作流哪里有不完整的地方。

### 动手实践 3：测试与调试

<Steps>
  <Step title="提前检查">
    看看画布右上角，那个检查清单图标是不是出现了数字 1？这意味着，你还有一个地方没有处理好。

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/checklist.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=d14dcf2cb149a7d75549293c8905e919" alt="检查清单" width="671" height="238" data-path="images/use-dify/tutorial/workflow-101-lesson-03/checklist.png" />
    </Frame>
  </Step>

  <Step title="分析警告">
    点击它，你会看到一个警告：**输出变量不能为空**。这意味着输出变量没有收到任何内容。

    想象一下：主厨（LLM 节点）已经把菜做好了，但是服务员（输出节点）没有拿到菜，也根本不知道该把菜端给你。
  </Step>

  <Step title="解决问题">
    1. 点击输出节点。
    2. 在右侧面板的输入变量旁，点击加号（+）。
    3. 在左侧变量名中，填入 `email_reply`。
    4. 在右侧选择框，选择 LLM 节点下的 `{x} text`。

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/fix-the-issue.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=68c8f614b16456c84938a73030391535" alt="解决问题" width="1352" height="417" data-path="images/use-dify/tutorial/workflow-101-lesson-03/fix-the-issue.png" />
    </Frame>
  </Step>

  <Step title="测试运行">
    完成后，你会发现检查清单上的数字消失了，让我们来进行测试运行。点击画布右上角的 **运行**，输入客户名字和客户邮件原文，点击 **开始运行**。

    <Frame>
      <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/test-run.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=3dc4173292d272d691176c818a779ad3" alt="测试运行" width="1322" height="406" data-path="images/use-dify/tutorial/workflow-101-lesson-03/test-run.png" />
    </Frame>

    <CodeGroup>
      ```text 邮件测试示例 theme={null}
      客户名字：Amanda

      客户邮件原文：
      Hi there,

      I'm writing to ask for more information about Dify. Could you please tell me more on it?

      Best regards,
      Amanda
      ```
    </CodeGroup>
  </Step>

  <Step title="运行成功！">
    你会发现，每个节点都运行成功（右侧有绿色的打勾符号），右侧详情处的状态为 SUCCESS。
  </Step>
</Steps>

<Check>
  恭喜你！你不仅完成了第一个工作流的搭建，并掌握了基础的测试和调试工作流的技巧。
</Check>

## 小挑战

使用工作流，继续完成旅游攻略生成器的搭建。

<Tip>
  探索 Dify 的 **提示词生成器**。

  <Frame>
    <img src="https://mintcdn.com/dify-6c0370d8-docs-new-agent-experience/m7n3yF17cj5TGqhL/images/use-dify/tutorial/workflow-101-lesson-03/prompt-generator.png?fit=max&auto=format&n=m7n3yF17cj5TGqhL&q=85&s=1cf112aa284b17a0a9abf01afa27212e" alt="提示词生成器" width="399" height="119" data-path="images/use-dify/tutorial/workflow-101-lesson-03/prompt-generator.png" />
  </Frame>
</Tip>
