适用于：Dynamics 365 客户洞察
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你拥有客户的统一ID并想知道他们被归为谁——是家庭还是其他客户洞察集群时，可以使用此功能。
它的作用是什么
对于一个统一客户，该能力返回该客户所属的客户洞察集群（例如家庭）以及每个集群共享该分配的共同成员，每个集群都带有亲和力评分。 集群列是从 Customer Insights 模型元数据中发现的，因此适用于环境定义的任何集群类型。
要解释成员身份，请依赖成员数量和成员列表：成员数大于一表示客户共享集群（如家庭）。 即使有共同成员，客户自身的亲和力分数也可能为空，因此空值并不意味着客户孤立无援。 先 find_customer用 、 get_customer_by_contact、 或 get_customer_by_source_id来解析客户编号。 如果客户不属于任何集群，助理返回的列表是空的。
试试像这样的提示
- 这位顾客家里是谁？
- 显示该客户的客户洞察集群和家庭。
- 这位客户属于哪个家庭集群，谁与谁共享？
- 在客户洞察中，这个客户归类为谁？
- 列出该客户集群的共同成员。
你在聊天中会看到的内容
助理会回复客户集群的文本列表。 每个簇显示簇类型、成员数以及共成员及其亲和力评分。 如果客户不属于任何集群，系统会告诉你列表是空的。
有用的提示
- 先
find_customer用 、get_customer_by_contact、 或get_customer_by_source_id来解析客户编号。 - 利用会员数量和会员名单来判断共享会员——亲和力评分为空并不意味着客户孤单。
- 对于集群与细分、测量和预测并列于一个视图中，请要求完整的客户360。
接下来会发生什么
你可以继续与同一个客户合作：
- 这位客户属于哪些细分市场？
- 这位客户的流失风险是多少？
- 把客户洞察部门对这位客户的所有了解都展示给我看。
这会改变数据吗？
不，读取集群信息不会改变数据。
该功能仅读取客户洞察中的集群成员信息。 它从不创建、更新或删除记录。
先决条件
该工具可在 Dynamics 365 Customer Insights MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 客户洞察必须为您的环境配置并定义集群模型，并且您需要权限读取统一配置文件和客户洞察模型元数据。
工具摘要
| 财产 | 值 |
|---|---|
| 面向用户的名称 | 获取集群信息 |
| 内部工具名称 | get_cluster_information |
| Purpose | 返回统一客户的客户洞察集群（家庭）成员资格和共同成员 |
工具行为
返回一个统一客户的客户洞察集群成员资格：对于客户所属的每个集群（如家庭），共享同一任务的共同成员，每个成员都有亲和力评分。 集群列是从客户洞察模型元数据中发现的，因此涵盖了任何类型的集群。 成员数大于一表示客户共享集群;即使存在共同成员，客户自身的得分也可能为空。 当客户不属于任何集群时，返回一个空列表。
Annotations
| 注释 | 值 | Meaning |
|---|---|---|
readOnlyHint |
true |
只读;这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用（只读工具）。 |
idempotentHint |
未设置 | 不适用（只读工具）。 |
openWorldHint |
未设置 | 使用默认值（通过Dataverse查询客户洞察）。 |
输入概念
Customer
| Input | 说明 | Required |
|---|---|---|
customerId |
客户洞察统一客户ID（32字符十六进制），可读取其集群成员身份。 | 是的 |
响应与用户界面行为
该工具返回文本回复。
该MCP工具没有由聊天应用组件支持。
响应类型
集群文本列表。
每个集群显示其类型、成员数量以及具有亲和力分数的共成员;当客户不属于任何集群时，列表为空。
路由注释
用于 get_cluster_information ：
- 询问已知客户被归类为他们的家庭、群体还是共享受众。
不要在以下情况下使用 get_cluster_information ：
- 提示尚未识别客户——请先
find_customer用 、get_customer_by_contact或get_customer_by_source_id来解决。 - 用户需要的是营销细分而非模型集群——路由到
get_customer_segments。 - 用户希望了解完整的客户情况——路由到
get_customer_details。
相关工具
| 工具 | Relationship |
|---|---|
get_customer_segments |
列出的是营销细分市场，而非模型集群 |
get_customer_details |
退货与完整的客户360并列 |
get_customer_predictions |
返回客户的机器学习预测 |
find_customer |
解决该工具所需的客户ID |
数据变异分类
Read-only.
该工具只读取客户洞察中的集群成员信息，且从不更改数据。