字段发现代理

在Adobe Experience Platform中构建受众或载入数据时，识别业务概念的正确XDM字段通常需要手动浏览架构或预先知道字段的命名方式。 不同的字段可能以不同的名称（例如，状态、区域和位置）表示相同的概念，而选择错误的字段会导致下游工作流中出现错误。

字段发现代理是Adobe Experience Platform中由AI提供支持的代理，可帮助您在AI Assistant中使用自然语言查询查找、评估和选择XDM字段。 您可以用简单的语言描述您要查找的内容（业务概念、工作流目标或特定字段名称），座席会根据支持上下文返回排名字段建议。

当其他Experience Platform代理需要解析字段或实体引用时，会在AI Assistant的后台自动调用字段发现代理。 在这些情况下，它将在后台运行，以提高您正在处理的代理的准确性。 当您需要为自己的工作进行字段发现时，请在AI助手中编写明确的字段发现提示。 字段发现代理仅显示字段信息。 它不修改架构、数据集或受众，并尊重您现有的访问控制和沙盒上下文。

何时使用它 when-to-use-this

当您需要排名的字段建议、示例值以及映射、分段或查询的使用上下文时，请在AI Assistant中明确使用字段发现代理。 当其他Experience Platform代理在后台调用它以解析字段或实体引用时，将隐式使用该字段。 在这些情况下，您将停留在该座席的工作流中，并且不会发出单独的字段查找提示。

先决条件 prerequisites

要使用Field Discovery Agent ，请确保您具有以下功能：

您对XDM架构以及字段在分段或数据工作流中的使用方式基本熟悉，这可以帮助您更有效地解释结果。 有关详细信息，请参阅XDM概述和架构编辑器文档。

有关启用AI助手访问和授予所需权限的说明，请参阅Agent Orchestrator访问指南。

字段发现代理功能 field-discovery-agent-functions

Field Discovery Agent会处理您的查询，并根据您的意图返回三种输出类型之一。 这些函数反映代理解释查询的方式；您无需选择它们。 代理会根据您描述的内容自动确定相应的响应类型。

字段发现代理的工作方式 how-field-discovery-agent-works

在高层面上，代理解释您的意图，搜索您的可用数据，并按相关性对结果进行排名。 查询的措辞方式直接影响每个阶段，进而影响结果的质量。

在AI助手中提交查询时，字段发现代理分三个阶段处理您的请求：

了解您的结果 understand-your-results

字段发现代理返回每个查询的结构化结果集。 了解结果的组成有助于您评估候选字段并自信地对其执行操作，而无需进行额外的反复试验。

当字段的​ 相关性 ​标签为​高度相关，其样本值与您预期的数据（可用时）匹配，并且其​ 使用情况上下文 ​与您计划使用的方式一致时，将其视为已准备就绪。 如果结果仅为​ 适度相关 ​或​相关，且示例值不符合您的预期，或者使用上下文受限，请在继续操作之前优化您的查询并查看新的结果集。

相关性标签

字段发现代理在​ 已识别字段 ​面板的​ 相关性 ​列中为每个字段结果分配相关性标签，指示字段与查询的匹配程度。

如果所有结果都标记为​ 适度相关 ​或​相关，而不是​高度相关，则您的查询可能过于宽泛，或者使用的术语与您的架构元数据不匹配。 使用反映字段命名方式的更具体的语言或域术语优化提示。

示例值

除了每个字段建议外，字段发现代理还会显示从沙盒中的字段数据提取的示例值。 示例值可帮助您在选择某个字段之前验证该字段是否包含您预期的数据类型。

样本值仅对数据集访问权限中的字段可见。 有关Experience Platform中的数据治理和使用限制的信息，请参阅数据管理概述。

如果某个字段未显示示例值，则当前沙盒中的字段可能为空，或者您的权限可能不包括对其基础数据集的访问权限。 具有高基数的字段（例如标识符或UUID字段）可能不会返回代表性示例值。 样本值会聚合并基于频率，不可跟踪到单个用户档案。

