搜索事例

适用于：Dynamics 365 Customer Service

注释

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

利用此功能查找特定客户（账户或联系人）的案例，或在案例描述正文中可能出现关键词而非标题时。 对于简单的“关于X的案件”关键词或标题查询、状态或优先级过滤，或案件号查询，请使用list_cases。

它的作用是什么

助理会查找与特定客户（账户或联系人）相关的案件，或通过关键词搜索案件文本——当组织启用相关性搜索时，会在标题和描述之间进行搜索，否则仅匹配标题。 当您需要客户的案件，或者您记得的词语出现在案件描述中而非标题时，它最有用。 对于简单的标题或主题关键词查询，请使用list_cases。

试试像这样的提示

  • 查找Contoso的案件。
  • 寻找乔丹·雷耶斯的案件。
  • 哪些案件属于Fabrikam账户？
  • 找描述中提到VPN超时的情况。
  • 展示与Acme公司有关的案件。

你在聊天中会看到的内容

助手会显示一份匹配案件的文本列表，包含案件编号、标题、状态，以及——在有相关性搜索时——相关性评分。 这是一种没有交互成分的文本回复。

有用的提示

  • 使用具体关键词以获得更好的结果。 “打印机纸张卡滞”这个词比单纯“打印机”更为相关。
  • 按客户名称搜索，查找特定客户的所有案件：“查找Contoso案件。”
  • 如果你知道案件编号，可以用“find case CAS-01010-A0A0A0”，它使用另一种更快的查询方式。
  • 如果你想用交互式网格按状态或优先级筛选案件，可以选择“列出我的活跃案件”。

Tip

找到匹配的案例后，可以询问“摘要案例CAS-01010-A0A0A0”以便快速审查。

接下来会发生什么

找到案例后，你可以继续使用以下提示：

  • 总结一下第一个案例。
  • 开箱 CAS-01010-A0A0A0。
  • 那个案子的SLA状态如何？
  • 把这个案子重新分配给亚历克斯。

这会改变数据吗？

不，搜索案件不会改变数据。

搜索为唯读，查询现有案件记录。

先决条件

该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 无需进行额外配置。

工具摘要

资产 价值
面向用户的名称 搜索事例
内部工具名称 search_cases
Purpose 按客户名称（账户或联系人）或在整个案例正文中排名的关键词查找案件（当该词很可能出现在描述中时效果最佳）

工具行为

通过客户名称（账户或联系人）或关键词查找案例——最好当该词很可能出现在描述正文中，而不仅仅是标题中。 当组织启用Dataverse相关性搜索时（涵盖标题和描述，按相关性排序）;否则，仅用标题子串的备份，按修改日期排序（无相关性评分）。 范围限定为事件实体，仅发短信。 对于简单的标题或主题关键词查询，或状态/优先级/所有者筛选，请使用list_cases。

Annotations

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

输入概念

Input 说明 Required
searchText searchText （字符串，最多500个角色）。 匹配关键词;启用时会在标题和描述之间使用相关性搜索，否则则是仅标题的子字符串备份。 当该词可能出现在描述正文中，而不仅仅是标题时使用;对于简单的标题或主题关键词查询，请使用 list_cases。 即使也被提供，但却被 customerName 忽略。 除非 customerName 有提供，否则为必需。 除非 customerName 提供

客户过滤器

Input 说明 Required
customerName customerName （串，最多200个字符）。 客户姓名（账户或联系人）以便筛选案例。 当两者都提供时，优先 searchText 于。 除非 searchText 有提供，否则为必需。 除非 searchText 提供

结果限制

Input 说明 Required
top top （整数）。 最大结果数。 默认为组织页面大小设置（通常为10页）。 No

响应与用户界面行为

响应类型

仅文本

返回匹配案件的文本列表，包含案件编号、标题、状态和相关性评分。 没有渲染任何交互组件。

路由注释

在以下情况下使用 search_cases：

  • 用户希望为特定客户名称（账户或联系人）查找案件。
  • 用户在案件 描述正文中期望的关键词，而不仅仅是标题。
  • 用户说“为客户Y查找案件”、“与账户>关联<的案件”。

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

  • 纯关键词或标题查找 （“关于X的案例”、“提及X的案例”、“查找X案例”）——路径到 list_cases （其 search 参数与案件标题匹配）。
  • 通过网格小部件按状态、优先级或所有者筛选——路由到 list_cases。
  • 精确案件号查询——路由到 list_cases （参数 search 处理精确案件号匹配）。
  • 非案件实体搜索——路径至 search_entities。
  • 完全没有搜索条件 （按状态、优先级、所有者或案件号浏览案件）——路由到 list_cases; search_cases 既没有 searchText 也没有 的 customerName 呼叫被拒绝。
工具 关系
list_cases 用滤镜列出案例并渲染网格。 用于标题/主题关键词查询、状态/优先级/所有者筛选，或案件编号查询
search_entities 跨任何实体类型的通用Dataverse搜索
summarize_case 开启匹配案件并附有AI摘要
match_cases 通过相关性搜索查找与邮件匹配的案例

数据变异分类

只读。

该工具查询Dataverse搜索索引时不修改任何数据。

  • 上次更新时间为