更新案例

注释

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

当你想更改支持案件中的字段,比如优先级、标题、描述或其他细节时,可以使用此功能。

它的作用是什么

助理会更新案件记录中的一个或多个字段。 你可以用普通语言更改优先级,或者通过指定想更改的内容来更新其他案件字段。 助理会确认哪些字段在应用更改后被更新。

试试像这样的提示

  • “将CAS-01010-A0A0A0的优先级设为高”
  • “将本案标题改为登录问题”
  • “更新这个案子的描述”
  • “优先级调低”
  • “此案标记为等待细节”
  • “更改案件中的客户 CAS-01010-A0A0A0”

你在聊天中看到的内容

助理通过文本回复确认了更新,列出了更改的字段。 此操作不显示交互组件。

有用的提示

  • 你可以用案件编号来称呼案件(例如CAS-01010-A0A0A0),或者让助理使用你已经在处理的案件。
  • 优先级更改时,请使用“高”、“普通”或“低”。
  • 你可以在一次请求中更新多个字段。
  • 如果你想关闭一个案件,可以用“关闭此案件”——这是一个带有解决记录的独立操作。

Tip

先打开案件,写上“show me case CAS-01010-A0A0A0”,查看当前字段后再更新。

接下来会发生什么

更新后,你可以继续使用以下提示:

  • “给我看看这个箱子”
  • “总结一下这个案子”
  • “这个案子的服务等级(SLA)状态如何?”
  • “把这个案子重新分配给亚历克斯”

这会改变数据吗?

是的。 这改变了数据。

案件记录在Dynamics 365中更新。 此更改会立即生效。

先决条件

该工具需要以下条件:

  • 客户服务代表角色

工具摘要

资产 价值
面向用户的名称 更新案例
内部工具名称 update_case
Purpose 更新支持案例中的一个或多个字段

工具行为

更新支持案件中的一个或多个字段。 支持用于常见字段如优先级的类型快捷方式,以及用于任意Dataverse逻辑名称到值更新的通用 fields 映射,包括标题、描述、客户和状态原因。

Annotations

注释 价值 Meaning
readOnlyHint false 该工具会修改数据。
destructiveHint false 更新是非破坏性的(字段被覆盖,而非删除)。
idempotentHint true 使用相同的输入调用会产生相同的结果。
openWorldHint 未设置 使用默认值(查询Dataverse)。

输入概念

大小写标识符

输入 Description 必需
incidentIdcaseNumber incidentId (GUID)或 caseNumber (例如 CAS-01010-A0A0A0)。 至少需要一个。 当 caseNumber 提供 后,服务器会将其解析为 GUID。 是的

优先级捷径

输入 Description 必需
priorityhighnormallow priority (枚举: highnormallow)。 方便参数用于最常见的字段更新。

任意域

输入 Description 必需
fields fields (Dataverse 逻辑名称到值对的记录)。 表单小部件用于内联编辑单个字段,或任何未被快捷方式覆盖的字段。

响应与用户界面行为

该 MCP 工具由 MCP 应用支持。

响应类型

短信确认

工具会返回更新字段的文本确认。 没有渲染任何交互组件。

路由注释

用于 update_case

  • 案件记录中的任何字段更改(优先级、标题、描述、状态原因、自定义字段)
  • 从案件表单小部件进行内联编辑

不要在以下情况下使用 update_case

  • 关闭/解决案件 ——路由( close_case 使用Dataverse CloseIncident操作)
  • 重新分配案件 ——路由( reassign_case 处理所有权转移和交接记录)
  • 更新非案件实体 - 路由 update_entity_record
工具 关系
get_case 在编辑前打开案件表格进行检查
close_case 解决并关闭案件(使用CloseIncident,而非字段更新)
reassign_case 将案件重新分配给其他用户、团队或队列
list_cases 列出案例以查找需要更新的案例
summarize_case 在编辑前用AI摘要开案

数据变异分类

写作/变异。

在Dataverse中更新案件记录中的一个或多个字段。 该操作是幂等的——使用相同输入调用,结果相同。