适用于：Dynamics 365 Customer Service
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
利用此功能在编辑表单中打开已知的邮件模板。
它的作用是什么
助手加载由其 Dataverse 模板 ID 识别的模板，并在编辑表单中显示其当前内容。 你可以更新名称、主题、正文、描述、模板类型、语言和分享级别。
对于标题或主题搜索，请先使用 show_email_template 。 它找到模板并打开了相同的编辑体验。
试试像这样的提示
- 编辑带有ID 0000000-0000-0000-0000-0000-000000000000的邮件模板。
- 将模板更新为 ID 0000000-0000-0000-0000-0000000000000。
- 修改带有 ID 0000000-0000-0000-0000-00000-00000000000000 的邮件模板。
你在聊天中会看到的内容
助手会在编辑表单中显示所选模板，并预先填充其现有值。
你可以通过聊天应用组件做些什么
- 审查并更新模板内容。
- 更改模板类别、语言或分享级别。
- 将更新后的模板保存到Dynamics 365。
有用的提示
- 当你知道标题或主题但不知道模板ID时，使用
show_email_template。 - 保存前请确认模板类别，以确保合并字段兼容。
- 组织模板被共享;个人模板仅对其所有者可见。
接下来会发生什么
- 将更新后的模板应用到邮件中。
- 打开另一个已保存的模板。
- 创建一个新的电子邮件模板。
这会改变数据吗？
不，这不会改变数据。
打开编辑表单是只读的。 在表单中选择 “更新 ”会调用 save_email_template，这会更改现有模板。
先决条件
该工具需要对电子邮件模板进行读写权限。
在 配置电子邮件中了解详细信息。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 编辑邮件模板 |
| 内部工具名称 | edit_email_template |
| Purpose | 将已知的邮件模板加载到编辑表单中 |
工具行为
通过GUID加载一个邮件模板，并在编辑表单中打开当前值。 它不会搜索模板，也不会写入数据，直到用户通过 save_email_template保存。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用，因为打开表单是只读的。 |
idempotentHint |
未设置 | 对只读请求使用默认行为。 |
openWorldHint |
未设置 | 对Dataverse请求使用默认行为。 |
输入概念
模板标识
| 输入 | Description | 必需 |
|---|---|---|
templateId |
加载邮件模板的GUID。 | 是的 |
响应与用户界面行为
该 MCP 工具由 MCP 应用支持。
响应类型
交互组件（聊天应用）
组件显示现有模板字段，并将主动作更改为 “更新”。 如果模板无法加载，响应会解释Dataverse错误。
路由注释
用户想要时使用 edit_email_template ：
- 当模板的GUID已经已知时，打开它。
- 继续从模板列表开始的编辑流程。
用户想用时不要使用 edit_email_template ：
- 按标题或主题查找模板——使用
show_email_template。 - 创建一个新模板——使用
create_email_template。
相关工具
| 工具 | 关系 |
|---|---|
show_email_template |
查找模板并打开选定结果 |
save_email_template |
保存编辑表单中所做的更改 |
create_email_template |
打开一个空白表单以获取新模板 |
apply_email_template |
将现有模板应用到邮件中 |
数据变异分类
只读。
输入工具只加载数据。 选择 Update 触发 save_email_template，即可更新现有模板。