查看实体记录

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

注意

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

当你想查看任何没有独立视图命令的Dataverse实体类型特定记录的完整细节时，可以使用此功能。

它的作用是什么

助理会为你指定的记录打开一个详细的表单视图。 你可以查看所有记录字段，内联编辑支持字段，并在 Dynamics 365 中导航到完整表单。 这适用于任何实体类型，包括机会、潜在客户、队列项目和自定义表。

对于账户、联系人和案件，助理使用行为更丰富的专业工具。 这个工具是其他所有工具的备选方案。

试试像这样的提示

  • Contoso交易的机会开放。
  • 显示玛丽亚·加西亚的线索详情。
  • 查看队列项目记录。
  • 打开这个预约记录。
  • 给我看自定义实体记录。
  • 查看此任务。

你在聊天中会看到的内容

助手作为聊天应用组件显示交互式记录表单。 表单显示了记录的字段，按照Dynamics 365系统表单配置定义。

有用的提示

  • 你可以用记录名或 GUID 来打开特定的记录。
  • 你需要指定实体类型，例如“Project Alpha 的开放机会”。
  • 通过 columns 以包含记录表单上没有的字段（最多50个）。 您请求的非表单字段会在记录详情中显示。
  • 对于账户，建议写“开设Contoso账户”。 联系人请写“联系乔丹”。对于案件，可以说“开案 CAS-01010-A0A0A0”。

Tip

记录表单出现后，你可以提出诸如“更新此记录”或“删除此记录”等后续问题。

接下来会发生什么

记录表单出现后，你可以继续使用以下提示：

  • 更新本记录中的字段。
  • 删除这条记录。
  • 列出更多类似的记录。
  • 搜索相关记录。

这会改变数据吗？

不，查看记录不会改变数据。

记录表单默认为只读。 表单中的内联编辑可能会更改数据。 助理在做修改前会先确认。

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

在聊天记录表中，你可以：

  • 请查看所有记录表格字段。
  • 编辑支持字段内嵌。
  • 在Dynamics 365中打开完整的记录表。
  • 在聊天中继续使用后续提示处理记录。

先决条件

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

工具摘要

资产 价值
面向用户的名称 查看实体记录
内部工具名称 get_entity_record
Purpose 在表单驱动的详细视图中，通过内联编辑为任意Dataverse实体检索一条记录

工具行为

在表单驱动的详细视图中，带内联编辑，检索任意Dataverse实体的单条记录。 用于未被 get_account、 get_contact或 get_case保护的实体类型，如机会、潜在客户或自定义表。

Annotations

注释 价值 Meaning
readOnlyHint 未设置 实际操作中只读;这个工具不会直接修改数据。
destructiveHint 未设置 不适用（只读工具）。
idempotentHint 未设置 不适用（只读工具）。
openWorldHint 未设置 使用默认值（查询Dataverse）。

输入概念

实体类型

输入 Description 必需
entityLogicalName entityLogicalName （字符串，必填）。 Dataverse 实体的逻辑名称。 是的

记录标识符

输入 Description 必需
recordId recordId （字符串，必填）。 记录GUID或主名称以便搜索。 是的

形式选择

输入 Description 必需
formId formId （字符串，可选）。 一个用于渲染的系统形式 GUID。 否

其他字段

输入 Description 必需
columns columns （字符串数组，可选，最多50个）。 除了表单字段外，还需要包含额外的字段逻辑名称（例如 ["createdon", "industrycode"]）。 表单中没有的请求字段会投影到返回的表单中，使其值出现在回复中。 未知或无法读取的名字会被忽略。 请求查询、所有者和客户字段按其基础逻辑名称（例如 customerid，非 _customerid_value）进行查询;它们的值作为查找的显示名称返回。 否

响应与用户界面行为

该工具可以渲染一个互动式的聊天应用实体表单。

该 MCP 工具由 MCP 应用支持。

响应类型

交互式表单（详细视图）

表单显示记录中由所选系统表单定义的字段。

路由注释

用于 get_entity_record ：

  • 任何没有专门细节工具的实体类型。
  • 打开[实体类型] [名称]，显示[实体类型]详细信息。

当 get_entity_record 提示明确写着：

  • 账户——路由到 get_account。
  • 一个联系人——前往 get_contact的路径。
  • 一个案例——路径到 get_case。
  • “列表”记录——路由至 list_entity_records。
工具 关系
list_entity_records 列出同一实体类型的记录
update_entity_record 更新任何实体记录上的字段
delete_entity_record 删除任何实体记录
get_account 专用账户详情工具
get_contact 专用联系人详情工具
get_case 专用案件详细工具

数据变异分类

只读入口，带有下游突变潜力。

表单视图本身不会改变数据。 内联编辑触发写入操作。update_entity_record

  • 上次更新时间为