# 搭建智能助教工作流操作流程 #### 前提条件 - 已[实名认证](https://support.huaweicloud.com/usermanual-account/account_auth_00001.html)的华为账号或IAM用户。 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。 #### 准备工作 - 本实践选用平台预置的"DeepSeek-V4-Flash"模型。 - 搭建助教工作流前须完成语文知识库创建，详见[创建语文知识库](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0003.html)。 #### 操作流程 | 操作步骤 | 说明 | |:---|:---| | [创建工作流] | 通过填写必要的工作流基本信息，创建一个对话型的智能助教工作流。 | | [编排工作流] | 配置生成问题节点、知识检索节点、判断节点、润色输出节点、AI输出节点、代码节点以及结束节点，以形成一个完整的工作流应用。 | | [调试工作流] | 输入信息并运行工作流，查看大模型的响应结果，优化配置，确保工作流的正确性和有效性。同时，可以查看详细的调试结果和调用详情。 | | [提交版本] | 调试成功后可提交版本，如果需要通过API调用，则需要将提交的版本部署至实例，具体操作请参考[发布并部署工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0053.html)。 | #### 创建工作流 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 单击左侧导航栏"开发中心 \> 智能体管理 "，单击左上角"工作流"页签，进入工作流应用管理界面，单击右上角"创建工作流"。 3. 选择创建"对话型工作流"，在对应的创建页面，配置工作流相关信息，具体如[图1]所示，参数如[表1]所示。 图1创建工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549015.png "点击放大") 表1参数说明 | 参数名称 | 示例 | 说明 | |:---|:---|:---| | 名称 | 智能助教 | 支持中英文、数字、下划线、中划线和空格，长度 2\~64字符，但不允许以空格开头或结尾。 | | 描述 | 本应用是一款基于人工智能技术，旨在减轻教师重复性工作负担、提供个性化教学支持、并提升学生学习效率的智能化辅助工具。 | 描述工作流的功能，可直观呈现给用户，长度0\~1024个字符。 | 4. 配置完成后单击"立即创建"，进入工作流编排页面。 #### 编排工作流 在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389203.png)"，可以对当前节点执行重命名、复制、删除操作。开始和结束节点为必选节点，不支持重命名、复制和删除。 图2工作流编排初始页面 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789872.png "点击放大") 1. 配置"开始"节点。单击"开始"节点，该节点已默认配置query参数，表示用户输入的内容。当前场景下无需新增参数。 图3配置开始节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717548983.png "点击放大") 2. 配置"大模型"节点，从用户输入中进行问题提取，解析出用户的问题，并用JSON格式输出。参考[图4]和[表2]完成参数配置。 图4配置"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789486.png "点击放大") 表2参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"生成问题"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 模型配置 | 选择模型为"DeepSeek-V4-Flash"，单击模型配置区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549073.png)"可设置模型的温度、核采样等参数，本实践保持默认值。 | 选择模型接入模块已配置的大语言模型。 | | 输入参数 | 定义以下输入参数。 - 参数名称为"query"。 - 类型、值：选择"引用\>query"。query为"开始节点"的输出变量值。 | 配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为"query"。 | | 输出参数 | 单击输出区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389141.png)"，选择输出格式为"JSON"。单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789558.png)，添加参数。 定义以下输出参数，其余保持默认值即可。 - question，类型为"String"，描述为"用户问题"。 - answer，类型为"String"，描述为"用户问题的回答"。 | 用于解析大模型节点的输出，并提供给后续节点的输出参数引用。 | | 系统提示词 | 输入如下系统提示词后单击"系统提示词"区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389133.png "点击放大")"，进行提示词优化。 ``` 你是问题解析专家，请从用户的对话中解析出用户的问题{question}和{answer}，用JSON格式输出。 注意，question一定有值，answer可能没值，如果answer没值，该字段输出空即可。 ``` | 配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | | 用户提示词 | {{query}} | 配置输入给大模型的提示词，用户级提示词，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | 3. 配置"知识检索"节点，从预先上传的语文知识库中检索用户的问题，并返回匹配到的信息。 1. 鼠标悬浮"生成问题"和"结束"节点中的连接线，单击"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789602.png)"，选择"知识检索"节点，添加至编排页面，如[图5]所示。 图5连接"大模型"节点（生成问题）和"知识检索"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549021.png "点击放大") 2. 单击"知识检索"节点，参考[图6]和[图7]完成参数配置。 - 输入参数 参数名称：默认参数名称为query。 类型、值：选择"引用\>question"。question为"生成问题-大模型节点"的输出变量值。 - 知识库可直接选择[创建语文知识库](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0003.html)章节创建的"语文知识库"。 图6配置"知识检索"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789534.png "点击放大") 图7设置知识库 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389185.png "点击放大") 4. 配置"判断"节点，判定是否从预置的题库中检索到匹配的题目。 1. 删除"知识检索"节点和"结束"节点的连线。 2. 单击"添加节点"，选择"判断"，添加"判断"节点，添加至编排页面，连接"知识检索"节点和"判断"节点。 图8连接"知识检索"节点和"判断"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789566.png "点击放大") 3. 单击"判断"节点，参考[图9]完成参数配置。 第一个分支，参数是"知识检索"节点输出的"output_list"，比较条件是"长度大于"，比较对象是"输入"，值为"0"。 图9配置"判断"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949448.png) 5. 配置"大模型"节点，对知识库检索到的结果进行润色，提升回答的流畅性和丰富性。 1. 单击"添加节点"，选择"大模型"，添加"大模型"节点，添加至编排页面，连接"判断"节点的第一个分支和"大模型"节点，这表明如果知识检索的召回数大于0的时候，将运行到该大模型节点。 图10连接"判断"节点的第一个分支和"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717548997.png "点击放大") 2. 单击"大模型"节点，参考[图11]和[表3]完成参数配置。 图11配置"润色输出"大模型节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549067.png "点击放大") 表3参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"润色输出"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 模型配置 | 选择模型为"DeepSeek-V4-Flash"，单击模型配置区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949340.png)"可设置模型的温度、核采样等参数，本实践保持默认值。 | 选择模型接入模块已配置的大语言模型。 | | 输入参数 | 定义以下输入参数。 - 参数名称：默认参数名称为input。 - 类型、值：选择"引用\>output_list"。output_list为"知识检索"节点的输出变量值。 参数2： - 参数名称：默认参数名称为query。 - 类型、值：选择"引用\>question"。question为"生成问题"节点的输出变量值。 | 配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中。 | | 输出参数 | 定义以下输出参数，其余保持默认值即可。 参数名称为"raw_output"，类型为"String"，描述为"模型原始输出"。 | 用于解析大模型节点的输出，并提供给后续节点的输出参数引用。 | | 系统提示词 | - | 配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | | 用户提示词 | 输入如下系统提示词后单击"系统提示词"区域右上角的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549085.png "点击放大")，进行提示词优化。 ``` 你是经验丰富的小学语文老师，请依据“{{input}}”的结果，回答用户提出的问题：{{query}}，润色一份非常丰富的解答输出。 ## 输出示例 问题： 解题思路： 答案： ##限制 不要输出其他无关内容。 答案：（此回答由AI生成） ``` | 配置输入给大模型的提示词，用户级提示词，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | 6. 配置"大模型"节点，该节点对用户的问题生成详细的解答，并对大模型的输出注明"（此回答由AI生成）"。 1. 单击"添加节点"，选择"大模型"，将"大模型"节点，添加至编排页面，连接"判断"节点的第二个分支和"大模型"节点，这表明如果知识检索没有召回任何答案的时候，将运行到该大模型节点。 图12连接"判断"节点的第二个分支和"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389217.png "点击放大") 2. 单击"大模型"节点，参考[图13]和[表4]完成参数配置。 图13配置"AI输出"大模型节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389113.png "点击放大") 表4参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"AI输出"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 模型配置 | 选择模型为"DeepSeek-V4-Flash"，单击模型配置区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549079.png)"可设置模型的温度、核采样等参数，本实践保持默认值。 | 选择模型接入模块已配置的大语言模型。 | | 输入参数 | 定义以下输入参数。 - 参数名称：默认参数名称为input。 - 类型、值：选择"引用\>question"。question为"生成问题"节点的输出变量值。 参数2： - 参数名称：默认参数名称为query。 - 类型、值：选择"引用\>query"。query为"开始"节点的输入变量值。 | 配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为"query"。 | | 输出参数 | 定义以下输出参数，其余保持默认值即可。 参数名称为"raw_output"，类型为"String"，描述为"模型原始输出"。 | 用于解析大模型节点的输出，并提供给后续节点的输出参数引用。 | | 系统提示词 | 输入如下系统提示词后单击"系统提示词"区域右上角的![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949468.png "点击放大")，进行提示词优化。 ``` 你是经验丰富的小学语文老师，请对用户提出的问题做出一份非常丰富的解答，并且在回复的末尾，你需要加上“（此回答由AI生成）”。 ##输出示例 问题： 解题思路： 答案：（此回答由AI生成） ``` | 配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | | 用户提示词 | {{query}} | 配置输入给大模型的提示词，用户级提示词，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | 7. 配置"代码"节点，对"润色输出"大模型节点和"AI输出"大模型节点的输出字符串使用代码，进行格式化处理。 1. 单击"添加节点"，选择"代码"，添加"代码"节点，添加至编排页面，将"润色输出"大模型节点和"AI输出"大模型节点连接到代码节点。 图14将"润色输出"大模型节点和"AI输出"大模型节点连接到代码节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389237.png "点击放大") 2. 单击"代码"节点进行配置。编写代码，根据输入变量生成返回值，参考[图15]完成参数配置。 图15配置"代码"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389223.png) 表5参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 输入参数 | 定义以下输入参数，单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789614.png)可添加参数。 - 参数名称为str1，类型为引用，值为引用"润色输出"大模型节点的输出。 - 参数名称为str2，类型为引用，值为引用"AI输出"大模型节点的输出。 | 按照函数定义中指定的参数列表配置入参，即传递给函数的实际值。 输入参数或选择前序节点的输出作为输入。 | | 输出参数 | 定义以下输出参数。 参数名称为output，类型为String，描述为output。 | 配置代码运行后需要输出的参数。 | | 代码 | 描述：将两个字符串拼接并返回指定格式结果 执行语言：Python3.9 入参1：参数名称为str1，类型为string。 入参2：参数名称为str2，类型为string。 出参：参数名称为output，类型string。 代码配置： ``` def main(args: dict) -> dict: str1= args.get('str1','') str2= args.get('str2','') answer= str1+str2 ret = { "output": answer, } return ret ``` | 编写Python代码片段，仅支持python系统库。 说明： 编写代码时不要更改第一行函数定义。 | 图16代码配置示例 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789550.png "点击放大") 8. 配置"结束"节点，输出最终结果。 1. 连接"代码"节点到"结束"节点。 图17连接"代码"节点到"结束"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549091.png "点击放大") 2. 单击"结束"节点，如[图18]配置输入参数和回复。 图18配置"结束"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949474.png) 表6参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 输入参数 | 定义以下输入参数。 参数名称为result，类型为引用，值为引用代码节点的输出。 | 输入参数支持引用和输入两种类型，输入参数需要在指定回复的文本框中以{{variable_name}}的形式进行插入才能返回。 | | 输出参数 | - | 输出参数将以变量形式返回，支持引用和输入两种类型。 | | 指定回复 | {{result}} | 可以在文本框中编辑指定的回复内容，支持在文本中以{{variable_name}}的形式插入输入参数返回或直接返回输入参数。工作流的最终运行结果将按照指定回复中的内容返回。指定回复中不能插入输出参数。 | #### 调试工作流 1. [编排工作流]完成后，在工作流编排界面单击右上角"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549029.png)"。 2. 在对话框中直接与工作流进行交互，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。 检查节点设置是否有误，常见节点报错可参见《[常见问题](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0001.html)》。 ![](https://support.huaweicloud.com/bestpractice-agentarts/public_sys-resources/note_3.0-zh-cn.png) - 单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789496.png)，一键清除试运行界面内容。 - 文件输入：请参考[开始节点](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0060.html)配置参数，可增加"文件"或"文件数组"类型，并在试运行界面中上传文件。 图19试运行（以25.12.0版本示例） ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949410.png "点击放大") 3. 在试运行过程中，可以单击右上角"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549119.png)"，查看调试结果，包括运行结果与调用详情。 图20运行结果 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389193.png "点击放大") 图21调用详情 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549113.png "点击放大") 必要时也可以针对工作流中的某个节点单独进行调试，以保证节点的成功运行。以调试"AI输出"节点为例。 1. 在工作流编排页面，单击"AI输出"节点的"![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389127.png)"，进入节点的调试页面。 图22调试单节点 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549005.png) 2. 在节点的"配置信息"输入请求参数的值，单击"开始运行"。 图23配置节点调试任务 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949456.png "点击放大") 3. 单节点调试成功后，将在该节点显示"运行成功"字样及其运行时间。 图24单节点调试结果 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717548995.png "点击放大") #### 提交版本 1. 工作流试运行成功后，在工作流编排页面，单击右上角"提交版本"。 2. 输入版本号与版本描述，如[图25]所示。 图25提交版本 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949378.png "点击放大") #### 相关文档 - 编排工作流时，画布相关的详细操作介绍，请参见[创建工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0047.html)。 - 在创建和运行工作流时，可能会遇到的常见问题，请参见《[常见问题](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0001.html)》。 - 工作流创建完成后，如果需要通过API调用，则需要将提交的版本部署至实例，具体操作请参考[发布并部署工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0053.html)。