搜索实体记录

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

注释

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

当你想通过关键词、电话号码或电子邮件地址查找一个或多个实体类型的记录时，可以使用此功能——尤其是当你知道一个标识符但不知道它属于哪个记录时。

它的作用是什么

助理使用最佳的搜索方法搜索 Dynamics 365 记录。 如果你的环境中启用了相关性搜索，则会使用;否则助手会退回到子字符串匹配搜索。 结果的返回顺序是按照 Dynamics 365 提供的顺序——第一个结果不一定是最接近的。

你可以同时搜索多个实体类型——例如联系人和账户一起——这在电话号码或电子邮件地址可能属于其中一方时非常有用。 联系和账户结果通常包含职位名称、城市和状态等关键细节字段，因此你通常不需要打开记录来回答后续问题。 这些额外字段来自第二次查询，所以即使不成功，你仍然会得到匹配记录，只是没有匹配记录。

电话号码和电子邮件地址可以被搜索，但识别的电话和邮箱字段在任何实体类型的结果中都不会返回——“谁拥有这个号码”的答案是记录，而不是你已有的号码。 打开记录查看其存储的联系方式。 有两个狭窄的例外：组织命名的自定义列，但没有可识别的电话或邮箱根，仍可返回;少数自定义表使用地址或号码作为记录 名称，若有地址或号码，则报告为名称。

试试像这样的提示

  • 在我们的CRM记录中搜索电话号码555-0134。
  • 查找带有电子邮件地址 jordan@contoso.com的联系记录。
  • 在联系人和账户中搜索Contoso。
  • 哪个客户拥有这个邮箱地址 billing@fabrikam.com？
  • 查找与打印机问题相符的记录。
  • 查查网络中断的记录。

你在聊天中会看到的内容

助手会直接在聊天对话中显示匹配记录的文本列表。 每个结果显示记录名称和实体类型。 目前没有针对此功能的交互式小部件。

有用的提示

  • 你可以同时搜索多种实体类型，例如“搜索联系人和账户 for Contoso”。当电话号码或电子邮件地址可能属于其中任何一方时，这是最佳选择。
  • 当你的环境中启用相关性搜索时，电话号码会灵活匹配—— 5550134 即使记录存储 (555)-0134在 。 没有相关性搜索，输入存储的数字。
  • 按状态或所有者列出账户时，请使用“列表账户”。 当你还不知道想要哪种记录时，搜索会更好。
  • 要开一个你已经能命名的记录，可以说“开 Contoso 账户”。
  • 针对具体案件的搜索，请说“搜索案件”以获得更有针对性的体验。
  • 搜索文本限制为500个字符。
  • 助手会告诉你它是用了相关性搜索还是子字符串匹配。

Tip

搜索结果出现后，你可以提问“打开第一个结果”或“显示Contoso详情”等后续问题。

接下来会发生什么

搜索结果显示后，你可以继续使用以下提示：

  • 打开第一个结果。
  • 查看本唱片的详细信息。
  • 总结一下这个说法。
  • 再用不同关键词搜索。

这会改变数据吗？

不，搜索不会改变数据。

搜索为只读。 结果的后续操作，如更新或删除记录，可能会改变数据。

先决条件

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

工具摘要

资产 价值
面向用户的名称 搜索实体记录
内部工具名称 search_entities
Purpose 使用最佳可用搜索方法（启用时使用相关性搜索，或 OData 子字符串匹配备回）按关键词、电话号码或电子邮件地址搜索 Dataverse 记录

工具行为

通过关键词、电话号码或电子邮件地址使用最佳可用搜索方法（启用时使用相关性搜索，或 OData 子字符串匹配备回）搜索 Dataverse 记录。 支持任何实体类型和多种类型的调用。 电话和电子邮件列在所有实体类型的结果中被保留;如果记录的主名称本身就是该值，该名称仍可作为记录名称报告。 联系方式和账户结果通过第二次尽力查找而被精心整理的细节丰富——当该查询失败时，搜索结果会以未丰富状态返回，而非失败。 其他实体类型没有策划集，可能会携带所选后端提供的剩余字段。 这是一个纯文本工具，没有聊天中的应用小部件。

Annotations

注释 价值 Meaning
readOnlyHint true 这个工具不会修改数据。
destructiveHint 未设置 不适用（只读工具）。
idempotentHint 未设置 不适用（只读工具）。
openWorldHint 未设置 使用默认值（查询Dataverse）。

输入概念

实体范围（单一）

输入 Description 必需
entityLogicalName entityLogicalName （字符串，可选）。 单一实体类型用于搜索。 如果 entityLogicalNames 提供了，则忽略。 否

实体范围（多个）

输入 Description 必需
entityLogicalNames entityLogicalNames （字符串数组，可选）。 可以同时搜索多种实体类型。 优先于 entityLogicalName. 否

搜索文本

输入 Description 必需
searchText searchText （字符串，必填，最多500字符） 自然语言或关键词搜索查询。 是的

结果限制

输入 Description 必需
top top （整数，可选）。 各实体类型的最大结果。 默认为组织页面大小设置。 否

响应与用户界面行为

该工具返回的回复仅为文本，没有应用聊天成分。

该 MCP 工具由 MCP 应用支持。

响应类型

匹配记录文本列表

回复包括与其主名称、实体类型和相关性评分匹配的记录。 搜索层级（相关性或OData包含）会被标明。

路由注释

用于 search_entities ：

  • 当你不知道属于哪种记录或实体类型时，从你持有的标识符——电话号码、电子邮件地址或关键词——中寻找记录。
  • 同时搜索多个实体类型，比如联系人和账户。
  • 当该实体没有专用工具时，采用通用搜索的备选方案。

当 search_entities 提示明确写着：

  • 打开或编辑你已经能命名的记录——路由到 get_contact 或 get_account。
  • 按条件列出记录 ，如状态或所有者——路由到 list_accounts 或 list_contacts。
  • 搜索案件——路由到 search_cases （同一引擎，范围为事件）。
  • 查找字段关联——路径访问 search_lookup_records。
  • AI生成的时间线叙事——路径指向 summarize_entity_timeline 或 get_case_highlights。
工具 关系
search_cases 同一个搜索引擎，范围是案件实体
search_lookup_records 搜索查找字段关联的记录
list_accounts 专用账户列表及筛选功能
list_contacts 专用联系人列表及过滤器
list_entity_records 用于浏览记录的通用实体网格
get_entity_record 从搜索结果中打开单条记录详情

数据变异分类

只读。

这个工具不会改变数据。 它对Dataverse进行搜索查询。

  • 上次更新时间为