# 消息模板 消息模板是预定义的标准化JSON消息结构，通过定义模板，可以规范工作流在特定场景（如系统异常、业务阻断）下的输出格式，实现统一错误处理与交互标准。 消息模板主要与工作流中的[异常节点](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0082.html)配合使用，可以在[异常节点](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0082.html)中快速引用这些模板，确保多个工作流、多个节点之间的消息输出格式统一且可维护。 #### 前提条件 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)。 #### 创建消息模板 1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。 2. 单击左侧导航栏"开发中心 \> 开发配置 "，单击左上角"消息模板"页签，进入消息模板管理界面。 3. 在"消息模板"页面，单击右上角的"新建消息模板"。 4. 在"创建消息模板"的弹框中输入消息的详细信息，如[图1]所示，参数说明请参见[表1]。 图1创建消息模板 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422547.png) 表1创建消息参数说明 | 参数名称 | 参数说明 | |:---|:---| | 消息名称 | 模板的唯一标识名称，用于在节点中识别和选择。 | | 消息分类 | 模板的用途分类。 - 异常：用于工作流异常节点的标准化错误消息输出，可在[异常节点](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0082.html)中引用。 - 自定义：预留分类，暂未开放此功能。 | | 可见范围 | 设置消息模板的可见范围。当前支持以下三种设置。 - 租户内：整个租户内的所有空间和用户均可查看并引用，适用于企业级统一消息规范，如全局错误码场景。 - 当前空间内：仅当前空间的成员可查看并引用，适用于团队级消息模板，如项目组的异常话术场景。 - 仅个人：仅创建者本人可见，适用于开发调试阶段的临时模板场景。 | | 消息体 | 消息体必须为合法的JSON格式。单击右侧的![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538382868.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/usermanual-agentarts0/agentarts_05_0082.html)。 #### 更多操作 消息模板建完成后，您可以执行如[表2]的操作。 表2相关操作 | 操作 | 说明 | |:---|:---| | 导入 | 支持批量导入功能。 1. 在"消息模板"页面，单击页面左上角的"导入"。 2. 在"导入信息模板"弹框中，单击"添加文件"选择需要导入的xlsx文件。 上传文件时，请注意以下限制条件： - 上传文件限xIsx格式，文件不超过5MB； - 单个sheet页的导入数据应不超过200条，超过数量不允许导入。 - 在"导入信息模板"弹框中，单击"下载模板"，可以下载消息模板。 | | 导出 | 在"消息模板"页面，选择需要导出的消息，单击"导出"，导出的消息会以xlsx的格式保存在本地。 | | 编辑 | 编辑消息模板的内容。在"消息模板"页面，找到需要编辑的消息，单击操作列中的"编辑"，在弹出的"编辑消息模板"对话框中进行内容编辑。 | | 删除 | 删除消息模板。在"消息模板"页面，勾选需要删除的消息模板，单击"删除"，可以删除消息模板。 - 单个删除：在待删除的消息模板对应的"操作"列下，单击"删除"。 - 批量删除：勾选待删除消息模板，单击页面左上角的"删除"。 | #### 常见问题 **问：修改了消息模板后，已发布的工作流会受影响吗**？ 答：不会。已发布的工作流版本使用发布时的模板快照。修改仅影响未发布（开发中）的工作流版本在下次执行时的输出。如需更新已发布版本，请重新发布工作流。