显示邮件模板

适用于：Dynamics 365 Customer Service

注释

  • 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
  • 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
  • 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。

利用此功能查找保存的邮件模板，并打开一个以便审核或编辑。

它的作用是什么

助手可以搜索模板标题和主题，按模板类型筛选，或在已知 ID 时直接打开模板。 如果你没有提供筛选，它会列出最近修改的200个模板。

匹配后会以编辑表单打开模板。 多个匹配会出现在分页列表中，且没有匹配会生成文本回复，以便你进一步细化搜索。

试试像这样的提示

  • 给我看看案件结案模板。
  • 查找包含升级主题的模板。
  • 显示所有电子邮件模板。
  • 展示案例模板。
  • 打开带有ID 0000000-0000-0000-0000-0000-0000000000的邮件模板。

你在聊天中会看到的内容

助手要么显示匹配模板列表，要么在编辑表单中打开单一模板，或者解释没有匹配的模板。

你可以通过聊天应用组件做些什么

  • 查看模板标题、分类、语言和修改后的日期。
  • 浏览结果页面。
  • 选择模板以打开其编辑表单。

有用的提示

  • 搜索词与模板标题和主题都匹配。
  • 当搜索结果过多时，按模板类型筛选。
  • 当你已经知道要打开的具体模板时，使用模板ID。

接下来会发生什么

  • 在编辑表单中更新所选模板。
  • 把模板应用到邮件上。
  • 创建一个新的电子邮件模板。

这会改变数据吗？

不，这不会改变数据。

打开或搜索模板是只读的。 从编辑表单保存更改时，会使用 save_email_template，该模板会更新所选模板。

先决条件

该工具需要对电子邮件模板的阅读权限。

在 配置电子邮件中了解详细信息。

工具摘要

资产 价值
面向用户的名称 显示邮件模板
内部工具名称 show_email_template
Purpose 查找已保存的电子邮件模板，并打开选定模板进行审核或编辑

工具行为

搜索模板标题和主题，按 Dataverse 模板类型筛选，列出最新模板，或按 ID 加载模板。 它不会创建模板或保存编辑内容。

Annotations

注释 价值 Meaning
readOnlyHint true 这个工具不会修改数据。
destructiveHint 未设置 不适用，因为该工具是只读的。
idempotentHint 未设置 对只读请求使用默认行为。
openWorldHint 未设置 对Dataverse请求使用默认行为。

输入概念

模板选择

Input Description 必需
keywords 文本与模板标题或主题相匹配。 最大长度为 128 个字符。 否
templateId 特定模板的GUID。 提供后，工具跳过搜索，直接打开该模板。 否
templateTypeCode Dataverse模板类型的代码，例如112用于Case，1用于Account，2用于Contact，或8用于User。 否

响应与用户界面行为

该 MCP 工具由 MCP 应用支持。

响应类型

交互组件（聊天应用）

零匹配返回的文本没有应用聊天组件。 匹配结果或直接识别会打开编辑表单。 多重匹配会生成一个包含10个模板的列表，每页。

路由注释

用户想要时使用 show_email_template ：

  • 按标题或主题查找模板。
  • 列出所有模板或针对特定Dataverse实体类型的模板。
  • 用ID打开一个已知模板。

用户想用时不要使用 show_email_template ：

  • 创建一个新模板——使用 create_email_template。
  • 将模板应用到邮件中——使用 apply_email_template。
工具 关系
edit_email_template 将已知模板加载到编辑表单中
create_email_template 打开一个空白表单以获取新模板
save_email_template 保存编辑表单中所做的更改
apply_email_template 将现有模板应用到邮件中

数据变异分类

只读。

数据只有在用户通过 保存打开的模板 save_email_template时才会发生变化。

  • 上次更新时间为