查找和管理案件

注释

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

当你想查找支持案件、在聊天中审核并采取行动而不离开对话时，可以使用这个功能。

它的作用是什么

助手会显示与你筛选条件匹配的案件列表。 您可以通过以下方法进行筛选：

  • 无论案件是否分配给你
  • 案件状态（活跃、已解决、取消、进行中、等待、等待、研究中）
  • 优先级（高、普通、低）
  • 案例编号
  • 案件标题中的关键词

结果会显示在聊天中的互动病例列表中。

试试像这样的提示

  • “展示我在办的案件”
  • “列出我的高优先级案件”
  • “查找CAS-01010-A0A0A0”
  • “展示已解决的案件”
  • “列出分配给我的案件”
  • “等待案件”
  • “查找关于账单的案件”
  • “我需要处理哪些案件？”

你在聊天中看到的内容

助手作为聊天应用组件显示交互式案件列表。 该列表显示匹配案件，并包含案件编号、标题、状态和优先级等关键细节。

有用的提示

  • 说“我的案件”或“分配给我”，这样只显示你拥有的案件。
  • 使用确切的案件编号（例如，CAS-01010-A0A0A0）以获得最精确的结果。
  • 通过说“显示我的高优先级活跃案件”来组合筛选条件。
  • 使用状态词，比如“活跃”、“已解决”、“取消”、“进行中”、“等待”、“等待”或“研究”。
  • 如果你特别想要个人工作队列，可以说“显示我的收件箱”或“显示我的工作项目”。 那是用不同的视角。

Tip

案件列表显示后，您可以对任何展示的案件提出后续问题。 例如，“总结第一个案例”或“重新分配案例CAS-01010-A0A0A0”。

接下来会发生什么

列表出现后，你可以继续使用以下提示：

  • “打开第一个箱子”
  • “总结一下这个案子”
  • “这个案子自昨天以来发生了什么变化？”
  • “把这个案子重新分配给亚历克斯”
  • “结案”
  • “为此案起草一份客户回复”

这会改变数据吗？

否。 列出案例不会改变数据。

案件列表为只读。 从列表中进行的后续操作，如更新字段或重新分配案件，可能会改变数据。 助理在做修改前会先确认。

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

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

  • 扫描并审查匹配案件，排列可排序网格
  • 选择案件查看更多详情
  • 在Dynamics 365中打开完整的案件表单
  • 在有支持字段时更新内联
  • 在聊天中继续处理案件，并使用后续提示

先决条件

该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。

工具摘要

资产 价值
面向用户的名称 查找和管理案件
内部工具名称 list_cases
Purpose 列表支持按状态、优先级、所有者或结构化标准过滤的案例，并以互动式网格式的聊天应用体验呈现

工具行为

列表支持按状态、优先级、所有者或结构化标准筛选的案例，并以互动式网格式的聊天应用体验呈现。 该 search 参数支持精确案件编号查询（CAS-XXXXX-XXXXX）或标题包含匹配。

Annotations

注释 价值 Meaning
readOnlyHint 未设置 实际操作中只读;该工具不会修改数据。
destructiveHint 未设置 不适用（只读工具）。
idempotentHint 未设置 不适用（只读工具）。
openWorldHint 未设置 使用默认值（查询Dataverse）。

输入概念

地位

输入 Description 必需
active、resolved、cancelled、in-progress、on-hold、waiting、researching active， resolved， cancelled， in-progress， on-hold， waiting， ， 。 researching 按案件状态或状态原因筛选。 否

Priority

输入 Description 必需
high、normal、low high，normal. low 不区分大小写。 否
输入 Description 必需
— 自由文本字符串。 执行精确案号查询（CAS-XXXXX-XXXXX）或标题包含匹配。 否

所有权范围

输入 Description 必需
assignedToMe assignedToMe （布尔值）。 当为真时，范围会针对当前用户拥有的案件。 否

结果限制

输入 Description 必需
top top （整数）。 最多可返回的病例数。 默认值为 10。 否

其他筛选器

输入 Description 必需
additionalFilter additionalFilter （键值映射）。 任意的OData滤波条件与AND合并。 否

响应与用户界面行为

该工具渲染一个互动式的聊天应用中案件网格。

该 MCP 工具由 MCP 应用支持。

响应类型

交互式网格（列表视图）

网格显示案件编号、标题、状态、优先级和所有者。 用户可以选择一行深入案件细节或通过聊天进行后续处理。

路由注释

用于 list_cases ：

  • “我的案件”、“分配给我的案件”、“我的正在处理案件”
  • “我需要处理哪些案件？”
  • 基于类别、状态或优先级的过滤
  • 精确案件号查询
  • 基于标题的关键词搜索

当 list_cases 提示明确写着：

  • “收件箱” 或 “工作项目” ——路由到 list_case_inbox_workitems
  • 跨标题和描述的自由文本搜索 ——路径 search_cases
工具 关系
get_case 为选定案件打开完整的案件表单
update_case 更新案件中的字段（优先级、状态等）
summarize_case 生成由人工智能驱动的案件摘要
get_case_highlights 返回活动消化和分流信号
reassign_case 将案件重新分配给其他用户、团队或队列
close_case 结案并结案
search_cases 跨案件标题和描述的自由文本搜索
list_case_inbox_workitems 返回代理人的个人活跃案件收件箱
summarize_case_actions 列出案件解决步骤

数据变异分类

只读入口，带有下游突变潜力。

房源本身不会改变数据。 网格中的后续操作，如更新、重新分配和关闭，可以通过使用不同的工具触发写入操作。

  • Last updated on