需确保邮件模板语法合规且Agent正确绑定渲染上下文：模板须为UTF-8编码.text文件，以#% dw 2.0声明，根输出为字符串；Agent配置需在mulerun-agents.yaml中定义email-template-renderer类型，指定templatePath与contextMapping，并启用strictMode；SMTP传输层需手动添加RFC 5322标准Header及空行分隔符，密码须通过${secure::smtp.password}引用；调试时启用DEBUG日志并验证编码格式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在MuleRun中动态生成并发送结构化邮件，但缺乏标准化的模板定义机制或Agent配置支持，则可能是由于邮件模板语法不合规或Agent未正确绑定渲染上下文。以下是实现MuleRun邮件模板编写与Agent配置的具体操作路径：
一、定义符合MuleRun语法的邮件模板
MuleRun使用基于DataWeave表达式的模板语法，支持变量插值、条件分支和列表迭代，模板必须保存为UTF-8编码的.text文件，并置于resources/templates/目录下。模板需以#% dw 2.0开头声明版本，且根对象必须为字符串类型输出。
1、在项目resources/templates/子目录中新建文件，命名为notification-email.text。
2、在文件首行写入#% dw 2.0，第二行写入output text/plain。
3、在后续行中使用$(payload.subject)插入JSON负载中的subject字段，用$(if (payload.status == 'failed') '⚠️ 处理失败' else '✅ 处理成功')嵌入条件文本。
4、对列表类字段如payload.items，使用$(payload.items map ((item, index) -> '- ${item.name}: ${item.value}'))生成带换行符的条目清单。
5、确保所有变量路径与实际传入payload结构严格一致，任何路径错误将导致模板渲染为空字符串而非报错。
二、配置MuleRun邮件撰写Agent
邮件撰写Agent是独立于传输通道的纯逻辑组件，负责加载模板、注入上下文数据并输出最终邮件内容（含Header与Body），其配置需通过YAML声明式定义，并挂载至指定Flow节点。
1、在src/main/resources/mulerun-agents.yaml中新增agent块，设置type为email-template-renderer。
2、在该agent下添加templatePath属性，值设为templates/notification-email.text。
3、添加contextMapping字段，以键值对形式声明payload映射关系，例如subject: $.header.title表示从消息头提取title赋给模板变量subject。
4、启用strictMode: true，使Agent在检测到未定义变量时抛出TemplateRenderException而非静默忽略。
5、必须将此Agent配置的id引用到Flow的run-agent操作中，否则模板不会被执行。
三、绑定邮件模板与SMTP传输层
MuleRun不内置邮件发送能力，撰写完成的邮件内容需交由外部SMTP Agent进行投递，因此必须确保模板输出结构满足RFC 5322标准，包含必需的Header字段与空行分隔符。
1、在邮件模板末尾手动添加两行空行，再追加From: $(payload.sender)与To: $(payload.recipient)等Header行。
2、在SMTP Agent配置中，将input字段指向前述email-template-renderer Agent的输出变量名（如renderedEmail）。
3、设置SMTP Agent的contentType为text/plain; charset=UTF-8，并启用enableStartTls选项。
4、验证SMTP Agent的host、port、username与password字段全部非空，密码字段禁止使用明文，必须通过${secure::smtp.password}引用密钥库条目。
四、调试模板渲染结果
模板实际输出可能因数据缺失、类型不匹配或编码异常而偏离预期，需借助MuleRun内置调试机制捕获中间态内容，避免直接依赖日志文本推断问题根源。
1、在Flow中email-template-renderer Agent后插入log操作，level设为DEBUG，message设为"Rendered email: #[payload]"。
2、启动应用时添加JVM参数-Dmulerun.log.level=DEBUG以启用全量Agent日志。
3、触发流程后检查控制台输出，定位是否存在Template evaluation returned null或Cannot coerce Null to String类错误。
4、若发现乱码，确认模板文件保存为UTF-8无BOM格式，Windows记事本默认保存为ANSI，必须使用VS Code或Notepad++另存为UTF-8。
