获取客户衡量

适用于:Dynamics 365 客户洞察

注释

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

当你拥有客户的统一身份识别(Unified ID)并希望获得他们的客户洞察(Customer Insights)指标——即为该客户计算的KPI时,可以使用这项功能。

它的作用是什么

对于一个统一的客户,该能力返回客户洞察为其计算的指标(KPI),例如终身价值、订单数量或参与度评分。 客户洞察可以将测量数据存储在两种不同的布局中;该功能将两者合并为一个列表,因此你无需知道它们是如何存储的。

先 find_customer用 、 get_customer_by_contact、 或 get_customer_by_source_id来解析客户编号。 如果客户没有测量,助理会返回一个空列表。

试试像这样的提示

  • 这位客户的总购买量和平均订单金额是多少?
  • 展示该客户的客户洞察指标和关键绩效指标。
  • 从客户洞察中提取该客户的终身消费和订单KPI。
  • 这位客户的互动评分是多少?
  • 列出该客户计算的所有客户洞察度量。

你在聊天中会看到的内容

助理会回复一份包含客户测量的文本列表,每个指标都有其名称和数值。 共享 blob 中的测度先列出,然后按比例调整到各自的表格中。 如果客户没有任何指标,系统会告诉你清单是空的。

有用的提示

  • 先 find_customer用 、 get_customer_by_contact、 或 get_customer_by_source_id来解析客户编号。
  • 衡量指标是汇总的KPI(如终身价值或订单数量),而非前瞻性评分——对于流失风险或预测终身价值,请要求预测。
  • 如需统一查看衡量指标、细分市场和预测,请索取完整的客户360。

接下来会发生什么

你可以继续与同一个客户合作:

  • 这位客户的流失风险是多少?
  • 这位客户属于哪些细分市场?
  • 把客户洞察部门对这位客户的所有了解都展示给我看。

这会改变数据吗?

不,读取客户的指标不会改变数据。

该功能仅读取客户洞察的计算数据。 它从不创建、更新或删除记录。

先决条件

该工具可在 Dynamics 365 Customer Insights MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 客户洞察必须根据您的环境配置并定义度量,您需要权限才能读取客户度量和度量元数据。

工具摘要

财产 值
面向用户的名称 获取客户衡量
内部工具名称 get_customer_measures
Purpose 返回为统一客户计算的汇总客户洞察指标(KPI)

工具行为

返回为统一客户计算的汇总客户洞察指标(KPI),例如终身价值、订单数量或参与度评分。 它将 Dataverse 的布局(共享的属性-测量块和按客户计量的水合到各自的表)合并到一个集合中。 每个测度都带有一个名称、已知测度ID、与其自身表同水合的测度实体及其值。 当客户没有任何衡量标准时,会返回一个空白列表。

Annotations

注释 值 Meaning
readOnlyHint true 只读;这个工具不会修改数据。
destructiveHint 未设置 不适用(只读工具)。
idempotentHint 未设置 不适用(只读工具)。
openWorldHint 未设置 使用默认值(通过Dataverse查询客户洞察)。

输入概念

Customer

Input 说明 Required
customerId 客户洞察统一客户ID(32字符十六进制)。 是的

响应与用户界面行为

该工具返回文本回复。

该MCP工具没有由聊天应用组件支持。

响应类型

文本中的度量表。

每个度量包含其名称和数值;blob度量列在水合度量之前,客户没有时列表为空。

路由注释

用于 get_customer_measures :

  • 请求提供已知客户的KPI、指标或指标(生命周期价值、订单数量、参与度)。

不要在以下情况下使用 get_customer_measures :

  • 提示尚未识别客户——请先 find_customer用 、 get_customer_by_contact或 get_customer_by_source_id来解决。
  • 用户需要前瞻性评分(流失率、预测终身值)——路由 。get_customer_predictions
  • 用户希望了解完整的客户情况——路由到 get_customer_details。
工具 Relationship
get_customer_predictions 以前瞻性评分而非汇总指标回报
get_customer_details 退货与完整的客户360同步测量
get_customer_segments 列出客户的细分成员资格
find_customer 解决该工具所需的客户ID

数据变异分类

Read-only.

该工具只读取客户洞察的计算数据,且从不更改数据。