필드 검색 에이전트

Adobe Experience Platform에서 대상을 작성하거나 데이터를 온보딩할 때 비즈니스 개념에 대한 올바른 XDM 필드를 식별하려면 종종 수동으로 스키마를 찾아보거나 필드 이름을 정확히 알고 있어야 합니다. 서로 다른 필드는 상태, 지역 및 위치와 같은 서로 다른 이름으로 동일한 개념을 나타낼 수 있으며 잘못된 필드를 선택하면 다운스트림 워크플로우에서 오류가 발생합니다.

Field Discovery Agent는 AI Assistant의 자연어 쿼리를 사용하여 XDM 필드를 찾고, 평가하고, 선택할 수 있도록 도와주는 Adobe Experience Platform의 AI 기반 에이전트입니다. 찾고 있는 내용을 비즈니스 개념, 워크플로 목표 또는 특정 필드 이름 등의 일반 언어로 설명하고 에이전트는 지원 컨텍스트와 함께 등급 필드 제안을 반환합니다.

다른 Experience Platform 에이전트가 필드 또는 엔티티 참조를 확인해야 하는 경우 Field Discovery Agent가 AI Assistant 내의 백그라운드에서 자동으로 호출됩니다. 이러한 경우 백그라운드에서 작동하여 작업 중인 에이전트의 정확도를 개선합니다. 자신의 작업에 대한 필드 검색이 필요한 경우 AI Assistant에 명시적인 필드 검색 프롬프트를 작성하십시오. 필드 검색 에이전트는 필드 정보만 표시합니다. 스키마, 데이터 세트 또는 대상은 수정하지 않으며 기존 액세스 제어 및 샌드박스 컨텍스트를 따릅니다.

사용 시기 when-to-use-this

매핑, 세그멘테이션 또는 쿼리에 대해 등급 필드 제안, 샘플 값 및 사용 컨텍스트가 필요한 경우 AI Assistant에서 명시적으로 Field Discovery Agent를 사용하십시오. 다른 Experience Platform 에이전트가 백그라운드에서 호출하여 필드 또는 엔티티 참조를 확인하는 경우에 암시적으로 사용됩니다. 이러한 경우 해당 에이전트의 워크플로우에 계속 머무르며 별도의 필드 검색 프롬프트를 발행하지 않습니다.

사전 요구 사항 prerequisites

Field Discovery Agent를 사용하려면 다음을 수행해야 합니다.

XDM 스키마 및 세그먼테이션 또는 데이터 워크플로우에서 필드를 사용하는 방법에 대한 기본 지식이 결과를 보다 효과적으로 해석하는 데 도움이 됩니다. 자세한 내용은 XDM 개요 및 스키마 편집기 설명서를 참조하십시오.

AI Assistant 액세스를 활성화하고 필요한 권한을 부여하는 방법에 대한 지침은 Agent Orchestrator 액세스 가이드를 참조하십시오.

필드 검색 에이전트 기능 field-discovery-agent-functions

Field Discovery Agent는 쿼리를 처리하고 의도에 따라 세 가지 출력 유형 중 하나를 반환합니다. 이러한 함수는 에이전트가 쿼리를 해석하는 방법을 반영합니다. 사용자는 이 함수를 선택하지 않습니다. 에이전트는 사용자가 설명하는 내용에 따라 적절한 응답 유형을 자동으로 결정합니다.

Field Discovery Agent 작동 방식 how-field-discovery-agent-works

높은 수준에서 에이전트는 사용자의 의도를 해석하고 사용 가능한 데이터를 검색하며 관련성을 기준으로 결과의 순위를 지정합니다. 쿼리를 구문하는 방식은 각 단계에 직접 영향을 미치며, 이는 결과적으로 결과 품질에 영향을 줍니다.

AI Assistant에서 쿼리를 제출하면 Field Discovery Agent가 다음 세 단계로 요청을 처리합니다.

결과 이해 understand-your-results

Field Discovery Agent는 각 쿼리에 대한 구조화된 결과 세트를 반환합니다. 결과의 구성 요소를 이해하면 추가 시행착오 없이 후보 필드를 평가하고 자신 있게 작업할 수 있습니다.

해당 관련성 레이블이 관련성이 높음​이고 해당 샘플 값이 예상한 데이터와 일치하며(가능한 경우) 해당 사용 컨텍스트​가 사용 계획에 맞는 경우 필드를 사용할 준비가 된 것으로 처리합니다. 결과가 보통 관련 또는 관련​에 불과하거나 샘플 값이 예상과 일치하지 않거나 사용 컨텍스트가 제한된 경우 쿼리를 세분화하고 새 결과 집합을 검토한 후 계속 진행하십시오.

관련성 레이블

필드 검색 에이전트는 각 필드 결과에 대해 식별된 필드 패널의 관련성 열에 해당 필드가 쿼리와 얼마나 가깝게 일치하는지 나타내는 관련성 레이블을 지정합니다.

