欄位探索代理程式

在Adobe Experience Platform中建立對象或上線資料時，識別商業概念的正確XDM欄位通常需要手動瀏覽結構或預先知道欄位的命名方式。 不同的欄位可能會以不同的名稱（例如，狀態、區域和位置）呈現相同的概念，而選擇錯誤的欄位會導致下游工作流程發生錯誤。

欄位探索代理程式是Adobe Experience Platform中的AI支援代理，可幫助您使用AI助理中的自然語言查詢來尋找、評估和選擇XDM欄位。 您可以用簡單的語言描述您要尋找的內容（商業概念、工作流程目標或特定欄位名稱），而代理程式會傳回含有支援內容的排名欄位建議。

當其他Experience Platform代理程式需要解析欄位或實體參照時，會在AI助理的背景中自動叫用欄位探索代理程式。 在這些情況下，它會在背景執行，以改善您所使用的代理程式的正確性。 當您需要自己的工作欄位探索時，請在AI助理中撰寫明確的欄位探索提示。 欄位探索代理程式只會顯示欄位資訊。 它不會修改結構描述、資料集或對象，並會尊重您現有的存取控制項和沙箱內容。

使用時機 when-to-use-this

當您需要排名的欄位建議、範例值和對應、細分或查詢的使用方式內容時，請在AI Assistant中明確使用欄位探索代理程式。 當另一個Experience Platform代理程式在背景呼叫它以解析欄位或實體參照時，它會隱含使用。 在這些情況下，您會停留在該代理程式的工作流程中，不會發出單獨的欄位尋找提示。

先決條件 prerequisites

若要使用Field Discovery Agent，請確認您具備下列專案：

對於XDM結構描述以及欄位在分段或資料工作流程中的使用方式有基本的瞭解，可以幫助您更有效地解讀結果。 如需詳細資訊，請參閱XDM概觀和結構描述編輯器檔案。

如需啟用AI助理存取許可權和授與必要許可權的指示，請參閱Agent Orchestrator存取指南。

欄位探索代理程式功能 field-discovery-agent-functions

欄位探索代理程式會處理您的查詢，並根據您的意圖傳回三種輸出型別之一。 這些函式反映代理程式解譯查詢的方式；您不需要選取它們。 代理程式會根據您描述的內容自動決定適當的回應型別。

欄位探索代理程式的運作方式 how-field-discovery-agent-works

從高層面來看，代理程式會解譯您的意圖、搜尋您的可用資料，以及依關聯性將結果排名。 查詢的措辭方式會直接影響每個階段，進而影響結果的品質。

當您在AI Assistant中提交查詢時，「欄位探索代理程式」會分三個階段處理您的要求：

瞭解您的結果 understand-your-results

欄位探索代理程式會傳回每個查詢的結構化結果集。 瞭解結果的元件可協助您評估候選欄位，並在沒有其他試驗和錯誤的情況下自信地對其採取行動。

當欄位的​ 關聯性 ​標籤為​高度關聯性，其範例值符合您預期的資料（可用時），且其​ 使用內容 ​符合您打算使用的方式時，將欄位視為準備使用。 如果結果只有​ 適度相關 ​或​相關、範例值不符合您的預期，或使用內容有限，請先調整您的查詢並檢閱新的結果集，然後再繼續。

關聯性標籤

欄位探索代理程式會針對每個欄位結果，在​ 已識別欄位 ​面板的​ 關聯性 ​欄中指派關聯性標籤，以表示欄位與查詢的符合程度。

如果所有結果都標示為​ 適度相關 ​或​相關，而非​高度相關，則您的查詢可能太廣泛，或使用的術語不符合您的結構描述中繼資料。 使用反映欄位命名方式的更具體的語言或網域辭彙來調整您的提示。

值範例

除了每個欄位建議外，欄位探索代理程式還會顯示從您沙箱中欄位資料提取的範例值。 範例值可協助您在選取欄位之前，先驗證欄位是否包含您期望的資料型別。

樣本值僅對資料集存取許可權內的欄位可見。 如需Experience Platform中資料控管和使用限制的相關資訊，請參閱資料控管概觀。

如果欄位未出現範例值，則目前沙箱中的欄位可能為空白，或您的許可權可能不包括其基礎資料集的存取權。 基數高的欄位（例如識別碼或UUID欄位）可能不會傳回代表性範例值。 範例值會彙總且以頻率為基礎，無法追蹤至個別設定檔。

使用內容

每個欄位結果都包含使用內容，說明欄位在資料生態系統中的顯示位置：

對象→資料集→目的地→結構描述

用於已發佈對象的欄位，會顯示在作用中的資料集中，對應到即時目的地，並在結構描述中定義的欄位，已在您的環境中示範實際使用情況。 這會區分活躍依賴的欄位和僅存在於結構描述定義中，但未實際使用的欄位。 將此訊號與關聯性標籤和範例值搭配使用，以進行更明智的欄位選擇。

AI助理中的結果

