查看联系方式

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

注释

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

当你想直接在聊天中查看特定联系人的完整信息时，可以使用此功能。

它的作用是什么

助理会打开一个详细的联系表，针对你指定或用身份标识指定的人。 你可以查看所有联系人字段，内联编辑支持字段，并在Dynamics 365中导航到完整表单。

如果你提供了联系人姓名且多个联系人匹配，助理会告诉你，并建议你用“列表联系人”来找到合适的联系人。

试试像这样的提示

  • 开放联系乔丹·雷耶斯。
  • 给我看看斯嘉丽·休斯。
  • 查看亚历克斯·约翰逊的联系方式。
  • 打开玛丽亚·加西亚的联系表格。
  • 乔丹的情况如何？
  • 出示这个联系人。

你在聊天中会看到的内容

助手在聊天中显示一个互动式联系表单。 表单显示联系方式字段，如姓名、电子邮件、电话、公司、职位名称，以及表单上配置的任何自定义字段。

有用的提示

  • 你可以使用联系人姓名或GUID来开启特定的联系人。
  • 如果助理说多个联系人匹配，试试“列出联系人”，然后选择你想要的那一个。
  • 如需简短的文字摘要而非完整表格，请写“总结请联系Jordan Reyes”。
  • 关于母公司的详细信息，请写“开户”，然后加上公司名称。

Tip

联系表出现后，你可以提出后续问题，比如“总结此联系人”或“列出该联系人的案例”。

接下来会发生什么

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

  • 总结一下这次联系。
  • 请显示该联系人的账户。
  • 列出该联系人的案例。
  • 更新此联系人的电子邮件地址。

这会改变数据吗？

不，查看联系人不会改变数据。

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

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

通过聊天中的联系表单，你可以：

  • 请查看所有联系方式。
  • 编辑支持字段内嵌。
  • 在Dynamics 365中打开完整联系表单。
  • 继续在聊天中与联系人互动，并设置后续提示。

先决条件

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

工具摘要

资产 价值
面向用户的名称 查看联系方式
内部工具名称 get_contact
Purpose 通过内联编辑打开单个CRM联系人记录的完整表单视图

工具行为

通过内联编辑打开单一CRM联系人记录的完整表单视图。 接受GUID或联系人名，并自动解析唯一名称。 当多个联系人匹配该名称时返回错误;用于 list_contacts 消歧。

Annotations

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

输入概念

记录标识符

输入 Description 必需
recordId recordId （字符串，必填）。 一个联系人GUID或联系人姓名供搜索。 当提供名称时，工具会在服务器端解析该名称。 如果多个联系人匹配，会返回错误，引导用户前往 list_contacts 消歧义。 是的

形式选择

输入 Description 必需
formId formId （字符串，可选）。 一个用于渲染的系统形式 GUID。 省略时默认使用主要形式。 否

响应与用户界面行为

该工具生成一个互动式聊天应用的联系表单。

该 MCP 工具由 MCP 应用支持。

响应类型

交互式表单（详细视图）

表单显示联系人的字段，包括所选系统表单定义的字段，包括全名、电子邮件、电话、公司、职位名称和自定义字段。

路由注释

用于 get_contact ：

  • 打开联系方式X，显示联系方式，查看Jordan Reyes。
  • 任何提示，具体点名联系人并想查看他们的表格。

当 get_contact 提示明确写着：

  • “列表”或“显示我的联系人”——路由到 list_contacts。
  • “总结”联系人——路由至 summarize_contact。
  • 逻辑名称为通用实体——路径映射到 get_entity_record。
工具 关系
list_contacts 列出联系人;用于区分多个名字匹配的歧义
summarize_contact 接触背景和病例历史的AI文本摘要
update_entity_record 联系记录上的更新字段
get_account 开设账户表单;通常与接触细节一起使用
get_entity_record 非联系实体类型的通用实体详情

数据变异分类

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

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

  • 上次更新时间为