适用于：Dynamics 365 Customer Service
注意
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想在聊天中直接查看完整的案件表单及其所有字段、章节和时间线时，可以使用此功能——尤其是在准备编辑案件详情时。
它的作用是什么
助理会在聊天中打开一个互动式案件表单，与Dynamics 365案件布局相呼应。 表单显示所有按部分组织的案件字段（如案件详情、客户信息和SLA信息），并包含一个时间线标签，显示案件的活动历史。
这是对案例的“形式优先”观点。 当你需要查看具体字段值或准备更新箱子时，它最好。 对于案件的总体概述（带有AI生成的摘要），请使用“案例摘要”——助理在大多数“展示案例”提示时默认使用摘要视图。
试试像这样的提示
- 请显示CAS-01010-A0A0A0的案件表格。
- 打开本案的表单视图。
- 给我看看案件栏。
- 打开案件表单，这样我可以编辑。
- 请显示CAS-01010-A0A0A0案件的时间线。
- 本案的案件表格，时间线标签。
你在聊天中会看到的内容
助手以聊天应用组件的形式显示交互式案件表单。 表单显示案件的字段、部分和标签页（包括包含近期活动的时间线标签）。
有用的提示
- 如果你想要快速的AI生成概览，可以说“案例摘要”。 助理默认会将大多数“展示案件”或“打开案件”提示导向摘要视图。
- 当你需要查看具体字段值或计划编辑案件时，可以使用这个工具。
- 你可以直接跳转到时间线标签页，说“显示此案的时间线”。
- 在提示中按类型（邮件、任务、笔记）或日期范围筛选时间线活动。
- 你可以传递案件编号（比如CAS-01010-A0A0A0）或案件GUID。
接下来会发生什么
案件表单出现后，你可以继续使用以下提示：
- 将优先级更新为高。
- 把这个案子重新分配给亚历克斯。
- 请总结一下这个案子。
- 给客户写一封邮件。
- 自昨天以来，这个案子发生了什么变化？
- 结案。
这会改变数据吗？
不，查看案件表格不会改变数据。
该表单为唯读。 后续操作如更新字段、重新分配或关闭案件，可能会改变数据。 助理在做修改前会先确认。
你可以通过聊天应用组件做些什么
在聊天的案件表单中，你可以：
- 查看按表单部分整理的所有案件字段。
- 在表单标签页（详情、时间线等）之间切换。
- 浏览活动时间线，并设置活动类型、州和日期范围的筛选条件。
- 在Dynamics 365中打开完整的案件记录。
- 使用后续提示更新字段或对案件采取行动。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 案例详细信息 |
| 内部工具名称 | get_case |
| Purpose | 打开案件表单小部件，显示Dataverse布局，包含部分、字段、时间线和SLA关键绩效指标（SLA） |
工具行为
打开案件表单小部件，显示Dataverse布局，包含部分、字段、时间线和SLA关键绩效指标。 两种摘要模式： deferSummary: true 提供摘要标签页，只有在打开该标签时AI摘要才加载，这样表单不会因为你可能永远看不到的摘要而延迟; includeSummary: true 提前生成摘要并在回复中返回，这正是不渲染小部件的呼叫者所需要的。 用于“展示CAS-X”、“打开/查看CAS-X案例”、“获取/展示CAS-X的案例详情”、“告诉我关于CAS-X的情况”，或任何一般的分类或编辑前奏意图。 只有在案件摘要启用时才传递摘要标志。check_summary_enabled 如果是专门的AI摘要意图（“总结CAS-X”、“回顾CAS-X”），可以改用 summarize_case ——该工具会先生成摘要并直接显示。 仅按时间顺序的活动源请使用 get_activity_timeline。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
true |
这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
大小写标识符
| 输入 | Description | 必需 |
|---|---|---|
incidentId、caseNumber |
incidentId （GUID）或 caseNumber （例如，CAS-01010-A0A0A0）。 至少需要一个。 当 caseNumber 提供 后，服务器通过精确匹配和模糊匹配将其解析为 GUID。 |
是的 |
形式选择
| 输入 | Description | 必需 |
|---|---|---|
formId |
formId （GUID）。 Optional. 选择特定的系统形式;默认使用主要形式。 |
否 |
初始标签页
| 输入 | Description | 必需 |
|---|---|---|
initialActiveTab |
initialActiveTab （字符串）。 设置小部件打开时哪个标签页是激活的。 |
否 |
时间线过滤器
| 输入 | Description | 必需 |
|---|---|---|
typeFilter、stateFilter、searchText、dateFrom、dateTo |
typeFilter（字符串数组）， stateFilter （字符串数组）， searchText， dateFromdateTo Optional. 预筛选嵌入的时间线标签页。日期界限接受带有明确时区（2026-09-10T14:30:00Z， 2026-09-10T14:30:00+05:30， 的 ISO 8601日期2026-09-10）或日期时间。 在打电话前，将“昨天”或“上周”等相关短语归入这些表格之一。 |
否 |
AI 摘要
| 输入 | Description | 必需 |
|---|---|---|
includeSummary |
includeSummary （布尔值）。 当 true时，生成 AI 摘要并在回复中返回。 每次都要打LLM电话。 需要摘要文本时使用。 |
否 |
deferSummary |
deferSummary （布尔值）。 当 true时，会显示摘要标签页，且其 AI 摘要是在你打开该标签页时获取的——而不是在表单加载时。 只有当标签页被打开时，才会花费一次LLM调用。 如果两个旗帜都被通过，则优先。 |
否 |
响应与用户界面行为
该 MCP 工具由 MCP 应用支持。
响应类型
互动式案件表单（聊天应用）
路由注释
在以下情况下使用 get_case：
- 用户会说“展示案例”、“开放案例”、“查看案例”、“获取案件详情”、“告诉我关于CAS-X的情况”（一般分类或查看意图）。
- 用户即将编辑案件（前奏）。
update_case - 用户明确要求仅表单访问：“只需显示表单”、“仅限案例字段”。
- 一旦回复
caseSummaryEnabled: true，Pass（或includeSummary: true需要回复中的总结时）check_summary_enabled就通过deferSummary: true。
不要在以下情况下使用 get_case ：
- 用户请求 专用的AI摘要 （“总结CAS-X”、“回顾CAS-X”、“简要介绍CAS-X”）——路径访问
summarize_case。 - 用户只想要活动流——路由到
get_activity_timeline。 - 用户需要分诊信号——路由到
get_case_highlights。
相关工具
| 工具 | 关系 |
|---|---|
summarize_case |
生成一个AI摘要，默认以摘要标签为降落点。 用于专门的摘要意图（“总结CAS-X”、“回顾CAS-X”） |
update_case |
案件的字段更新。
get_case作为编辑前检查的前奏 |
get_case_highlights |
返回结构化的分诊信号（SLA风险、升级、活动计数） |
get_activity_timeline |
返回该案件的原始时间顺序活动信息流 |
get_case_sla_status |
返回案件的SLA KPI详细信息 |
close_case |
结案并结案 |
数据变异分类
只读入口，带有下游突变潜力。
表单本身不会改变数据。 表单中的后续操作（更新、重新分配、关闭）可以通过不同的工具触发写入操作。