列出联系人

注释

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

当你想找到联系人、在聊天中查看并采取行动而不离开对话时，可以使用这个功能。

它的作用是什么

助手会显示与你的筛选条件匹配的联系人列表。 您可以按以下条件进行筛选：

  • 联系人是否分配给你。
  • 联系状态（活跃或非活跃）。
  • 母公司。
  • 联系人姓名。

结果会显示在聊天中的互动联系人列表中。

试试像这样的提示

  • 给我看联系人。
  • 列出我的活跃联系人。
  • 在Contoso展示联系人。
  • 列出非活跃联系人。
  • 显示分配给我的联系人。
  • 找到乔丹·雷耶斯。
  • 列出所有联系人。
  • 在Fabrikam展示联系人。

你在聊天中会看到的内容

助手以聊天应用组件的形式显示互动联系人列表。 该列表显示匹配联系人，关键细节包括姓名、电子邮件、电话、公司和职位名称。

有用的提示

  • 说“我的联系人”或“分配给我”，只显示你拥有的联系人。
  • 使用状态词如活跃或非活跃来筛选结果。
  • 使用公司名称查找特定组织的联系人，例如“显示联系人地址”。
  • 通过说类似“显示我在Fabrikam的活跃联系人”来组合筛选器。
  • 如果你想要联系人的文本摘要，可以说“总结联系人 Jordan Reyes”。

Tip

联系人列表显示后，您可以就所示联系人提出后续问题。 例如，“开启首次接触”或“总结乔丹·雷耶斯”。

接下来会发生什么

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

  • 打开第一次接触。
  • 总结一下这次联系。
  • 请显示该联系人的账户。
  • 更新该联系人的电子邮件地址。

这会改变数据吗？

不，列出联系人不会改变数据。

联系人列表为只读。 列表中的后续操作，如更新字段，可能会改变数据。 助理在做修改前会先确认。

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

从聊天的联系人列表中，你可以：

  • 扫描并审核匹配的联系人，形成可排序的网格。
  • 选择联系方式查看更多详情。
  • 在Dynamics 365中打开完整联系表单。
  • 在有支持字段时更新内联支持字段。
  • 继续在聊天中与联系人互动，并设置后续提示。

先决条件

该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。

工具摘要

资产 价值
面向用户的名称 列出联系人
内部工具名称 list_contacts
Purpose 按状态、母公司、所有者或姓名搜索筛选客户联系人，并以互动式网格式聊天应用体验呈现

工具行为

通过状态、母公司、所有者或姓名搜索筛选客户联系人，并以互动式网格式的聊天应用体验呈现。 该 search 参数对联系人名称进行包含匹配。

Annotations

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

输入概念

输入 Description 必需
— 自由文本字符串。 对联系人名进行包含匹配。 否

公司

输入 Description 必需
— 按母公司名称筛选（包含匹配）。 当用户指定公司或组织时使用。 否

地位

输入 Description 必需
active、inactive active 或 inactive。 按联系人状态代码筛选。 否

所有权范围

输入 Description 必需
assignedToMe assignedToMe （布尔值）。 如果为真，范围会显示为当前用户拥有的联系人。 否

结果限制

输入 Description 必需
top top （整数）。 最多可返回的联系人数。 默认是10，最多200。 否

其他筛选器

输入 Description 必需
additionalFilter additionalFilter （键值映射）。 任意的OData滤波条件与AND合并。 否

响应与用户界面行为

该工具渲染一个交互式的聊天应用联系人网格。

该 MCP 工具由 MCP 应用支持。

响应类型

交互式网格（列表视图）

网格显示联系人姓名、电子邮件、电话、公司和职位名称。 用户可以选择一行深入联系人详情，或通过聊天进行后续操作。

路由注释

用于 list_contacts ：

  • 我的联系人，分配给我的联系人，我的活跃联系人。
  • 基于状态的过滤（激活，非激活）。
  • 公司过滤。
  • 联系方式姓名搜索。

当 list_contacts 提示明确写着：

  • 通过姓名获取详细信息的具体联系人——路由至 get_contact。
  • “总结”联系人（person）——路由至 summarize_contact。
  • 跨多种实体类型的自由文本搜索——路由至 search_entities。
  • 查找字段关联——路径访问 search_lookup_records。
工具 关系
get_contact 打开选定联系人的完整联系表单
summarize_contact 生成由人工智能驱动的联系人摘要
list_accounts 列出账户;通常与接触浏览一起使用
search_entities 跨任何实体类型的自由文本搜索
search_lookup_records 搜索查找字段关联的记录
list_entity_records 针对没有专用列表工具的实体类型的通用实体网格

数据变异分类

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

房源本身不会改变数据。 网格的后续操作（更新、编辑字段）可以通过不同的工具触发写入操作。

  • 上次更新时间为