使用上下文

每个字段结果都包含使用情况上下文，其中显示该字段在数据生态系统中的显示位置：

受众→数据集→目标→架构

在已发布的受众中使用的字段，显示在活动数据集中，映射到实时目标，并在架构中定义的字段，已在您的环境中显示出实际用途。 这样可以将积极依赖的字段与仅存在于架构定义中但尚未在实践中使用的字段区分开来。 将此信号与相关性标签和示例值一起使用以进行更明智的字段选择。

AI助手中的结果

字段发现代理在AI助手响应中的​ 已识别字段 ​面板中返回结果。 该面板将显示一个包含三列的表：

解释的结果​部分显示在​ 已标识的字段 ​表下方，并且提供了额外的字段级上下文，包括每个结果的解释和支持详细信息。 有关导航AI助手界面的指导，请参阅AI助手UI指南。

使用字段发现代理 use-field-discovery-agent

您可使用自然语言通过AI Assistant与Field Discovery Agent交互。 代理需要明确的意图声明 — 模糊或过于短暂的查询会产生质量较低的结果，或者根本不会调用字段发现代理。

要发现明确的字段，请遵循以下工作流：识别属性或映射问题，提交字段查找查询，在​ 识别字段 ​面板中查看排名结果和使用上下文，选择适合您意图的​ 字段名称 ​路径，并在区段生成器、查询服务或其他工作流中应用该XDM路径。

要使用字段发现代理，请执行以下操作：

如果需要，请选择响应上方的​ 推理完成 ​下拉列表，以确认字段发现代理处理了您的请求。 下拉菜单显示推理详细信息，指示调用了哪个代理。

有关AI助手界面的指导，请参阅AI助手UI指南。

支持的用例 supported-use-cases

以下各节介绍了Field Discovery Agent的三个功能以及代表性方案和示例提示。 结果包括相关标签和使用上下文以帮助评估字段。 有关结果解释，请参阅了解您的结果。 字段发现代理仅返回字段信息 — 它不会创建受众、执行查询或将数据推送到其他工具。 标识字段后，从​ 字段名称 ​列中读取其XDM路径并将其用于下游工作流。

确定业务概念的字段

当您描述特定数据概念或属性时， Field Discovery Agent会返回语义上与您的描述匹配的字段的排名列表。

“哪些字段代表客户所在省/市/自治区？”
“查找与购买交易日期相关的字段。”
“哪些字段包含有关电子邮件营销同意的信息？”

响应在​ 已识别字段 ​面板中列出了候选字段及其相关标签和XDM路径。 标记为​ 高度相关 ​的字段与您声明的概念最接近。 如果排名最前的结果标记为​ 适度相关 ​或​ 相关 ​而不是​高度相关，请使用更具体的术语或字段级上下文来优化您的查询。

获取用例的字段推荐

当您描述工作流目标或用例（如构建区段、加入数据集或准备查询）时，字段发现代理会推荐与该目标一致的字段，并按相关性优先排序。

“我想打造一个高价值客户群。我应该使用哪些字段？”
“推荐用于建模购买倾向的字段。”
“载入零售交易数据集时应该包含哪些字段？”

响应将返回带相关上下文的优先级字段列表。 查看每个推荐字段的使用上下文，以确认在您的环境中当前已使用该字段。

丰富字段上下文

当您按名称或路径询问某个特定字段时， Field Discovery Agent会返回该字段的详细上下文，包括示例值、架构位置以及数据集、受众和目标之间的使用情况。

“告诉我有关字段person.name.lastName的更多信息。”
“homeAddress.stateProvince存在哪些示例值？”
“我的数据集和受众使用的字段commerce.purchases.value在哪里？”

响应将返回该字段的示例值、架构位置、关联的数据集以及显示该字段的任何受众或目标。 查看此上下文，以确认该字段包含您预期的数据。

