适用于：Dynamics 365 Customer Service 和 Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想直接从聊天中更改任何Dataverse记录的字段值时，可以使用这个功能。
它的作用是什么
助理会更新你指定的记录中的一个或多个字段。 这适用于任何实体类型，包括账户、联系人、机会、线索和自定义表。 你告诉助手要更新哪个记录和哪些字段，它会直接在 Dynamics 365 中应用更新。
针对具体案件更新，助理使用专门的案例更新工具，验证更丰富。 该工具是所有其他实体类型的通用备用工具。
试试像这样的提示
- 更新Contoso账户上的电话号码。
- 把Jordan的职位改成高级工程师。
- 将该机会的预估收入设为50000。
- 更新此联系人的电子邮件地址。
- 将该线索的状态更改为合格。
- 在此记录中设置描述字段。
你在聊天中会看到的内容
助手会在聊天中以交互式表单的形式显示更新后的记录，显示更新应用后的字段。
有用的提示
- 具体说明要更改哪个字段以及新值应该是多少。
- 助理在申请更新前会先确认。
- 你可以在一次请求中更新多个字段，比如“把手机改成555-0100，城市改为西雅图”。
- 关于案件更新，只需自然描述变化。 助理选对工具。
Tip
更新应用后，助理会显示更新后的记录，方便你核实变更。
接下来会发生什么
更新应用后，你可以继续使用以下提示：
- 再把这份记录放一遍。
- 更新另一个字段。
- 列出该实体类型的记录。
- 在 Dynamics 365 中打开此记录。
这会改变数据吗？
是的，这会更新Dataverse的记录数据。
助理会直接将字段变更应用到Dataverse记录中。 助理在做修改前会先确认。
你可以通过聊天应用组件做些什么
通过聊天更新后的记录表单，你可以：
- 确认更新是否正确应用。
- 查看记录当前字段值。
- 在聊天中继续使用后续提示处理记录。
先决条件
该工具适用于本页顶部“申请”栏中列出的产品。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 更新实体记录 |
| 内部工具名称 | update_entity_record |
| Purpose | 通过 GUID 更新任何 Dataverse 实体记录上的一个或多个字段 |
工具行为
通过 GUID 更新任何 Dataverse 实体记录中的一个或多个字段。 当领域特定的更新工具（如 update_case）无法覆盖请求的字段或实体，或者实体没有专用的更新工具时，可以使用该工具。 适用于账户、联系人、机会、潜在客户、自定义表以及任何其他Dataverse实体。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
该工具会修改数据。 |
destructiveHint |
false |
该工具无需强制删除即可更新数据。 |
idempotentHint |
true |
重复呼叫且输入相同，最终效果相同。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
实体类型
| 输入 | Description | 必需 |
|---|---|---|
entityLogicalName |
entityLogicalName （字符串，必填）。 Dataverse实体的逻辑名称（例如， account， contact， opportunity）。 |
是的 |
记录标识符
| 输入 | Description | 必需 |
|---|---|---|
recordId |
recordId （字符串，必填）。 记录 GUID 更新。 |
是的 |
现场更新
| 输入 | Description | 必需 |
|---|---|---|
fields |
fields （关键值映射，必修）。 场逻辑名称映射到新值。 示例：{ "telephone1": "555-0100", "jobtitle": "Senior Engineer" }。 |
是的 |
响应与用户界面行为
该工具会在聊天中生成一个互动式应用表单，显示更新后的记录。
该 MCP 工具由 MCP 应用支持。
响应类型
交互式表单（详细视图）
更新应用后，表单显示记录。
路由注释
用于 update_entity_record ：
- 无需专用更新工具即可更新任何实体类型的字段。
- 更新域特定更新工具未覆盖的字段。
不要在以下情况下使用 update_entity_record ：
-
更新案例字段——优先
update_case针对案例特定字段。 -
删除记录——路径访问
delete_entity_record。
相关工具
| 工具 | 关系 |
|---|---|
get_entity_record |
在更新前后查看记录 |
get_account |
查看账户记录，更新前后 |
get_contact |
查看更新前后联系人记录 |
delete_entity_record |
删除记录而不是更新 |
update_case |
专用案件更新工具，具备案件特定逻辑 |
数据变异分类
写操作（非破坏性，幂零）。
该工具会修改数据。 更新直接应用到Dataverse记录。 该运算是幂零的;同一输入的重复调用会产生相同的结果。