# 搭建辅助批改作业工作流操作流程 #### 前提条件 - 已[实名认证](https://support.huaweicloud.com/usermanual-account/account_auth_00001.html)的华为账号或IAM用户。 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)。 #### 准备工作 本实践选用平台预置的"DeepSeek-V3"模型。 #### 操作流程 | 操作步骤 | 说明 | |:---|:---| | [创建工作流] | 通过填写必要的工作流基本信息，创建一个任务型的辅助批改作业工作流。 | | [编排工作流] | 配置大模型节点、开始批改作业、内容批改以及结束节点，以形成一个完整的工作流应用。 | | [调试工作流] | 输入信息并运行工作流，查看大模型的响应结果，优化配置，确保工作流的正确性和有效性。同时，可以查看详细的调试结果和调用详情。 | | [发布工作流] | 调试成功后可以发布工作流，发布后可在"发布管理"页面查看API调用接口信息。 | #### 创建工作流 1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。 2. 单击左侧导航栏"开发中心 \> 智能体管理 "，单击左上角"工作流"页签，进入工作流应用管理界面，单击右上角"创建工作流"。 3. 选择创建"对话型工作流"，在对应的创建页面，配置工作流相关信息，具体如[图1]所示，参数如[表1]所示。 图1创建工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542762.png "点击放大") 表1参数说明 | 参数名称 | 示例 | 说明 | |:---|:---|:---| | 名称 | 辅助批改作业 | 支持中英文、数字、下划线、中划线和空格，长度 2\~64字符，但不允许以空格开头或结尾。 | | 描述 | 辅助批改作业 | 描述工作流的功能，可直观呈现给用户，长度0\~1024个字符。 | 4. 配置完成后单击"立即创建"，进入工作流编排页面。 #### 编排工作流 在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542956.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_0000002538382910.png) 2. 配置"大模型"节点，从用户输入中进行问题提取，解析出用户的问题，并用JSON格式输出。参考[图4]和[表2]完成参数配置。 图4配置"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422595.png) 表2参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"大模型节点"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 模型配置 | 选择模型为"DeepSeek-V3"，单击模型配置区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542894.png)"可设置模型的温度、核采样等参数，本实践保持默认值。 | 选择模型接入模块已配置的大语言模型。 | | 输入参数 | 定义以下输入参数。 - 参数名称为"text"。 - 类型、值：选择"引用 \> query String"。text为"开始节点"的输出变量值。 | 配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为"query"。 | | 输出参数 | 单击输出区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542794.png)"，选择输出格式为"JSON"。单击"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422709.png)"，添加参数。 定义以下输出参数，其余保持默认值即可。 - question，类型为"String"，描述为"用户问题"。 - user_answer，类型为"String"，描述为"用户问题的回答"。 | 用于解析大模型节点的输出，并提供给后续节点的输出参数引用。 | | 系统提示词 | 默认即可，可不填写。 | 配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | | 用户提示词 | 输入如下系统提示词后单击"系统提示词"区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382928.png "点击放大")"，进行提示词优化。 ``` 你是信息整理专家，请整理信息，从用户给定的内容中提取问题和答案，问题保存在question中，答案保存在user_anwser，并且用JSON输出{question}和{user_anwser}. 用户上传的内容： {{text}} ## 限制 - 不得丢失任何用户上传的信息。 ``` | 配置输入给大模型的提示词，用户级提示器，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | 3. 配置"消息"节点，在工作流执行过程中向用户发送该消息。 1. 删除"大模型"节点和"结束"节点的连线。 2. 单击"添加节点"，选择"消息"，添加"消息"节点至编排页面，连接"大模型"节点和"消息"节点。 图5连接"大模型"节点和"消息"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382938.png "点击放大") 3. 单击"消息"节点，参考[图6]和[表3]完成参数配置。 图6配置"消息"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342601.png "点击放大") 表3参数配置说明 | 参数名称 | 配置示例 | 参数说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"开始批改作业"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 输入参数 | 定义以下输入参数。 - 参数名称：input - 类型：输入 - 值：描述输入 | 当单击![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342639.png)图标时，可新增输入参数。 - 参数名称：只允许输入字母、数字、下划线，且不能以数字开头。 - 类型、值：支持"引用"和"输入"两种类型。 - 引用：支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量。 - 输入：支持用户自定义取值。 | | 指定回复 | ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382862.png "点击放大")开始批改作业.... | 可撰写指定的回复信息，并支持以{{参数名称}}的形式插入变量。回复信息将在工作流执行到该节点时发送给用户。 | | 结构化信息 | 关闭 | 功能开启时，可使用{{_NODE_OUTPUT}}引用"指定回复"中的信息实现结构化输出。 | 4. 配置"大模型"节点，对用户的问题直接给出一份丰富的解答。 1. 单击"添加节点"，选择"大模型"，将"大模型"节点至编排页面，连接"消息"节点和"大模型"节点。 图7连接"消息"节点和"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422687.png "点击放大") 2. 单击"大模型"节点，参考[图8]和[表4]完成参数配置。 图8配置"大模型"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422647.png) 表4参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 节点名称 | 单击大模型名称，修改节点名称为"内容批改"。 | 只允许输入字母、数字、下划线，且不能以数字开头。 | | 模型配置 | 选择模型为"DeepSeek-V3"，单击模型配置区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542828.png)"可设置模型的温度、核采样等参数，本实践保持默认值。 | 选择模型接入模块已配置的大语言模型。 | | 输入参数 | 定义以下输入参数。 - 参数名称为"question"。 - 类型、值：选择"引用 \> question String"。question为"大模型节点"的输出变量值。 - 参数名称为"user_answer"。 - 类型、值：选择"引用 \> user_answer String"。user_answer为"大模型节点"的输出变量值。 | 配置大模型处理需要的输入参数值， 这些值会动态添加到提示词中，默认设置的输入参数名为"query"。 | | 输出参数 | 单击输出区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382866.png)"，选择输出格式为"文本"。 定义以下输出参数，其余保持默认值即可。 review，参数类型为"String"。 | 用于解析大模型节点的输出，并提供给后续节点的输出参数引用。 | | 系统提示词 | 默认即可，可不填写。 | 配置输入给大模型的提示词，系统级提示词，用于指导模型按要求进行回复。支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | | 用户提示词 | 输入如下系统提示词后单击"系统提示词"区域右上角的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382920.png "点击放大")"，进行提示词优化。 ``` 你是专业的历史老师，你擅长历史主观题的批改。请根据下列规则，批改用户的作业，并给出你的评分和原因。 ## 评分标准 明确回答问题：首先要确保对题目的核心问题有清晰的回应，不能偏离主题。 逻辑清晰，结构合理：历史主观题的回答要有条理，一般建议先提出观点，然后进行论证。可以采用总分总结构，即开头简要陈述观点，中间具体论述，最后总结。 史实准确，引用充分：回答时需要用准确的历史事件、人物、时间、地点等作为论据支持自己的观点。引用史实时最好标明具体时间、地点和人物，确保内容的可信性和准确性。 分析与解释：除了陈述史实外，还需要对历史事件进行分析，探讨它的背景、原因、过程、结果及其影响。要展现自己对历史的深刻理解，而不仅仅是简单的描述。 多角度思考：如果题目允许，可以从不同的角度进行分析，如政治、经济、文化、社会等多方面，展现出对历史事件全面的理解。 平衡与客观：在分析历史事件时，要保持客观、公正，避免单方面或片面的解释。如果有争议性的问题，可以提到不同的历史观点，但要注意说明自己的立场并给出理由。 ## 题目：{{question}} ## 用户回答：{{user_answer}} ## 输出示例 题目：.... 回答：.... 分数：n/10 原因： 1. 2. 3. 4. 5. ``` | 配置输入给大模型的提示词，用户级提示器，作为当前用户问题的输入。配置提示词时，支持使用{{variable}}格式引用当前节点输入参数中已定义好的参数。最终替换后的内容会传递给模型。 | 5. 配置"结束"节点，输出最终结果。 1. 连接"大模型"节点到"结束"节点。 图9连接"大模型"节点到"结束"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382976.png "点击放大") 2. 单击"结束"节点，如[图10]配置输入参数和回复。 图10配置"结束"节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342583.png) 表5参数配置说明 | 参数 | 配置示例 | 说明 | |:---|:---|:---| | 输入参数 | 定义以下输入参数。 参数名称为result，类型为引用，值为引用大模型节点的输出。 | 输入参数支持引用和输入两种类型，输入参数需要在指定回复的文本框中以{{variable_name}}的形式进行插入才能返回。 | | 输出参数 | - | 输出参数将以变量形式返回，支持引用和输入两种类型。 | | 指定回复 | {{result}} | 可以在文本框中编辑指定的回复内容，支持在文本中以{{variable_name}}的形式插入输入参数返回或直接返回输入参数。工作流的最终运行结果将按照指定回复中的内容返回。指定回复中不能插入输出参数。 | #### 调试工作流 1. [编排工作流]完成后，在工作流编排界面单击右上角"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542844.png)"。 2. 在对话框中直接与工作流进行交互，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。 检查节点设置是否有误，常见节点报错可参考《常见问题》进行解决。 ![](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)配置参数，可增加"文件"或"文件数组"类型，并在试运行界面中上传文件。 图11试运行 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542816.png "点击放大") 3. 在试运行过程中，可以单击右上角"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538383000.png)"查看调试结果，包括运行结果与调用详情。 图12运行结果（以25.12.0版本示例） ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382962.png "点击放大") 图13调用详情 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342535.png "点击放大") 必要时也可以针对工作流中的某个节点单独进行调试，以保证节点的成功运行。以调试"大模型节点"为例。 1. 在工作流编排页面，单击"大模型节点"的"![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422661.png)"，进入节点的调试页面。 图14调试单节点 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342713.png "点击放大") 2. 在节点的"配置信息"输入请求参数的值，单击"开始运行"。 图15配置节点调试任务 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542834.png "点击放大") 3. 单节点调试成功后，将在该节点显示"运行成功"字样及其运行时间。 图16单节点调试结果 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382926.png "点击放大") #### 发布工作流 1. 工作流试运行成功后，在工作流编排页面，单击右上角"提交版本"。 2. 输入版本号与版本描述，如[图17]所示。 图17发布工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382826.png "点击放大") 3. 发布完成后选择上方"渠道管理"页签，可进入渠道管理页面。 在**网页** 分享渠道的**操作** 列单击"发布"按钮后将出现"立即访问"、"复制链接"、"重新生成"文字按钮。这里可以通过两种方式访问工作流应用的网页应用链接，同时支持重新生成发布链接。 图18发布工作流 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342575.png "点击放大") - 立即访问：单击当前页面的"立即访问"按钮，可立即进入网页版应用。 图19立即访问网页应用 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542796.png "点击放大") - 复制链接：单击当前页面的"复制链接"按钮，可直接复制网页URL嵌入或分享到其他应用场景。 图20复制工作流应用访问地址 ![](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)》。