范围和范围外 in-scope-and-out-of-scope

本节总结了字段发现代理可以执行的操作以及无法执行的操作。 有关详细的任务指南，请参阅支持的用例。 有关平台约束，请参阅护栏和限制。

范围

以下列表描述了字段发现代理可以执行的任务；在依赖该代理用于工作流之前，使用它确认该代理是否可以满足您的请求。

超出范围

下表描述了字段发现代理不执行的操作；使用它可避免依赖代理执行其范围之外的工作。

护栏和限制 guardrails-and-limitations

这些护栏很重要，因为Field Discovery Agent在影响结果可用性和质量的平台级别限制内运行。 使用它们来解释缺失、延迟或不完整的结果，并解决与现实期望之间的意外差距。

知识库

Field Discovery Agent依赖于知识库，该知识库定期使用Experience Platform环境中的架构和元数据刷新。 结果反映查询时知识库的状态，而非架构的实时状态，并且在数据摄取和代理中显示数据之间可能会出现延迟。

添加到环境的新架构、字段或数据集可能不会立即显示在字段发现代理结果中。 结果可能需要一段时间才能反映最近的更改。

元数据质量和覆盖范围

结果质量取决于Experience Platform环境中字段元数据的质量和完整性。 代理使用字段名称、显示名称、说明和用法关联对结果进行排名。 元数据较差或缺失的字段可能在结果中不会显示，或排名可能低于预期。

如果您具有架构编辑权限，可以通过以下方式提高结果质量：

有关在架构编辑器中编辑字段显示名称和描述的指导，请参阅在UI中创建和编辑架构。

如果您没有架构编辑访问权限，且结果一直不佳，请联系您的Experience Platform管理员或数据工程团队以查看您所使用的架构的字段元数据。

访问和PII限制

字段发现代理遵循所有现有的Experience Platform访问控制，并在当前沙盒上下文中操作。 您只会收到您有权访问的架构和数据集中字段的结果。

示例值由相同的数据集级别权限控制。 仅当您具有所需的访问权限时，启用PII限制的配置文件数据集中的字段才会返回示例值。 有关处理指导，请参阅示例值。 字段发现代理不会绕过字段级安全性或启用配置文件的访问限制。

最佳实践 best-practices

请遵循以下指导从Field Discovery Agent获取准确、可操作的结果。

示例提示 example-prompts

将此部分用作快速引用提示库。 如果您是字段发现代理的新用户，请先阅读最佳实践和支持的用例，以了解每个函数何时应用以及应用的原因。

标识提示

当您知道您需要的数据概念，但不知道哪个字段包含它时，可以使用这些提示。

“哪个字段代表客户的州或地区？”
“查找与电子邮件订阅状态相关的字段。”
“哪个字段包含客户首次购买的日期？”
“标识表示客户存留期值的字段。”
“我的个人资料架构中的哪些字段与忠诚度计划会员资格相关？”

推荐提示

在启动工作流并需要有关特定目标应包含哪些字段的指导时，请使用这些提示。

“我应该使用哪些字段来构建重新参与受众？”
“针对在90天内未购买的客户，推荐受众的字段。”
“哪些字段对建模流失风险最有用？”
“在创建地域划分时建议我应该包括的字段。”
“我正在构建购买倾向模型。我应该从哪些字段开始？”

扩充提示

当具有候选字段并希望在将其用于区段、查询或映射之前验证该字段时，使用这些提示。

“告诉我有关homeAddress.stateProvince的更多信息。”
“显示commerce.purchases.value的示例值。”
“在我的数据集和受众中，在哪里使用了person.name.lastName？”
“哪些数据集包含字段web.webPageDetails.URL？”
“是否将segmentMembership映射到任何活动目标？”

故障排除 troubleshooting

当结果缺失、意外或您不确定字段发现代理是否处理了您的请求时，请使用此部分。

要验证哪个代理处理了您的请求，请参阅使用字段发现代理中的步骤6。