适用于：Dynamics 365 Customer Service
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想更改支持案件中的字段，比如优先级、标题、描述或其他细节时，可以使用此功能。
它的作用是什么
助理会更新案件记录中的一个或多个字段。 你可以用普通语言更改优先级，按姓名更改客户或其他相关记录，或者通过指定想更改的内容来更新其他案件字段。 助理会确认哪些字段在应用更改后被更新。
试试像这样的提示
- 将CAS-01010-A0A0A0的优先级设为高。
- 请将此案件标题改为登录问题。
- 更新这个案例的描述。
- 优先级设为低。
- 将此案标记为等待细节。
- 将案件中的客户 CAS-01010-A0A0A0 更改为 Contoso Ltd。
你在聊天中会看到的内容
助理通过文本回复确认了更新，列出了更改的字段。 此操作不显示交互组件。
如果你说出客户或其他相关记录，且有多个记录匹配，助理会列出匹配并询问你指的是哪一个。 如果没有匹配，它会告诉你，而不是报告一个根本没发生的变更。
有用的提示
- 你可以用案件编号来称呼案件（例如CAS-01010-A0A0A0），或者让助理使用你已经在处理的案件。
- 优先级更改时，请使用“高”、“普通”或“低”。
- 你可以在一次请求中更新多个字段。
- 更换客户时，请提供账户或联系人名称（例如，“Contoso Ltd”）。 如果名字有歧义，助理会让你选择。
- 如果你想关闭案件，可以用“关闭此案件”——这是一个带有解决记录的独立操作。
Tip
先打开案件，写上“show me case CAS-01010-A0A0A0”，查看当前字段后再更新。
接下来会发生什么
更新后，你可以继续使用以下提示：
- 给我看看这个箱子。
- 请总结一下这个案子。
- 这个案子的SLA状态如何？
- 把这个案子重新分配给亚历克斯。
这会改变数据吗？
是的，这会改变数据。
案件记录在Dynamics 365中更新。 此更改会立即生效。
先决条件
该工具需要以下条件：
- 客户服务代表职位。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 更新案例 |
| 内部工具名称 | update_case |
| Purpose | 更新支持案例中的一个或多个字段 |
工具行为
更新支持案件中的一个或多个字段。 支持用于常见字段如优先级的类型快捷方式，用于 fields 标量Dataverse列（如标题、描述和状态原因）的映射，以及 lookups 用于关系字段（如客户、所有者、联系人和主题）的映射。 关系字段的名称在应用更新前会被解析为记录，因此不匹配或多个记录匹配的名称会被报告回来，而不是写入。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
false |
更新是非破坏性的（字段被覆盖，而非删除）。 |
idempotentHint |
true |
使用相同的输入调用会产生相同的结果。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
大小写标识符
| 输入 | Description | 必需 |
|---|---|---|
incidentId、caseNumber |
incidentId （GUID）或 caseNumber （例如，CAS-01010-A0A0A0）。 至少需要一个。 当 caseNumber 提供 后，服务器会将其解析为 GUID。 |
是的 |
优先级捷径
| 输入 | Description | 必需 |
|---|---|---|
priority、high、normal、low |
priority （枚举： high， normal， low）。 方便参数用于最常见的字段更新。 |
否 |
任意域
| 输入 | Description | 必需 |
|---|---|---|
fields |
fields （Dataverse 逻辑名称到值对的记录）。 仅限标量列——标题、描述、状态原因、案件类型和自定义列。 表单小部件用于内联编辑，或用于快捷键未覆盖的任何标量字段。 发送到这里的查询会自动被重定向到关系路径。 |
否 |
关系场
| 输入 | Description | 必需 |
|---|---|---|
lookups |
lookups （查找记录-逻辑名到记录名称或GUID）。 用于关系域，如 customerid、 primarycontactid和 subjectid——例如 {"customerid": "Contoso Ltd"}。 服务器将名称解析为记录并链接。 这是更改查询的官方支持方式。 |
否 |
响应与用户界面行为
该 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中更新案件记录中的一个或多个字段。 该操作是幂等式的——使用相同输入调用会产生相同的结果。