按源ID解决客户

适用于：Dynamics 365 客户洞察

注释

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

当你持有源系统的记录标识符，想要连接到统一的客户洞察客户时，可以使用此功能。

它的作用是什么

客户洞察会从多个源系统（例如忠诚度计划或ERP）接收记录，并将其拼接成一个统一的配置文件。 该功能会接收源实体名称和源记录ID，并返回记录映射到的统一客户ID。

当你从已导入的源表中获得 ID，并且需要在读取客户的详细信息、细分、指标或预测之前先获得 Customer 360 ID。 如果没有统一的配置文件映射到那个源记录，助手会告诉你什么都没找到。

试试像这样的提示

  • 在客户洞察中，这个统一的忠诚度记录对应到哪个客户？
  • 将源潜在客户记录映射到其统一的客户洞察客户。
  • 我们从市场部门接收了一份记录——Resolve，这也成为了客户洞察的主页。
  • 将ERP客户记录解析为其客户洞察客户ID。
  • 查找该源系统记录的统一配置文件。

你在聊天中会看到的内容

助理会回复源记录对应的统一客户ID。 如果没有统一的配置文件关联到该记录，它会告诉你客户未被找到。

有用的提示

  • 同时提供源实体名称（被摄取表的逻辑名称，如 contact 或 loyaltymember）和源记录的键值。
  • 如果你有Dataverse的联系人ID，可以使用 get_customer_by_contact——这是联系人的快捷方式。
  • 拿到客户ID后，继续“显示该客户的所有信息”，或者要求细分、指标或预测。

接下来会发生什么

客户解决后，你可以继续使用以下提示：

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

这会改变数据吗？

不，按源ID解决客户不会改变数据。

该功能仅读取客户洞察中源头到统一映射。 它从不创建、更新或删除记录。

先决条件

该工具可在 Dynamics 365 Customer Insights MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 客户洞察必须为您的环境配置，并导入相关源数据，并且您需要权限读取源到统一密钥映射。

工具摘要

财产 值
面向用户的名称 按来源ID解决客户
内部工具名称 get_customer_by_source_id
Purpose 从源系统记录标识符解析统一的客户洞察客户ID

工具行为

通过源系统记录标识msdynci_alternatekey符（）解析 Customer Insights 统一客户 ID 。 传递源实体的逻辑名称和源记录的键值;工具返回匹配的统一客户ID，或在没有统一配置文件映射到该源记录时返回未找到的报告。

Annotations

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

输入概念

资料来源记录

Input 说明 Required
entityName 源实体的逻辑名称，如被导入客户洞察（例如contactloyaltymember或）。 最多 256 个字符。 是的
sourceId 源记录的备用键值需要解析。 最多 256 个字符。 是的

响应与用户界面行为

该工具返回文本回复。

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

响应类型

统一客户ID（或未找到）。

响应包含源记录对应的统一客户ID，或在未关联统一配置文件时显示“未找到”结果。

路由注释

用于 get_customer_by_source_id ：

  • 一个提示，提供源系统记录ID（忠诚度、ERP或其他摄入表），并需要统一的客户洞察客户。

当 get_customer_by_source_id 提示词提供：

  • 一个人的名字——路由到find_customer。
  • Dataverse 联系人 ID——路由到 get_customer_by_contact。
  • 已解决的客户ID和数据请求——路由或 get_customer_details 专业读卡器。
工具 Relationship
find_customer 通过名称解决统一客户
get_customer_by_contact 解决Dataverse联系人中的统一客户
get_customer_details 为已解决的客户退回完整的客户360
list_data_sources 列出被摄取的数据源及其源实体名称

数据变异分类

Read-only.

该工具仅读取客户洞察中源代码到统一密钥映射，且不更改数据。

  • 上次更新时间为