# 消息模板 消息模板是预定义的标准化JSON消息结构，通过定义模板，可以规范工作流在特定场景（如系统异常、业务阻断）下的输出格式，实现统一错误处理与交互标准。 消息模板主要与工作流中的[异常节点](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0082.html)配合使用，[异常节点](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0082.html)被触发时，根据节点配置引用对应的消息模板，将模板中定义的JSON结构作为节点输出返回给用户或下游节点，确保多个工作流、多个节点之间的消息输出格式统一且可维护。 **典型场景**：当工作流中大模型调用节点发生超时异常时，异常节点触发并引用预定义的"模型超时提示"消息模板，输出包含错误码、提示信息和重试建议的标准化JSON消息，确保用户在不同工作流中看到一致的错误提示。 #### 前提条件 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。 #### 创建消息模板 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 单击左侧导航栏"开发中心 \> 开发配置 "，选择"消息模板"页签。 3. 在"消息模板"页面，单击右上角的"新建消息模板"。 4. 在"创建消息模板"的弹框中输入消息的详细信息，如[图1]所示，参数说明请参见[表1]。 图1创建消息模板 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390221.png) 表1创建消息参数说明 | 参数名称 | 参数说明 | |:---|:---| | 消息名称 | 模板的唯一标识名称，用于在节点中识别和选择。 支持中英文、数字、下划线、中划线，长度 2-64 字符，以中英文、数字开头。 | | 消息分类 | 模板的用途分类。 - 异常：用于工作流异常节点的标准化错误消息输出，可在[异常节点](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0082.html)中引用。 - 自定义：预留分类，暂未开放此功能。 | | 可见范围 | 设置消息模板的可见范围。当前支持以下两种设置。 - 租户内：整个租户内的用户均可查看并引用，适用于企业级统一消息规范，如全局错误码场景。 - 仅个人：仅创建者本人可见，适用于开发调试阶段的临时模板场景。 | | 消息体 | 消息体必须为合法的JSON格式。单击右侧的![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950462.png)可以扩展内容输入框，方便输入更多详细信息。 注意： 系统提供了校验功能，确保消息的语法正确性。如果消息体存在语法问题，将无法成功创建。 示例1：简单文本消息（适用于简单错误提示场景） ``` { "msg": "错误的URL、链接失效或网页已被删除", "code": "404" } ``` 示例2：结构化错误消息（适用于含错误码的异常处理场景） ``` { "type": "error", "code": "ERR_MODEL_TIMEOUT", "message": "模型响应超时，请检查网络连接后重试。", "suggestion": "如果问题持续，请尝试切换至其他模型。", "contact": "技术支持：support@example.com" } ``` 示例3：多字段卡片消息（适用于需要用户交互的服务降级场景） ``` { "type": "card", "title": "服务暂时不可用", "fields": [ {"label": "错误类型", "value": "服务过载"}, {"label": "影响范围", "value": "知识库检索功能"}, {"label": "预计恢复", "value": "10 分钟内"} ], "actions": [ {"label": "重试", "action": "retry"}, {"label": "联系支持", "action": "contact_support"} ] } ``` | 5. 单击"确定"可保存设置的消息信息。创建完成后，您可以在"开发中心 \> 开发配置 \> 消息模板"界面中的"消息模板列表"查看已创建的消息模板。 #### 在工作流中引用消息模板 消息模板创建后，可以在工作流的异常节点中引用，具体请参见[异常](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0082.html)。 引用后，可在工作流调试界面触发异常节点，检查输出消息是否符合模板定义的JSON结构，验证引用是否生效。 #### 更多操作 消息模板创建完成后，您可以执行如[表2]的操作。 表2相关操作 | 操作 | 说明 | |:---|:---| | 导入 | 支持批量导入功能。 1. 在"消息模板"页面，单击页面左上角的"导入"。 2. 在"导入消息模板"弹框中，单击"添加文件"选择需要导入的xlsx文件。 上传文件时，请注意以下限制条件： - 上传文件限xlsx格式，文件不超过5MB； - 单个sheet页的导入数据应不超过200条，超过数量不允许导入。 - 在"导入消息模板"弹框中，单击"下载模板"，可以下载消息模板。 | | 导出 | 在"消息模板"页面，选择需要导出的消息，单击"导出"，导出的消息会以xlsx的格式保存在本地。 | | 编辑 | 编辑消息模板的内容。在"消息模板"页面，找到需要编辑的消息，单击操作列中的"编辑"，在弹出的"编辑消息模板"对话框中进行内容编辑。 | | 删除 | 删除消息模板。在"消息模板"页面，勾选需要删除的消息模板，单击"删除"，可以删除消息模板。 - 单个删除：在待删除的消息模板对应的"操作"列下，单击"删除"。 - 批量删除：勾选待删除消息模板，单击页面左上角的"删除"。 | #### 常见问题 **问：修改了消息模板后，已发布的工作流会受影响吗**？ 答：不会。已发布的工作流版本使用发布时的模板快照。修改仅影响未发布（开发中）的工作流版本在下次执行时的输出。如需更新已发布版本，请重新[发布并部署工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0053.html)。