모든 결과에 높은 관련성​이 아니라 보통 관련성 또는 관련성 레이블이 지정되는 경우 쿼리가 너무 광범위하거나 스키마 메타데이터와 일치하지 않는 용어를 사용할 수 있습니다. 필드 이름을 지정하는 방법을 반영하는 보다 구체적인 언어 또는 도메인 용어로 프롬프트를 구체화합니다.

샘플값

각 필드 제안과 함께 Field Discovery Agent는 샌드박스의 필드 데이터에서 추출한 샘플 값을 표시합니다. 샘플 값을 사용하면 필드를 선택하기 전에 예상하는 데이터 유형이 필드에 포함되어 있는지 확인하는 데 도움이 됩니다.

샘플 값은 데이터 세트 액세스 권한 내의 필드에 대해서만 표시됩니다. Experience Platform의 데이터 거버넌스 및 사용 제한에 대한 자세한 내용은 데이터 거버넌스 개요를 참조하십시오.

필드에 대한 샘플 값이 나타나지 않으면 현재 샌드박스의 필드가 비어 있거나 사용 권한에 기본 데이터 세트에 대한 액세스 권한이 포함되지 않을 수 있습니다. 카디널리티가 높은 필드(예: 식별자 또는 UUID 필드)도 대표 샘플 값을 반환하지 않을 수 있습니다. 샘플 값은 집계되고 빈도를 기반으로 하며 개별 프로필에서 추적할 수 없습니다.

사용 컨텍스트

각 필드 결과에는 데이터 에코시스템에서 필드가 표시되는 위치를 보여 주는 사용 컨텍스트가 포함됩니다.

대상 → 데이터 집합 → 대상 → 스키마

게시된 대상자에서 사용되고, 활성 데이터 세트에 나타나고, 라이브 대상에 매핑되고, 스키마에서 정의된 필드가 환경에서 실제 사용을 보여 줍니다. 이는 적극적으로 의존하고 있는 필드와 스키마 정의에만 존재하지만 실제로는 사용되지 않은 필드를 구별한다. 관련성 레이블 및 샘플 값과 함께 이 신호를 사용하여 보다 정보에 입각한 필드 선택을 만듭니다.

AI Assistant의 결과

필드 검색 에이전트가 AI Assistant 응답 내의 식별된 필드 패널에 결과를 반환합니다. 패널에는 다음과 같은 세 개의 열이 있는 테이블이 표시됩니다.

설명된 결과 섹션은 식별된 필드 테이블 아래에 표시되며 각 결과에 대한 설명 및 지원 세부 정보를 포함하여 추가적인 필드 수준 컨텍스트를 제공합니다. AI Assistant 인터페이스 탐색에 대한 지침은 AI Assistant UI 안내서를 참조하십시오.

필드 검색 에이전트 사용 use-field-discovery-agent

자연어를 사용하는 AI Assistant를 통해 Field Discovery Agent와 상호 작용합니다. 에이전트에는 명확한 의사 표시가 필요합니다. 모호하거나 지나치게 간단한 쿼리는 품질이 낮은 결과를 생성하거나 Field Discovery Agent를 전혀 호출하지 않을 수 있습니다.

명시적인 필드 검색을 수행하려면 다음 워크플로를 따르십시오. 특성 또는 매핑 문제를 식별하고 필드 검색 쿼리를 제출하고, 식별된 필드 패널에서 등급 결과와 사용 컨텍스트를 검토하고, 사용자의 의도에 맞는 필드 이름 경로를 선택하고, 세그먼트 빌더, 쿼리 서비스 또는 다른 워크플로에서 해당 XDM 경로를 적용합니다.

Field Discovery Agent를 사용하려면

필요한 경우 응답 위의 추론 완료 드롭다운을 선택하여 Field Discovery 에이전트가 요청을 처리했는지 확인합니다. 드롭다운에 호출된 에이전트를 나타내는 추론 세부 정보가 표시됩니다.

AI Assistant 인터페이스에 대한 지침은 AI Assistant 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

이 섹션에서는 Field Discovery Agent가 수행할 수 있는 작업과 수행할 수 없는 작업을 요약합니다. 자세한 작업 지침은 지원되는 사용 사례를 참조하세요. 플랫폼 제한에 대해서는 보호 기능 및 제한 사항을 참조하십시오.

범위 내

다음 목록에서는 Field Discovery Agent가 수행할 수 있는 작업을 설명합니다. 이 목록을 사용하여 워크플로우에서 요청을 활용하기 전에 에이전트가 요청을 충족할 수 있는지 여부를 확인합니다.

범위를 벗어남

다음 목록에서는 Field Discovery Agent가 수행하지 않는 작업을 설명합니다. 범위를 벗어나는 작업에 에이전트를 사용하지 않으려면 이 목록을 사용하십시오.

가드레일 및 제한 사항 guardrails-and-limitations

Field Discovery Agent는 결과 가용성과 품질에 영향을 미치는 플랫폼 수준의 제약 조건 내에서 작동하므로 이러한 보호 기능이 중요합니다. 이를 사용하여 누락, 지연 또는 불완전한 결과를 해석하고 현실적인 기대치로 예상치 못한 차이를 해결합니다.

