适用于：Dynamics 365 Customer Service 和 Dynamics 365 Sales
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想浏览任何没有专属列表命令的Dataverse实体类型的记录时，可以使用此功能，比如机会、线索、队列项目或自定义表。
它的作用是什么
助理会显示您指定的实体类型的记录列表。 你可以按姓名搜索并限制结果数量。 这是一个通用的记录列表工具，适用于你Dynamics 365环境中的任何实体类型。
对于账户、联系人和案件，助理使用专门工具，提供更丰富的筛选功能。 这个工具是其他所有工具的备选方案。
试试像这样的提示
- 显示所有队列项目。
- 列出机会。
- 名单线索。
- 显示我的自定义实体记录。
- 浏览开放的机会。
- 列出所有预约。
- 展示任务记录。
你在聊天中会看到的内容
助手作为聊天应用组件显示交互式记录列表。 列表显示匹配记录及其主名称和密钥列。
有用的提示
- 你需要指定实体类型，比如“列出机会”或“展示潜在客户”。
- 使用名称搜索特定记录，例如“List for Project Alpha”。
- 对于账户，建议写“列表账户”。 联系人方面，写“联系人列表”。对于案例，可以说“列出案例”。
- 最多可获得200个结果。
Tip
记录列表显示后，你可以对任何显示的记录提出后续问题。 例如，“打开第一条记录”或“更新此记录”。
接下来会发生什么
列表出现后，你可以继续使用以下提示：
- 打开第一个唱片。
- 查看本唱片的详细信息。
- 更新本记录中的字段。
- 删除这条记录。
这会改变数据吗？
不，列出记录不会改变数据。
记录列表为只读。 列表中的后续操作，如更新或删除记录，可能会改变数据。 助理在做修改前会先确认。
你可以通过聊天应用组件做些什么
从聊天记录列表中，你可以：
- 扫描并查看可排序网格中的匹配记录。
- 选择记录以查看更多详情。
- 在Dynamics 365中打开完整的记录表。
- 在聊天中继续使用后续提示处理记录。
先决条件
该工具适用于本页顶部“申请”栏中列出的产品。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 列出实体记录 |
| 内部工具名称 | list_entity_records |
| Purpose | 检索任何Dataverse实体的记录，存储在可排序、可过滤的网格中 |
工具行为
检索可排序、可过滤网格中任意Dataverse实体的记录。 用于没有专用列表工具的实体类型，如机会、潜在客户、队列项目或自定义表。 对于核心实体类型（账户、联系人、案件、知识），请使用命名列表工具。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
未设置 | 实际操作中只读;这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值（查询Dataverse）。 |
输入概念
实体类型
| 输入 | Description | 必需 |
|---|---|---|
entityLogicalName |
entityLogicalName （字符串，必填）。 Dataverse实体的逻辑名称（例如， opportunity， lead， queueitem）。 |
是的 |
搜寻
| 输入 | Description | 必需 |
|---|---|---|
search |
search （字符串，可选）。 在实体的主要名称属性上进行自由文本搜索。 |
否 |
结果限制
| 输入 | Description | 必需 |
|---|---|---|
top |
top （整数，可选）。 最多纪录将返回。 默认为组织页面大小设置（除非管理员更改为25），最多200页。 |
否 |
响应与用户界面行为
该工具渲染一个交互式的聊天应用实体网格。
该 MCP 工具由 MCP 应用支持。
响应类型
交互式网格（列表视图）
网格显示记录及其主名称和键列。 用户可以选择一行，通过 钻孔到记录细节 get_entity_record。
路由注释
用于 list_entity_records ：
- 任何没有专用列表工具的实体类型（机会、线索、队列项目、自定义表）。
- 列表中[实体类型]，其中[实体类型]不是账户、联系人、案件、知识或评估。
当 list_entity_records 提示明确写着：
-
账户——路由至
list_accounts。 -
联系人——路由至
list_contacts。 -
案例——路由到
list_cases。 -
知识文章——路径指向
search_knowledge_articles。 -
评估——路径至
list_evaluations。 -
跨实体的自由文本搜索——路由到
search_entities。 -
单条记录的表单视图——路径 。
get_entity_record
相关工具
| 工具 | 关系 |
|---|---|
get_entity_record |
打开网格中单条记录的表单视图 |
update_entity_record |
更新任何实体记录上的字段 |
delete_entity_record |
删除任何实体记录 |
search_entities |
跨实体类型的自由文本搜索 |
list_accounts |
专用账户列表，带有账户特定筛选功能 |
list_contacts |
专用联系人列表，带有联系人专用筛选 |
list_cases |
专用案件列表，带有特定案例筛选 |
数据变异分类
只读入口，带有下游突变潜力。
房源本身不会改变数据。 网格的后续操作（更新、删除）可以通过不同的工具触发写入操作。