删除实体记录

适用于：Dynamics 365 Customer Service 和 Dynamics 365 Sales

注意

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

当您需要永久删除Dynamics 365中的记录时，可以使用此功能，比如备忘录、邮件、任务或其他实体。

它的作用是什么

助手会删除Dynamics 365中的特定记录。 这适用于任何实体类型，包括笔记、电子邮件、电话、任务、约会和自定义实体。 助理在删除前会先确认。

重要

这是一个硬删除操作。 没有撤消操作。 一旦记录被删除，就无法恢复。

试试像这样的提示

  • 删除这条笔记。
  • 删除邮件记录。
  • 删除通话记录。
  • 移除这个任务。
  • 删除预约。
  • 删除这条记录。

你在聊天中会看到的内容

助理在聊天中确认记录已被删除，并发送了确认消息。

有用的提示

  • 助理总是在删除前先确认。
  • 确认前一定要确认你的记录是正确的。 删除无法撤销。
  • 你必须在 Dynamics 365 中对实体类型拥有删除权限。
  • 如果你想停用记录而不是删除它，可以说“停用此记录”。

Tip

如果你不确定是否要删除，建议先通过“显示此记录”查看记录，以确认是否正确。

接下来会发生什么

记录删除后，你可以继续使用如下提示：

  • 列出该实体类型的记录。
  • 创建一个新笔记。
  • 拿出我的箱子。

这会改变数据吗？

是的，这会永久删除数据。

该记录会从 Dynamics 365 中移除，无法恢复。 助理在进行前请求确认。

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

删除后，组件显示确认。 删除记录中没有进一步处理。

先决条件

该工具适用于本页顶部“申请”栏中列出的产品。 这种方式无需任何其他配置。

工具摘要

资产 价值
面向用户的名称 删除实体记录
内部工具名称 delete_entity_record
Purpose 通过实体逻辑名称和记录ID删除Dataverse记录

工具行为

通过实体逻辑名和记录ID删除Dataverse记录。 仅适用于笔记（注释）和活动（电子邮件、电话、任务、约会、信件、传真、社交活动）——处理器会拒绝所有其他实体类型，包括自定义实体，并带有明确的允许列表错误。 这是一次硬删除，无法撤销。 用户必须对该记录的拥有实体拥有删除权限。

Annotations

注释 价值 Meaning
readOnlyHint false 该工具会修改数据。
destructiveHint true 该工具执行硬删除。
idempotentHint true 重复呼叫且输入相同，最终效果相同。
openWorldHint 未设置 使用默认值（查询Dataverse）。

输入概念

实体类型

输入 Description 必需
entityLogicalName entityLogicalName （字符串，必填）。 Dataverse实体的逻辑名称（例如，annotation，email，taskphonecall）。 appointment 是的

记录标识符

输入 Description 必需
recordId recordId （字符串，必填）。 记录 GUID 需要删除。 是的

响应与用户界面行为

该工具在应用聊天组件中提供确认。

该 MCP 工具由 MCP 应用支持。

响应类型

确认消息

回复确认记录已被删除。 删除的记录无法恢复。

路由注释

用于 delete_entity_record ：

  • 任何明确要求删除、删除或丢弃记录的提示。
  • 从网格或表单小部件进行内联删除操作。

不要在以下情况下使用 delete_entity_record ：

  • 关闭案件——路由至 close_case。
  • 停用记录——用于 update_entity_record 设置状态代码。
  • 更新或编辑——路由至 update_entity_record。
工具 关系
get_entity_record 删除前查看记录
update_entity_record 更新记录而不是删除
create_note 生成一个音符;删除会逆转此操作
create_activity 创建一项活动;删除会逆转此操作

数据变异分类

写操作（破坏性，幂零）。

该工具对Dataverse记录进行硬删除。 没有撤消操作。 该运算是幂零的;删除已删除的记录不会有额外影响。

  • 上次更新时间为