欄位探索代理程式傳回AI助理回應中​ 識別欄位 ​面板的結果。 面板會顯示一個包含三欄的表格：

已說明的結果​區段會顯示在​ 已識別欄位 ​表格下方，並提供額外的欄位層級內容，包括每個結果的說明與支援詳細資料。 如需導覽AI助理介面的指南，請參閱AI助理使用者介面指南。

使用欄位探索代理程式 use-field-discovery-agent

您使用自然語言透過AI助理與欄位探索代理程式互動。 代理程式需要明確的意向宣告 — 模糊或過於簡短的查詢會產生低品質的結果，或根本不會叫用Field Discovery Agent。

若要明確探索欄位，請遵循此工作流程：識別屬性或對應問題、提交欄位尋找查詢、檢閱​ 識別欄位 ​面板中的排名結果和使用狀況內容、選取符合您意圖的​ 欄位名稱 ​路徑，並在區段產生器、查詢服務或其他工作流程中套用該XDM路徑。

使用欄位探索代理程式：

如有需要，請選取回應上方的​ 推理完成 ​下拉式清單，以確認欄位探索代理程式已處理您的要求。 下拉式清單會顯示推理詳細資訊，指出呼叫的代理程式。

如需AI助理介面的相關指引，請參閱AI助理使用者介面指南。

支援的使用案例 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在會影響結果可用性和品質的平台層級限制內運作。 使用這些量度來解譯遺失、延遲或不完整的結果，並疑難排解實際期望中的意外差距。

知識庫

欄位探索代理程式依賴的知識庫會定期以您Experience Platform環境中的結構描述和中繼資料重新整理。 結果會反映查詢時知識庫的狀態，而非結構描述的即時狀態，而且在資料擷取與顯示在代理程式中之間可能會有延遲。

新增到您環境的新結構描述、欄位或資料集可能不會立即顯示在欄位探索代理程式結果中。 結果可能需要一段時間才能反映最近的變更。

中繼資料的品質和涵蓋範圍

結果品質取決於Experience Platform環境中欄位中繼資料的品質和完整性。 代理程式會使用欄位名稱、顯示名稱、說明及使用關聯來排名結果。 含有不良或遺失中繼資料的欄位可能不會出現在結果中，或排名可能低於預期。

如果您擁有結構描述編輯存取權，可以透過以下方式改善結果品質：

如需在結構描述編輯器中編輯欄位顯示名稱和說明的指南，請參閱在UI中建立和編輯結構描述。

如果您沒有結構描述編輯存取權，且結果持續不佳，請聯絡您的Experience Platform管理員或資料工程團隊，以檢閱您使用之結構描述的欄位中繼資料。

存取和PII限制

欄位探索代理程式會遵從所有現有的Experience Platform存取控制，並在您目前的沙箱內容中運作。 您只會收到您有權存取的結構描述和資料集中欄位的結果。

範例值是由相同的資料集層級許可權所控管。 具有PII限制的已啟用設定檔資料集中的欄位，只有在您具有必要存取權時才傳回範例值。 如需處理指引，請參閱範例值。 欄位探索代理程式不會略過欄位層級安全性或設定檔啟用的存取限制。

最佳做法 best-practices

使用下列指南從欄位探索代理程式取得準確、可操作的結果。

提示範例 example-prompts

使用此區段作為快速參考提示程式庫。 如果您是欄位探索代理程式的新手，請先閱讀最佳實務和支援的使用案例，瞭解每個函式何時及為何適用。

識別提示

當您知道您需要資料的概念，但不知道哪個欄位持有資料概念時，請使用這些提示。

「哪個欄位包含客戶的州或地區？」
「尋找與電子郵件訂閱狀態相關的欄位。」
「哪個欄位包含客戶首次購買的日期？」
“識別代表客戶期限值的欄位。”
「我的設定檔結構描述中的哪些欄位與熟客方案會員資格有關？」

建議提示

當您開始工作流程，並需要有關特定目標要包含哪些欄位的指引時，請使用這些提示。

「應使用哪些欄位來建立重新參與對象？」
「針對90天內未購買的客戶定位對象，提供建議欄位。」
「哪些欄位對模型化流失風險最有用？」
「建立地理細分時建議我應該包含的欄位。」
「我正在建立購買傾向模型。我該從哪些欄位開始？」

擴充提示

當您有候選欄位且想在區段、查詢或對應中使用它之前驗證它時，請使用這些提示。

「告訴我有關homeAddress.stateProvince的更多資訊。」
“顯示commerce.purchases.value的範例值。”
「我的資料集和對象在哪裡使用person.name.lastName？」
「哪些資料集包含欄位web.webPageDetails.URL？」
「是否將segmentMembership對應到任何使用中的目的地？」

疑難排解 troubleshooting

當結果遺失、未預期或您不確定欄位探索代理程式是否處理您的要求時，請使用此區段。

若要確認哪個代理程式處理您的要求，請參閱使用欄位探索代理程式中的步驟6。