기술 자료

Field Discovery Agent는 Experience Platform 환경의 스키마 및 메타데이터를 통해 정기적으로 새로 고쳐지는 기술 자료를 활용합니다. 결과는 스키마의 실시간 상태가 아닌 쿼리 시점의 기술 자료 상태를 반영하며, 데이터 수집과 에이전트가 표시되는 시점 사이에 지연이 있을 수 있습니다.

환경에 추가된 새 스키마, 필드 또는 데이터 세트가 Field Discovery Agent 결과에 즉시 표시되지 않을 수 있습니다. 최근 변경 사항을 반영하는 데 시간이 걸릴 수 있습니다.

메타데이터 품질 및 적용 범위

결과 품질은 Experience Platform 환경에서 필드 메타데이터의 품질과 완전성에 따라 다릅니다. 에이전트는 필드 이름, 표시 이름, 설명 및 사용 연관을 사용하여 결과의 등급을 지정합니다. 메타데이터가 부족하거나 누락된 필드는 결과에 표시되지 않거나 예상보다 낮은 등급을 지정할 수 있습니다.

스키마 편집 액세스 권한이 있는 경우 다음을 수행하여 결과 품질을 향상시킬 수 있습니다.

스키마 편집기의 필드 표시 이름 및 설명 편집에 대한 지침은 UI에서 스키마 만들기 및 편집을 참조하십시오.

스키마 편집 액세스 권한이 없고 결과가 일관되게 좋지 않은 경우 Experience Platform 관리자 또는 데이터 엔지니어링 팀에 문의하여 작업 중인 스키마에 대한 필드 메타데이터를 검토하십시오.

액세스 및 PII 제한

필드 검색 에이전트는 기존의 모든 Experience Platform 액세스 제어를 준수하며 현재 샌드박스 컨텍스트 내에서 작동합니다. 액세스할 권한이 있는 스키마 및 데이터 세트의 필드에 대한 결과만 받습니다.

샘플 값은 동일한 데이터 세트 수준 권한에 의해 관리됩니다. PII 제한이 있는 프로필 지원 데이터 세트의 필드는 필요한 액세스 권한이 있는 경우에만 샘플 값을 반환합니다. 처리 지침은 샘플 값을 참조하세요. Field Discovery Agent는 필드 수준 보안 또는 프로필 사용 액세스 제한을 무시하지 않습니다.

모범 사례 best-practices

다음 지침을 사용하여 Field Discovery Agent에서 정확하고 실행 가능한 결과를 얻을 수 있습니다.

프롬프트 예 example-prompts

이 섹션을 빠른 참조 프롬프트 라이브러리로 사용합니다. Field Discovery Agent를 처음 사용하는 경우 먼저 모범 사례 및 지원되는 사용 사례를 읽어 각 함수가 적용되는 시기와 이유를 알아보십시오.

식별 프롬프트

필요한 데이터 개념을 알고 있지만 어느 필드에 데이터 개념이 들어 있는지 모르는 경우 이 프롬프트를 사용합니다.

“고객의 주 또는 지역을 포함하는 필드는 무엇입니까?”
“전자 메일 구독 상태와 관련된 필드를 찾습니다.”
“고객의 첫 구매 날짜가 포함된 필드는 무엇입니까?”
“고객 라이프타임 값을 나타내는 필드를 식별합니다.”
“충성도 프로그램 멤버십과 관련된 내 프로필 스키마의 필드는 무엇입니까?”

권장 사항 프롬프트

워크플로우를 시작하고 특정 목표에 포함할 필드에 대한 지침이 필요할 때 이러한 프롬프트를 사용합니다.

“재참여 대상자를 만드는 데 어떤 필드를 사용해야 합니까?”
“90일 동안 구매하지 않은 고객을 타겟팅하는 대상을 위한 필드를 추천합니다.”
“이탈 위험을 모델링하는 데 가장 유용한 필드는 무엇입니까?”
“지리적 세분화를 만들 때 포함해야 하는 필드를 제안합니다.”
“구매 성향 모델을 만들고 있습니다. 어떤 필드로 시작해야 합니까?”

데이터 보강 프롬프트

후보 필드가 있고 세그먼트, 쿼리 또는 매핑에서 사용하기 전에 이를 확인하려는 경우 이 프롬프트를 사용합니다.

“homeAddress.stateProvince에 대해 자세히 알려주세요.”
“commerce.purchases.value의 샘플 값을 표시합니다.”
“내 데이터 세트와 대상 전체에서 person.name.lastName이(가) 사용되는 위치는 어디입니까?”
“필드 web.webPageDetails.URL을(를) 포함하는 데이터 세트는 무엇입니까?”
“활성 대상에 segmentMembership이(가) 매핑되어 있습니까?”

문제 해결 troubleshooting

결과가 없거나 예기치 않거나 Field Discovery Agent에서 요청을 처리했는지 확실하지 않은 경우 이 섹션을 사용합니다.

어떤 에이전트가 요청을 처리했는지 확인하려면 필드 검색 에이전트 사용의 6단계를 참조하세요.