适用于：Dynamics 365 客户洞察
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你想在聊天中直接按姓名查找客户统一的客户洞察资料时，可以使用此功能。
它的作用是什么
助理会按名字或姓氏搜索您的客户洞察统一资料，并返回匹配的客户，每位客户都有统一的客户ID、姓名和电子邮件。 当有人指定某人，你需要他们的客户ID，然后再提取细节、细分、衡量或预测时，把它作为第一步。
当一个多词名称与任何一个字段不匹配时，助手会自动匹配所有单词，并告诉你这个更广泛的匹配已成功，这样你就知道结果是尽力而为而非精确匹配。
试试像这样的提示
- 查找Maria Garcia的客户资料。
- 查一下一位名叫Jane Doe的购物者的统一客户洞察档案。
- 在客户洞察中搜索一位名叫Alex Wilber的客户。
- 阮这个名字的统一客户是谁？
- 寻找姓氏为Garcia的客户。
- 列出客户洞察档案。
你在聊天中会看到的内容
助理会回复一份简短的文本列表，列出符合你搜索的客户。 每个条目都会显示客户姓名和可用于后续请求的统一客户ID。 如果是更广泛的逐字匹配，助理会把结果和结果一起记录下来。 如果没有匹配，助理会告诉你没有找到统一的配置文件。
有用的提示
- 可以说名字、姓氏，或者两者都写。 更多名称通常会缩小结果范围。
- 如果你不提供姓名，助理会翻阅完整的个人资料列表。
- 如果匹配的客户太多，再加更多名字，然后重新搜索。
- 一旦找到合适的客户，继续使用“显示该客户的所有信息”以获得完整的客户360度。
小窍门
找到合适的客户后，可以问一些后续问题，比如“这个客户属于哪些细分市场？”或者“这个客户的流失风险是多少？”，这样可以继续使用同一个配置文件。
接下来会发生什么
匹配客户出现后，你可以继续使用以下提示：
- 把客户洞察部门对这位客户的所有了解都展示给我看。
- 这位客户属于哪些细分市场？
- 这位客户的总购买量和平均订单金额是多少？
- 这位客户的流失风险是多少？
这会改变数据吗？
不，找到客户不会改变数据。
该功能仅读取客户洞察中的统一配置文件。 它从不创建、更新或删除记录。
先决条件
该工具可在 Dynamics 365 Customer Insights MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 客户洞察必须为您的环境配置，并且您需要权限才能读取统一的客户档案。
工具摘要
| 财产 | 值 |
|---|---|
| 面向用户的名称 | 寻找客户 |
| 内部工具名称 | find_customer |
| Purpose | 按姓名搜索客户洞察统一资料，返回匹配的客户ID（姓名和邮箱） |
工具行为
按姓名或姓氏搜索客户洞察统一配置文件（msdynci_customerprofile），返回每个匹配客户的统一客户ID、姓名和电子邮件。 多词名称如果不匹配任何单一字段，会回退为匹配所有单词，当该备选运行时，搜索记录会被标记。 省略姓名以便查看完整的个人资料列表。 在最多 top 行返回（默认10行，最多200行），并带有 hasMore 翻页标志 skip。
Annotations
| 注释 | 值 | Meaning |
|---|---|---|
readOnlyHint |
true |
只读;这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值（通过Dataverse查询客户洞察）。 |
输入概念
搜索词
| Input | 说明 | Required |
|---|---|---|
searchName |
与名字或姓氏匹配的名称片段（包含匹配）。 省略它以列出所有个人资料。 最多 256 个字符。 | 否 |
Paging
| Input | 说明 | Required |
|---|---|---|
top |
要返回的最大行数。 默认10，最多200。 | 否 |
skip |
分页时可以跳过的行数。 默认值 0。 | 否 |
投影
| Input | 说明 | Required |
|---|---|---|
select |
可选的逗号分隔列列表 msdynci_* 可覆盖默认的配置文件投影。 |
否 |
响应与用户界面行为
该工具返回文本回复。
该MCP工具没有由聊天应用组件支持。
响应类型
匹配客户的文本列表。
响应中列出了每位匹配客户，并统一了客户ID、姓名和邮箱，并在有更多行可用时标记 hasMore ，当更广泛的逐词匹配运行时则显示搜索说明。
路由注释
用于 find_customer ：
- 查找指定个人的客户档案，按姓名查找客户，或搜索购物者的客户洞察。
- 任何提示，要求某人并需要他们的客户洞察客户ID。
当 find_customer 提示词提供：
-
源系统记录ID （例如忠诚度记录或ERP记录）——路由到
get_customer_by_source_id。 -
Dataverse 联系人——路由到
get_customer_by_contact。 -
已识别的客户及其完整配置文件请求——路由至
get_customer_details。
相关工具
| 工具 | Relationship |
|---|---|
get_customer_by_source_id |
通过源系统记录ID解析统一客户 |
get_customer_by_contact |
解决Dataverse联系人中的统一客户 |
get_customer_details |
为已解决的客户退回完整的客户360 |
get_customer_segments |
列出已解决客户所属的细分 |
get_customer_measures |
返回已解决客户的衡量指标和关键绩效指标（KPI） |
数据变异分类
Read-only.
该工具只读取客户洞察中的统一配置文件，且从不更改数据。