适用于：Dynamics 365 客户洞察
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你拥有客户的统一ID，想要完整的客户360——客户洞察部门对他们的所有了解集中在一个地方时，可以使用这项功能。
它的作用是什么
对于一个统一客户，这项能力组装了一个完整的客户360：核心配置文件（姓名、邮箱、城市、国家/地区、邮政编码）、所属的细分区、所有指标、集群（家庭）成员、机器学习预测以及嵌入配置文件的源记录。 对于每个源记录，它还显示了现场层级的映射——即哪个源系统获得了统一值——所以你可以看到为什么配置文件显示了某个特定值。
细分、测量、聚类和预测均来自专业工具使用的同一读取器，因此本概述与同一客户专用工具不相冲突。 先 find_customer用 、 get_customer_by_contact、 或 get_customer_by_source_id来解析客户编号。 如果你只需要其中一个区域，那就联系专业工具吧。
试试像这样的提示
- 把客户洞察部门对这位客户的所有了解都展示给我看。
- 请给我该客户的完整客户360——画像、细分市场、衡量指标和来源。
- 我正在准备一个电话会议;准备一份关于这位客户的完整客户洞察简报。
- 为什么这个客户的个人资料显示这个邮箱地址？
- 是哪些源记录构建了该客户的统一档案？
你在聊天中会看到的内容
助理回复了客户的综合摘要：核心档案、细分群体成员资格、测量、集群、预测，以及档案背后的源记录及其现场级来源。 如果找不到核心配置文件，请求会失败，而不是返回部分图像;可选区域（如集群或预测）在客户没有数据时报告“无”。
有用的提示
- 先
find_customer用 、get_customer_by_contact、 或get_customer_by_source_id来解析客户编号。 - 准备通话时询问完整情况;只需分段、测量、预测或聚类时，请专业工具查询。
- 要理解某个具体数值，可以问为什么配置文件显示该值——来源说明是哪个系统赢得了该字段。
小窍门
如果360的全部需求超出需求，可以问一个更窄的后续问题，比如“仅限该客户的细分”或“仅限该客户的流失风险”。
接下来会发生什么
你可以用以下提示来缩小关注范围：
- 这位客户属于哪些细分市场？
- 这位客户的总购买量和平均订单金额是多少？
- 这位客户的流失风险是多少？
- 这位顾客家里是谁？
这会改变数据吗？
不，获取客户信息不会改变数据。
该功能仅读取客户洞察中的画像、细分、测量、聚类、预测和源数据。 它从不创建、更新或删除记录。
先决条件
该工具可在 Dynamics 365 Customer Insights MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 客户洞察必须为您的环境配置，您需要权限才能读取统一配置文件及其相关的客户洞察数据（分段、测量、集群、预测和源记录）。
工具摘要
| 财产 | 值 |
|---|---|
| 面向用户的名称 | 获取客户信息 |
| 内部工具名称 | get_customer_details |
| Purpose | 为统一客户返回完整的客户360——个人资料、细分、测量、集群、预测和来源 |
工具行为
返回一个统一客户ID的客户360概览：核心配置文件、细分成员、所有度量、集群成员、机器学习预测，以及缝入配置文件的源记录，并配有字段级属性映射，显示哪个来源赢得了每个统一值。 细分、测量、集群和预测与专门工具为同一客户返回的结果相匹配。 缺失的核心配置文件会失败，而不是返回部分视图;可选部分在数据缺失时报告“无”。
Annotations
| 注释 | 值 | Meaning |
|---|---|---|
readOnlyHint |
true |
只读;这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值（通过Dataverse查询客户洞察）。 |
输入概念
Customer
| Input | 说明 | Required |
|---|---|---|
customerId |
Customer Insights统一客户ID（32字符十六进制）用于获取。 | 是的 |
投影
| Input | 说明 | Required |
|---|---|---|
select |
可选的逗号分隔列列表 msdynci_* 以限制剖面投影。 完整资料中省略。 |
否 |
响应与用户界面行为
该工具返回文本回复。
该MCP工具没有由聊天应用组件支持。
响应类型
合并客户360摘要。
回应包括核心剖面、片段、测量、聚类、预测以及带有现场级来源的来源记录。
路由注释
用于 get_customer_details ：
- 请求了解已知客户的完整情况，或为何配置文件显示特定数值。
不要在以下情况下使用 get_customer_details ：
- 提示尚未确定客户——先
find_customer用 、get_customer_by_contact或get_customer_by_source_id来结算。 - 用户只需一个区域——路由到
get_customer_segments、get_customer_measures、get_customer_predictions或get_cluster_information。
相关工具
| 工具 | Relationship |
|---|---|
find_customer |
解决该工具所需的客户ID |
get_customer_segments |
只返回客户的分段 |
get_customer_measures |
只返回客户的测量数据 |
get_customer_predictions |
只返回客户的预测 |
get_cluster_information |
只返回客户的集群或家庭 |
数据变异分类
Read-only.
该工具仅读取个人资料及相关客户洞察数据，且从不更改数据。