# 搭建智能助教工作流操作流程 #### 前提条件 - 已[实名认证](https://support.huaweicloud.com/usermanual-account/account_auth_00001.html)的华为账号或IAM用户。 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)。 #### 准备工作 - 本实践选用平台预置的"DeepSeek-V3"模型。 - 搭建助教工作流前须完成语文知识库创建，详见[创建语文知识库](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0003.html)。 #### 操作流程 | 操作步骤 | 说明 | |:---|:---| | [创建工作流] | 通过填写必要的工作流基本信息，创建一个对话型的智能助教工作流。 | | [编排工作流] | 配置生成问题节点、知识检索节点、判断节点、润色输出节点、AI输出节点、代码节点以及结束节点，以形成一个完整的工作流应用。 | | [调试工作流] | 输入信息并运行工作流，查看大模型的响应结果，优化配置，确保工作流的正确性和有效性。同时，可以查看详细的调试结果和调用详情。 | | [发布工作流] | 调试成功后可以发布工作流，发布后可在"发布管理"页面查看API调用接口信息。 | #### 创建工作流 1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。 2. 单击左侧导航栏"开发中心 \> 智能体管理 "，单击左上角"工作流"页签，进入工作流应用管理界面，单击右上角"创建工作流"。 3. 选择创建"对话型工作流"，在对应的创建页面，配置工作流相关信息，具体如[图1]所示，参数如[表1]所示。 图1创建工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383128.png "点击放大") 表1参数说明 | 参数名称 | 示例 | 说明 | |:---|:---|:---| | 名称 | 智能助教 | 支持中英文、数字、下划线、中划线和空格，长度 2\~64字符，但不允许以空格开头或结尾。 | | 描述 | 本应用是一款基于人工智能技术，旨在减轻教师重复性工作负担、提供个性化教学支持、并提升学生学习效率的智能化辅助工具。 | 描述工作流的功能，可直观呈现给用户，长度0\~1024个字符。 | 4. 配置完成后单击"立即创建"，进入工作流编排页面。 #### 编排工作流 在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342671.png)"，可以对当前节点执行重命名、复制、删除操作。开始和结束节点为必选节点，不支持重命名、复制和删除。 图2节点的重命名、复制、删除操作 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382724.png "点击放大") 1. 配置"开始"节点。单击"开始"节点，该节点已默认配置query参数，表示用户输入的内容。当前场景下无需新增参数。 图3配置开始节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342819.png "点击放大") 2. 配置"大模型"节点，从用户输入中进行问题提取，解析出用户的问题，并用JSON格式输出。参考[图4]和[表2]完成参数配置。 图4配置"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342845.png "点击放大") 表2参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"生成问题"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 模型配置 | 选择模型为"DeepSeek-V3"，单击模型配置区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342741.png)"可设置模型的温度、核采样等参数，本实践保持默认值。 | 选择模型接入模块已配置的大语言模型。 | | 输入参数 | 定义以下输入参数。 - 参数名称为"query"。 - 类型、值：选择"引用\>query"。query为"开始节点"的输出变量值。 | 配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为"query"。 | | 输出参数 | 单击输出区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538543014.png)"，选择输出格式为"JSON"。单击"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542938.png)"，添加参数。 定义以下输出参数，其余保持默认值即可。 - question，类型为"String"，描述为"用户问题"。 - answer，类型为"String"，描述为"用户问题的回答"。 | 用于解析大模型节点的输出，并提供给后续节点的输出参数引用。 | | 系统提示词 | 输入如下系统提示词后单击"系统提示词"区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422749.png "点击放大")"，进行提示词优化。 ``` 你是问题解析专家，请从用户的对话中解析出用户的问题{question}和{answer}，用JSON格式输出。 注意，question一定有值，answer可能没值，如果answer没值，该字段输出空即可。 ``` | 配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | | 用户提示词 | {{query}} | 配置输入给大模型的提示词，用户级提示器，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | 3. 配置"知识检索"节点，从预先上传的语文知识库中检索用户的问题，并返回匹配到的信息。 1. 鼠标悬浮"生成问题"和"结束"节点中的连接线，单击"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383078.png)"，选择"知识检索"节点，添加至编排页面，如[图5]所示。 图5连接"大模型"节点（生成问题）和"知识检索"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422715.png "点击放大") 2. 单击"知识检索"节点，参考[图6]和[图7]完成参数配置。 - 输入参数 参数名称：默认参数名称为query。 类型、值：选择"引用\>question"。question为"生成问题-大模型节点"的输出变量值。 - 知识库可直接选择[创建语文知识库](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0003.html)章节创建的"语文知识库"。 图6配置"知识检索"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342659.png "点击放大") 图7设置知识库 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342857.png "点击放大") 4. 配置"判断"节点，判定是否从预置的题库中检索到匹配的题目。 1. 删除"知识检索"节点和"结束"节点的连线。 2. 单击"添加节点"，选择"判断"，添加"判断"节点，添加至编排页面，连接"知识检索"节点和"判断"节点。 图8连接"知识检索"节点和"判断"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422667.png "点击放大") 3. 单击"判断"节点，参考[图9]完成参数配置。 第一个分支，参数是"知识检索"节点输出的"output_list"，比较条件是"长度大于"，比较对象是"输入"，值为"0"。 图9配置"判断"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542924.png "点击放大") 5. 配置"大模型"节点，对知识库检索到的结果进行润色，提升回答的流畅性和丰富性。 1. 单击"添加节点"，选择"大模型"，添加"大模型"节点，添加至编排页面，连接"判断"节点的第一个分支和"大模型"节点，这表明如果知识检索的召回数大于0的时候，将运行到该大模型节点。 图10连接"判断"节点的第一个分支和"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542996.png "点击放大") 2. 单击"大模型"节点，参考[图11]和[表3]完成参数配置。 图11配置"润色输出"大模型节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382954.png "点击放大") 表3参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"润色输出"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 模型配置 | 选择模型为"DeepSeek-V3"，单击模型配置区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542900.png)"可设置模型的温度、核采样等参数，本实践保持默认值。 | 选择模型接入模块已配置的大语言模型。 | | 输入参数 | 定义以下输出参数。 - 参数名称：默认参数名称为input。 - 类型、值：选择"引用\>output_list"。output_list为"知识检索"节点的输出变量值。 参数2： - 参数名称：默认参数名称为query。 - 类型、值：选择"引用\>question"。question为"生成问题"节点的输出变量值。 | 配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中。 | | 输出参数 | 定义以下输出参数，其余保持默认值即可。 参数名称为"raw_output"，类型为"String"，描述为"模型原始输出"。 | 用于解析大模型节点的输出，并提供给后续节点的输出参数引用。 | | 系统提示词 | - | 配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | | 用户提示词 | 输入如下系统提示词后单击"系统提示词"区域右上角的![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342669.png "点击放大")，进行提示词优化。 ``` 你是经验丰富的小学语文老师，请依据“{{input}}”的结果，回答用户提出的问题：{{query}}，润色一份非常丰富的解答输出。 ## 输出示例 问题： 解题思路： 答案： ##限制 不要输出其他无关内容。 答案：（此回答由AI生成） ``` | 配置输入给大模型的提示词，用户级提示器，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | 6. 配置"大模型"节点，该节点对用户的问题生成详细的解答，并对大模型的输出注明"（此回答由AI生成）"。 1. 单击"添加节点"，选择"大模型"，将"大模型"节点，添加至编排页面，连接"判断"节点的第二个分支和"大模型"节点，这表明如果知识检索没到召回任何答案的时候，将运行到该大模型节点。 图12连接"判断"节点的第二个分支和"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383026.png "点击放大") 2. 单击"大模型"节点，参考[图13]和[表4]完成参数配置。 图13配置"AI输出"大模型节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538543128.png "点击放大") 表4参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"AI输出"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 模型配置 | 选择模型为"DeepSeek-V3"，单击模型配置区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342873.png)"可设置模型的温度、核采样等参数，本实践保持默认值。 | 选择模型接入模块已配置的大语言模型。 | | 输入参数 | 定义以下输出参数。 - 参数名称：默认参数名称为input。 - 类型、值：选择"引用\>question"。question为"生成问题"节点的输出变量值。 参数2： - 参数名称：默认参数名称为query。 - 类型、值：选择"引用\>query"。query为"开始"节点的输入变量值。 | 配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为"query"。 | | 输出参数 | 定义以下输出参数，其余保持默认值即可。 参数名称为"raw_output"，类型为"String"，描述为"模型原始输出"。 | 用于解析大模型节点的输出，并提供给后续节点的输出参数引用。 | | 系统提示词 | 输入如下系统提示词后单击"系统提示词"区域右上角的![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342737.png "点击放大")，进行提示词优化。 ``` 你是经验丰富的小学语文老师，请对用户提出的问题做出一份非常丰富的解答，并且在回复的末尾，你需要加上“（此回答由AI生成）”。 ##输出示例 问题： 解题思路： 答案：（此回答由AI生成） ``` | 配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | | 用户提示词 | {{query}} | 配置输入给大模型的提示词，用户级提示器，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | 7. 配置"代码"节点，对"润色输出"大模型节点和"AI输出"大模型节点的输出字符串使用代码，进行格式化处理。 1. 单击"添加节点"，选择"代码"，添加"代码"节点，添加至编排页面，连接"润色输出"大模型节点和"AI输出"大模型节点到代码节点。 图14连接"润色输出"大模型节点和"AI输出"大模型节点到代码节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383082.png "点击放大") 2. 单击"代码"节点进行配置。编写代码，根据输入变量生成返回值，参考[图15]完成参数配置。 图15配置"代码"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542872.png "点击放大") 表5参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 执行方式 | 本地执行 | 适用于高性能、低延迟的场景，主要用于执行简单的逻辑判断、文本处理以及JSON数据的封装与解析。该执行模式无需依赖远程服务，所有操作在本地完成，响应速度快，适合对实时性要求较高的任务。 | | 函数名称 | 名称：demo 描述：将两个字符串拼接并返回指定格式结果 执行语言：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 ``` 修改后的代码截图如[图16]所示。 | 需要先通过单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538543118.png)创建函数，然后选择下拉列表中的函数，即之前已定义保存的函数，也可以进行以下操作。 - 单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342693.png)：可以直接在弹出的创建函数页面快速创建函数，参数配置完成后可单击"创建"保存函数。 - 单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383100.png)：选择函数后，单击该图标可以在弹出的"编辑函数"页面中快速编辑函数，参数编辑完成后可单击"更新"保存函数。 | | 输入参数 | 定义以下输入参数，单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538543076.png)可添加参数。 - 参数名称为str1，类型为引用，值为引用"润色输出"大模型节点的输出。 - 参数名称为str2，类型为引用，值为引用"AI输出"大模型节点的输出。 | 按照函数定义中指定的参数列表配置入参，即传递给函数的实际值。 输入参数或选择前序节点的输出作为输入。 | | 输出参数 | 定义以下输出参数。 参数名称为output，类型为String，描述为output。 | 配置代码运行后需要输出的参数。 | 图16代码配置示例 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383018.png "点击放大") 8. 配置"结束"节点，输出最终结果。 1. 连接"代码"节点到"结束"节点。 图17连接"代码"节点到"结束"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342679.png "点击放大") 2. 单击"结束"节点，如[图18]配置输入参数和回复。 图18配置"结束"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342661.png "点击放大") 表6参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 输入参数 | 定义以下输入参数。 参数名称为result，类型为引用，值为引用代码节点的输出。 | 输入参数支持引用和输入两种类型，输入参数需要在指定回复的文本框中以{{variable_name}}的形式进行插入才能返回。 | | 输出参数 | - | 输出参数将以变量形式返回，支持引用和输入两种类型。 | | 指定回复 | {{result}} | 可以在文本框中编辑指定的回复内容，支持在文本中以{{variable_name}}的形式插入输入参数返回或直接返回输入参数。工作流的最终运行结果将按照指定回复中的内容返回。指定回复中不能插入输出参数。 | #### 调试工作流 1. [编排工作流]完成后，在工作流编排界面单击右上角"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342835.png)"。 2. 在对话框中直接与工作流进行交互，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。 检查节点设置是否有误，常见节点报错可参见《[常见问题](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0001.html)》。 ![](https://support.huaweicloud.com/bestpractice-agentarts0/public_sys-resources/note_3.0-zh-cn.png) 试运行界面支持文本输入、文件输入和语音输入： - 文本输入：在对话输入框输入对话后按Enter键或单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383064.png "点击放大")，查看应用响应结果。 - 语音输入：全局配置中开启语音交互功能时，用户可以通过语音进行输入。该功能支持多种语言（如中文、英文等），并提供语音识别、错误纠正和实时反馈等功能。 - 首次使用语音输入须开通系统麦克风、扬声器权限，可在权限申请弹窗一键开通。 - 语音超过60秒，弹窗提示语音输入时长最长为60秒，取消语音输入状态，用户需重新录入。 - 调试结果支持朗读功能，单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422737.png)，应用将按照设置的音色将文字转换成语音播放。 - 单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538543040.png)，支持对变量进行编辑或重置。 - 单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542988.png)，一键清除试运行界面内容。 - 文件输入：请参考[开始节点](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0060.html)配置参数，可增加"文件"或"文件数组"类型，并在试运行界面中上传文件。 图19试运行（以25.12.0版本示例） ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342829.png "点击放大") 3. 在试运行过程中，可以单击右上角"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542958.png)"，查看调试结果，包括运行结果与调用详情。 图20运行结果 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542862.png "点击放大") 图21调用详情 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342807.png "点击放大") 必要时也可以针对工作流中的某个节点单独进行调试，以保证节点的成功运行。以调试"AI输出"节点为例。 1. 在工作流编排页面，单击"AI输出"节点的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383118.png)"，进入节点的调试页面。 图22调试单节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542858.png "点击放大") 2. 在节点的"配置信息"输入请求参数的值，单击"开始运行"。 图23配置节点调试任务 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422697.png "点击放大") 3. 单节点调试成功后，将在该节点显示"运行成功"字样及其运行时间。 图24单节点调试结果 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538543092.png "点击放大") #### 发布工作流 1. 工作流试运行成功后，在工作流编排页面，单击右上角"提交版本"。 2. 输入版本号与版本描述，如[图25]所示。 图25发布工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382826.png "点击放大") 3. 发布完成后选择上方"渠道管理"页签，可进入渠道管理页面。 在**网页** 分享渠道的**操作** 列单击"发布"按钮后将出现"立即访问"、"复制链接"、"重新生成"文字按钮。这里可以通过两种方式访问工作流应用的网页应用链接，同时支持重新生成发布链接。 图26发布工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342575.png "点击放大") - 立即访问：单击当前页面的"立即访问"按钮，可立即进入网页版应用。 图27立即访问网页应用 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542796.png "点击放大") - 复制链接：单击当前页面的"复制链接"按钮，可直接复制网页URL嵌入或分享到其他应用场景。 图28复制工作流应用访问地址 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422525.png "点击放大") - 重新生成：重新生成工作流应用发布链接。 #### 相关文档 - 编排工作流时，画布相关的详细操作介绍，请参见[创建工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0047.html)。 - 在创建和运行工作流时，可能会遇到的常见问题，请参见《[常见问题](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0001.html)》。