列表/搜索邮件

适用于：Dynamics 365 Customer Service 和 Dynamics 365 Sales

注释

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

当你想查找特定邮箱或浏览案件中的近期邮件或邮箱时，可以使用此功能。

它的作用是什么

助手会按主题、发件人或日期范围搜索您的Dynamics 365邮件。 它会自动将回复链归为一组，只显示每个线程中最新的邮件。 如果只有一封邮件匹配，它会直接打开完整的邮件视图。 如果多封邮件匹配，你会看到一个选择列表，可以选择打开哪一封。

你也可以将搜索范围锁定到特定案件，只看到与该案件相关的邮件。

试试像这样的提示

  • 给我看看关于登录失败的邮件。
  • 找到莎拉的邮件。
  • 列出本案的电子邮件。
  • 显示最近的邮件。
  • 查找带有主旨的“账单查询”邮件。
  • 展示客户的邮件。
  • 看看我的收件箱。
  • 展示上周的邮件。

你在聊天中会看到的内容

如果有一封邮件匹配，助理会直接以邮件视图打开。 如果多封邮件匹配，助手会显示一个包含邮件主题、发件人和日期的选择网格。 从列表中选择一封邮件查看其完整内容。

有用的提示

  • 即使邮件带有“RE：”或“FWD：”前缀，主题搜索仍能实现——这些前缀会自动剔除。
  • 说“本案邮件”，只显示与当前案件相关的邮件。
  • 如果你在寻找特定邮件并出现多个结果，可以通过添加更多细节，比如发送人或日期范围来缩小搜索范围。
  • 没有搜索条件时，你会看到最近的10封邮件。

Tip

在列表中找到一封邮件后，选择它查看完整内容。 然后你可以回复、转发或链接到案件中。

接下来会发生什么

找到邮件后，你可以继续使用以下提示：

  • 打开第一封邮件。
  • 查看莎拉的邮件。
  • 回复那封邮件。
  • 把这封邮件和案件联系起来。
  • 从这封邮件创建案件。

这会改变数据吗？

不，搜索邮件不会改变数据。

这只用于搜索和显示电子邮件数据。 你在发现邮件后采取的操作（回复、转发、链接）可能会改变数据。

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

在聊天邮件列表中，你可以：

  • 浏览邮件内容，包含主题、发件人、日期和方向（入站/发件）。
  • 选择电子邮件，在邮件查看器中阅读其完整内容。
  • 在Dynamics 365中打开邮件。
  • 使用跟进提示按日期、发件人或关联案件的邮件进行筛选。

先决条件

该工具需要以下条件：

  • Email

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

工具摘要

资产 价值
面向用户的名称 列表/搜索邮件
内部工具名称 list_emails
Purpose 按主题或发件人搜索Dynamics 365邮件活动，并实现自动回复链重复删除

工具行为

通过自动回复链重复处理，按主题或发件人搜索 Dynamics 365 邮件活动。 回复：/FWD：前缀被剔除，保留每个线程最新的邮件。 单匹配直接返回完整 view_email 控件;多匹配返回选择网格以便消歧。 没有任何筛选，返回最近的10封邮件。

Annotations

注释 价值 Meaning
readOnlyHint true 这个工具不会修改数据。
destructiveHint 未设置 不适用（只读工具）。
idempotentHint 未设置 不适用（只读工具）。
openWorldHint 未设置 使用默认值（查询Dataverse）。

输入概念

输入 Description 必需
subject subject （部分、不区分大小写的匹配——RE：/FWD：前置会自动去除）。 否

发送器过滤器

输入 Description 必需
from from （发件人显示姓名或电子邮件地址部分匹配）。 否

记录范围

输入 Description 必需
entityId、entityType、incident entityId （案例或记录的GUID用于将结果范围）， entityType （实体逻辑名称，默认为 incident）。 每当用户询问具体案件的邮件时，都选择跳过 entityId 。 否

结果限制

输入 Description 必需
top top （去重后返回的最大唯一邮件线程数，默认为10个。） 否

日期范围

输入 Description 必需
dateFrom、dateTo dateFrom 以及 dateTo （ISO 8601日期以限制时间窗口）。 否

响应与用户界面行为

该工具可以渲染交互式邮件选择网格或单一邮件视图。

该 MCP 工具由 MCP 应用支持。

响应类型

交互组件（聊天应用）

单场比赛：直接返回完整 view_email 小部件。 多匹配：返回一个选择网格——等待用户选择后，再用所选的 activityID 呼叫 view_email 。 无结果：返回空状态。

路由注释

用于 list_emails ：

  • 给我看[person]的邮件，查找关于[topic]的邮件。
  • 任何时候你需要邮箱但没有activityID时都可以。
  • 搜索发送和收到的邮件。
  • 通过 entityId针对具体案例进行范围范围的电子邮件搜索。

不要在以下情况下使用 list_emails ：

  • 用户已经有一个 activityId，想要读取——使用 view_email。
  • 用户希望看到完整的活动时间线（而不仅仅是电子邮件）——请使用 get_activity_timeline。
工具 关系
view_email 通过 activityID 打开特定的邮件（在从网格中选择后调用）
draft_email 写一封新邮件
get_activity_timeline 记录上显示所有活动类型，而不仅仅是邮件
link_email_to_case 通过搜索找到的邮件链接到案件
create_case_from_email 从发现邮件创建案件

数据变异分类

只读。

该工具仅用于搜索和显示电子邮件数据。 未修改任何数据。

  • 上次更新时间为