适用于:Dynamics 365 客户洞察
注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时,不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反,设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展,Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你拥有客户的统一ID并希望获得他们所属的客户洞察细分列表时,可以使用这个功能。
它的作用是什么
对于一个统一客户,该能力列出了该客户所属的客户洞察细分(受众)。 每个分段都显示其友好的显示名称和分段ID,方便你用来定位或参考。
先 find_customer用 、 get_customer_by_contact、 或 get_customer_by_source_id来解析客户编号。 如果客户不在任何细分中,助理会返回一个空列表。
试试像这样的提示
- 这位客户属于哪些细分市场?
- 列出该客户所属的客户洞察细分。
- 针对定位,告诉我这个客户拥有的每个细分段成员。
- 这位客户属于哪些受众?
- 展示该客户的细分成员身份及其显示名称。
你在聊天中会看到的内容
助理会回复一份客户细分段的文本列表,每个细分段都有友好的名称和细分ID。 如果客户不属于任何细分,它会告诉你列表是空的。
有用的提示
- 先
find_customer用 、get_customer_by_contact、 或get_customer_by_source_id来解析客户编号。 - 显示的细分段名称是面向营销人员的显示名称;当细分段没有显示名称时,则使用内部名称。
- 为了了解客户的全貌,包括细分市场、指标和预测,请索要完整的客户360。
接下来会发生什么
你可以继续与同一个客户合作:
- 这位客户的总购买量和平均订单金额是多少?
- 这位客户的流失风险是多少?
- 把客户洞察部门对这位客户的所有了解都展示给我看。
这会改变数据吗?
不,列出客户的细分块不会改变数据。
该功能仅读取客户洞察中的细分成员。 它从不创建、更新或删除记录。
先决条件
该工具可在 Dynamics 365 Customer Insights MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 客户洞察必须根据你的环境配置,定义细分块,并且你需要权限才能读取细分群成员资格和细分元数据。
工具摘要
| 财产 | 值 |
|---|---|
| 面向用户的名称 | 获取客户细分 |
| 内部工具名称 | get_customer_segments |
| Purpose | 列出统一客户所属的客户洞察细分,并显示名称和ID |
工具行为
列出统一客户所属的客户洞察细分,并将每个细分名与其友好(显示)名称和细分段ID(msdynci_segmentmembership 连接到 mscipriv_segmentmetadata)配对。 当元数据没有友好名称时,友好名称会退回到内部名称。 当客户没有分段成员资格时,返回一个空列表。
Annotations
| 注释 | 值 | Meaning |
|---|---|---|
readOnlyHint |
true |
只读;这个工具不会修改数据。 |
destructiveHint |
未设置 | 不适用(只读工具)。 |
idempotentHint |
未设置 | 不适用(只读工具)。 |
openWorldHint |
未设置 | 使用默认值(通过Dataverse查询客户洞察)。 |
输入概念
Customer
| Input | 说明 | Required |
|---|---|---|
customerId |
客户洞察统一客户ID(32字符十六进制)。 | 是的 |
响应与用户界面行为
该工具返回文本回复。
该MCP工具没有由聊天应用组件支持。
响应类型
段落的文本列表。
每个条目将一个分段名称与其友好显示名称及分段ID配对;当客户不属于分段时,列表为空。
路由注释
用于 get_customer_segments :
- 询问已知客户属于哪些细分群体或受众。
不要在以下情况下使用 get_customer_segments :
- 提示尚未确定客户——先
find_customer用 、get_customer_by_contact或get_customer_by_source_id来结算。 - 用户希望了解完整的客户情况——路由到
get_customer_details。 - 用户需要指标、预测或家庭数据——链接到匹配专家工具。
相关工具
| 工具 | Relationship |
|---|---|
get_customer_details |
退货环节与完整的Customer 360并列 |
get_customer_measures |
返回客户的衡量指标和关键绩效指标(KPI) |
get_customer_predictions |
返回客户的机器学习预测 |
find_customer |
解决该工具所需的客户ID |
数据变异分类
Read-only.
该工具只读取客户洞察中的细分会员,且从不更改数据。