适用于：Dynamics 365 Customer Service 和 Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当您想查看案件、账户或其他记录的完整互动历史时，可以使用此功能——包括电子邮件、电话、任务、笔记和约会记录。
它的作用是什么
助理会在记录上按时间顺序显示所有活动的动态。 你可以按活动类型筛选（例如仅邮件或仅任务）、关键词搜索、日期范围筛选，或按状态筛选（已开放、已完成、取消）。 默认情况下，最近的活动会先显示。
试试像这样的提示
- 请展示本案的时间线。
- 这个案子的活动历史如何？
- 给我看所有关于这个案子的邮件。
- 在此账户上列出最近的电话记录。
- 展示本案已完成的活动。
- 在时间线上搜索账单。
- 展示本案最早的活动。
- 上周这个案子发生了什么？
你在聊天中会看到的内容
助手作为聊天应用组件显示交互式活动时间线。 活动按时间顺序显示，配有类型图标、主题、日期和所有者。 你可以展开条目查看完整细节。
有用的提示
- 可以说“只显示邮件”或“只显示备忘录”，按活动类型筛选时间线。
- 使用日期筛选，比如说“显示上周的活动”。
- 时间线默认显示了最近的30项活动。 如果需要，可以要求更多。
- 如果想要快速的AI生成案件摘要，而不是原始时间线，可以说“总结此案”。
Tip
你可以直接从时间线上采取行动。 选择一封邮件阅读，或使用诸如“回复最后一封邮件”或“创建后续任务”等提示。
接下来会发生什么
时间线显示后，你可以继续使用以下提示：
- 打开最新的邮件。
- 根据最后一次电话创建任务。
- 总结一下本周发生的事情。
- 回复客户的邮件。
- 补充一下后续情况。
这会改变数据吗？
不，查看时间线不会改变数据。
时间线是只读的。 你从时间线中采取的操作（创建活动、回复邮件）可能会通过不同的工具改变数据。
你可以通过聊天应用组件做些什么
从聊天时间线中，你可以：
- 按时间顺序浏览活动。
- 按类型筛选（邮件、任务、笔记、电话、约会）。
- 扩展活动以查看其详细信息。
- 打开邮件阅读其完整内容。
- 直接从时间线创建新活动（任务、电话、笔记）。
- 在Dynamics 365中打开完整的记录表。
先决条件
该工具适用于本页顶部“申请”栏中列出的产品。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 活动时间线 |
| 内部工具名称 | get_activity_timeline |
| Purpose | 返回任何 Dynamics 365 记录的原始时间顺序邮件、任务、笔记、电话和约会信息流 |
工具行为
返回任何 Dynamics 365 记录的原始时间顺序邮件、任务、笔记、电话和约会信息。 支持按活动类型、州、日期范围、自由文本搜索和分页进行筛选。 当用户请求查看活动信息流、近期活动、历史记录或记录上的所有接触点时，使用该功能。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
记录上下文
| 输入 | Description | 必需 |
|---|---|---|
entityId、entityType、incident、account |
entityId （记录 GUID，必需）， entityType （实体逻辑名称如 incident 或 account）。 |
是的 |
Pagination
| 输入 | Description | 必需 |
|---|---|---|
top、skipActivities、skipAnnotations |
top （每种类型最大记录，默认为30）、 skipActivities （可跳过的活动数量）、 skipAnnotations （可跳过的注释数量）。 |
否 |
排序顺序
| 输入 | Description | 必需 |
|---|---|---|
sortOrder、newest、oldest |
sortOrder （newest 或 oldest—默认为 newest）。 |
否 |
类型筛选器
| 输入 | Description | 必需 |
|---|---|---|
typeFilter |
typeFilter （活动类型数组，例如，包括 ['email', 'task', 'note']）。 所有类型都省略。 |
否 |
状态筛选器
| 输入 | Description | 必需 |
|---|---|---|
stateFilter、open、completed、canceled、scheduled |
stateFilter （状态数组： open， completed， canceled， scheduled） 所有州都省略。 |
否 |
搜寻
| 输入 | Description | 必需 |
|---|---|---|
searchText |
searchText （跨主题、描述和所有者字段的自由文本搜索） |
否 |
日期范围
| 输入 | Description | 必需 |
|---|---|---|
dateFrom、dateTo |
包含上下界，作为 ISO 8601 日期2026-09-10（）或日期-时间，并明确标明时区（2026-09-10T14:30:00Z 或 2026-09-10T14:30:00-07:00）。 助理会将“上周”等短语解析到这些表单之一后，再呼叫工具。 |
否 |
高级
| 输入 | Description | 必需 |
|---|---|---|
additionalFilter |
additionalFilter （OData滤波条件与AND合并）。 |
否 |
响应与用户界面行为
该工具可以渲染一个互动式活动时间线。
该 MCP 工具由 MCP 应用支持。
响应类型
交互组件（聊天应用）
时间线小部件按时间顺序显示活动，包含类型图标、主题、日期和所有者。 用户可以展开条目查看详情，按类型筛选，并导航到各个活动。
路由注释
用于 get_activity_timeline ：
- 展示时间线、活动历史、近期活动以及本案发生了什么。
- 查看所有活动类型的完整时间顺序。
- 按类型、州或日期范围筛选。
不要在以下情况下使用 get_activity_timeline ：
- 用户希望案件表单带有预筛选的时间线标签（带有表单上下文）——请使用
get_case。 - 用户需要AI散文摘要——使用
summarize_case。 - 用户需要分诊信号——使用
get_case_highlights。 - 用户只想要电子邮件——用于
list_emails搜索或view_email特定邮箱。
相关工具
| 工具 | 关系 |
|---|---|
get_case |
打开带有内置时间线标签的案件表单 |
summarize_case |
AI生成的案例活动散文摘要 |
get_case_highlights |
活动消化与分诊信号 |
create_activity |
在时间线上创建一个新活动 |
create_note |
在时间线上创建一条备注 |
view_email |
打开时间线上的一封特定邮件 |
list_emails |
按主题或发件人搜索邮件 |
数据变异分类
只读。
该工具仅读取和显示时间线数据。 未修改任何数据。 时间线小部件的后续操作（创建活动、打开邮件）可能通过独立工具触发写入操作。