注释
该工具默认可在以下 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 | 必需 |
|---|---|---|
incidentId、caseNumber |
incidentId (GUID)或 caseNumber (例如 CAS-01010-A0A0A0)。 至少需要一个。 当 caseNumber 提供 后,服务器会将其解析为 GUID。 |
是的 |
优先级捷径
| 输入 | Description | 必需 |
|---|---|---|
priority、high、normal、low |
priority (枚举: high, normal, low)。 方便参数用于最常见的字段更新。 |
否 |
任意域
| 输入 | 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中更新案件记录中的一个或多个字段。 该操作是幂等的——使用相同输入调用,结果相同。