비정형 데이터를 포함한 실시간 고객 프로필을 사용하여 고객 대화 개인화

마지막 업데이트: 2026년 10월 29일

주제:
Customer profiles

작성 대상:

사용자

AVAILABILITY

이 기능은 현재 베타에 있습니다. 기능 및 설명서는 변경될 수 있습니다. 이 Beta에 참여하려면 Adobe 고객 지원 센터 또는 계정 담당자에게 문의하십시오.

Adobe Experience Platform에서는 여러 채널의 데이터를 실시간 고객 프로필과 결합하여 고객 데이터를 통합 보기로 통합할 수 있습니다. 비정형 데이터에 대한 지원을 통해 Experience Platform은 이러한 기능을 확장함으로써 대화 및 기타 비정형 고객 데이터를 프로필 기본 구성의 일부로 사용할 수 있도록 합니다.

비정형 데이터를 사용한 프로필 이해 understanding

실시간 고객 프로필은 현재 온라인, 오프라인, CRM 및 서드파티를 비롯한 여러 채널의 구조화된 데이터를 결합하여 이 데이터를 모든 고객 상호 작용에 대해 실행 가능하고 타임스탬프가 지정된 계정을 제공하는 통합 보기로 통합합니다. 그러나 비정형 데이터 수집은 다루지 않습니다. 즉, 대화, 성적 증명서 또는 기타 복합 데이터(예: PDF 또는 이미지)의 데이터를 프로필에서 사용할 수 없습니다.

비정형 데이터가 있는 프로필을 사용하면 처리되지 않은 데이터에 액세스할 수 있습니다. 이렇게 하면 Brand Concierge을 비롯한 여러 플랫폼에서 고객 컨텍스트가 계속 공유되므로 대화를 개인화할 수 있습니다.

비정형 데이터가 있는 프로필은 Experience Platform 고객에게 다음과 같은 기능을 제공합니다.

고객 의도 이해: 대화, 메시지, 검색 쿼리, 통화 성적 증명서, 설문 조사 및 기타 텍스트 기반 상호 작용을 수집하여 기존 고객 프로필을 보강합니다.
대화 개인화: 프로필 속성, 대상 멤버십 및 대화 기록을 함께 결합하여 Brand Concierge 및 다른 고객용 에이전트가 에이전트, 세션, 장치 및 채널 전반에 연속성을 유지하며 개인화된 경험을 제공할 수 있도록 합니다.
실시간으로 의도 활성화: 대화에서 마케터가 정의한 신호를 추출하고 대상, 여정 및 개인화를 통해 활성화합니다. 이러한 다운스트림 활성화는 Adobe Journey Optimizer 및 Target을 포함하여 Experience Platform 전체에서 사용할 수 있습니다.

사용 사례 use-cases

비정형 데이터가 있는 프로필을 사용하면 대화형 데이터를 추가 참여를 위한 활성화 신호로 사용할 수 있으므로 인바운드 개인화 및 아웃바운드 활성화를 보다 쉽게 유도할 수 있습니다. 따라서 다양한 사용 사례에서 이러한 프로필을 사용할 수 있습니다.

관심 기반 활성화: 소매업으로서 인증된 쇼핑객은 대화에서 식사 환경 설정을 언급합니다. 추출된 신호는 “글루텐이 없는” 관심 대상을 나타내며, 맞춤 오퍼 및 여정과 같은 인바운드 및 아웃바운드 활성화에 사용할 수 있습니다.
부정적인 경험 억제: 소매 업계의 경우 고객의 대화에서 좌절이 감지됩니다. 그러면 이 고객은 음소거 아웃바운드 메시지를 보내지 않도록 홍보 대상으로부터 차단됩니다.
의도 기반 라우팅 및 다음 세션 개인화: 금융 서비스 또는 핀테크 회사의 고객은 대화에서 라이프이벤트(예: “기혼”, “이동한 상태” 또는 “새 작업”)를 언급합니다. 이러한 키워드는 관련 도메인 전문 지식을 갖춘 어드바이저와 고객을 일치시키기 위해 다음 세션을 개인화하는 데 추출되고 사용됩니다.

샘플 흐름 sample-flow

고객에게 금융 서비스를 제공하는 회사를 생각해 보자.

이 시나리오에서는 클라이언트 중 한 명이 에이전트에게 지분에 대해 질문합니다. 이 클라이언트가 로그인되어 있으므로 에이전트는 실시간 고객 프로필을 읽어서 이 사용자에 대해 알게 됩니다.

그리고 나서 이 고객은 "나는 앉아서 내 은퇴 저축을 정말로 검토하려고 했는데, 단지 그것을 예약하는 것에 익숙하지 않았다."라고 말하면서 대화를 계속합니다. Brand Concierge과 Experience Platform은 비정형 데이터에 프로필을 사용함으로써 이러한 대화에서 의도를 추출하여 에이전트를 통해 개인화된 응답을 보낼 수 있습니다.

그 결과 Experience Platform은 이 고객이 “재무 계획 관심사” 대상자를 입력하도록 할 수 있으며, 즉시 에이전트를 개인화하여 "은퇴 계획이 정상적으로 진행되고 있는지 확인하겠습니다. Alex Agent와 무료 체크인을 예약하십시오."라고 응답하도록 할 수 있습니다.

또한 이 컨텍스트는 모든 Experience Platform 애플리케이션 간에 공유되므로 여러 양식에서 종료 대화를 계속할 수 있습니다. 예를 들어 Adobe Journey Optimizer은 Alex Agent와의 사용 중지 체크인 초대가 포함된 이메일을 자동으로 클라이언트에 보낼 수 있습니다.

Beta 사전 요구 사항 prerequisites

비정형 데이터가 있는 프로필을 사용하려면 다음 전제 조건을 충족해야합니다.

이미 기존 Adobe Experience Platform 사용자
Healthcare Shield 추가 기능이 없는

이러한 전제 조건을 모두 충족하면 Adobe 고객 지원 센터에 문의하여 비정형 데이터를 사용한 프로필 활성화를 요청하는 방법에 대한 자세한 내용을 확인하십시오.

요구 사항 requirements

비정형 데이터를 설정하여 프로필을 계속하기 전에 다음 단계를 완료해야 합니다.

ID 그래프 연결 규칙 사용
프로필 활성화 데이터 세트 만들기
- 이 데이터 세트에 하나 이상의 프로필 수집

비정형 데이터가 있는 프로필 이 활성화되면 다음 단계를 설정하여 이 기능을 사용할 수 있습니다.

Experience Platform에서 비정형 데이터 수집
대화를 개인화하도록 프로필 컨텍스트를 구성합니다
활성화를 위해 구조화되지 않은 데이터에서 데이터를 추출하도록 신호 구성

비정형 데이터 수집 ingest

구조화되지 않은 데이터를 개인화 프로세스의 일부로 사용하려면 먼저 해당 데이터를 Experience Platform으로 수집해야 합니다.

비정형 데이터를 수집하는 방법은 비정형 데이터의 출처에 따라 다르다.

표준 원시 텍스트

원시 텍스트가 있는 표준 단순 ID 사용 사례의 경우 ExperienceEvent 스키마 및 데이터 세트를 사용하여 Experience Platform에 데이터를 수집할 수 있습니다. 대본, 대화, 메모 및 리뷰를 포함하여 대부분의 사용 사례에 가장 잘 사용됩니다.

스키마 만들기

note important
IMPORTANT
스키마 및 데이터 집합을 만들 때 프로필 또는 ID에 대해 활성화하지 마십시오.

먼저 데이터 세트에 대한 XDM ExperienceEvent 스키마를 만들어야 합니다. 이 스키마에는 다음 정보가 포함되어야 합니다.

unstructuredContent 필드 그룹입니다. 구조화되지 않은 콘텐츠 필드 그룹에 대한 자세한 내용은 XDM GitHub를 참조하십시오.
알려진 개인을 표시할 ID입니다. 이 ID는 ID 맵 또는 ID 설명자로 표시된 필드일 수 있습니다.

스키마를 만드는 방법을 알아보려면 스키마 만들기를 읽어 보세요.

데이터 세트 만들기

스키마를 만든 후에는 이 스키마를 사용하는 데이터 세트를 만들 수 있습니다. 기존 스키마를 기반으로 데이터 집합을 만드는 방법을 알아보려면 데이터 집합 만들기 안내서를 읽어 보세요.

데이터 세트를 만든 후에는 새로 만든 데이터 세트의 ID를 제공하는 동안 v2/dataSets 끝점에 대한 PATCH 요청을 만들 수 있습니다. 이렇게 하면 구조화되지 않은 데이터로 프로필에서 사용할 데이터 세트를 업데이트할 수 있습니다.

accordion

비정형 데이터가 있는 프로필에 대한 데이터 세트를 활성화하는 샘플 패치 요청 및 응답.

code language-shell

curl -X PATCH https://platform.adobe.io/data/foundation/catalog/v2/dataSets/67b3077efa10d92ab7a71858
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {
        "adobe_unifiedProfile": {
            "semanticProfile": {
                "enablement": {
                    "status": "READY"
                }
            }
        },
        "adobe_dataContent": {
            "channel": "call_transcripts"
        }
    }
  }'

성공적인 응답은 새로 업데이트된 데이터 세트의 ID와 함께 HTTP 상태 200을 반환합니다.

code language-json
`[ "@/dataSets/67b3077efa10d92ab7a71858" ]`

데이터 수집

스키마와 데이터 세트가 설정되었으므로 이제 Experience Platform으로 데이터 수집을 시작할 수 있습니다. CSV, JSON 및 Parquet가 모두 지원되므로 표준 소스 커넥터를 사용하여 데이터를 Experience Platform에 로드할 수 있습니다. 데이터를 수집할 때 구조화되지 않은 텍스트를 rawText 필드에 입력하고 identity 열의 ID를 지정합니다.

이제 조직 ID, 샌드박스 정보, 데이터 세트 정보 및 수집 방법(원시 텍스트 XDM이 있는 단순 ID)과 같은 정보를 사용하여 Adobe 고객 지원 센터에 문의하여 데이터 수집 설정을 완료할 수 있습니다.

WhatsApp 비즈니스

note availability
AVAILABILITY
WhatsApp 커넥터가 닫힌 베타에 있습니다.

WhatsApp 커넥터를 설정하는 방법에 대해 알아보려면 WhatsApp 커넥터 안내서를 참조하십시오.

WhatsApp 커넥터를 설정하면 WhatsAppWebhook Raw 이벤트 데이터 세트가 자동으로 만들어집니다. 이 데이터 세트는 채널 정보도 적용된 구조화되지 않은 데이터가 있는 프로필에 대해 자동으로 활성화됩니다.

WhatsApp 커넥터를 설정한 후 조직 ID, 샌드박스 정보, 채널(WhatsApp 비즈니스) 및 비정형 데이터가 있는 프로필에 사용할 커넥터에 대한 모드(스트리밍 또는 일괄 처리) 등의 정보를 사용하여 Adobe 고객 지원 센터에 문의하십시오.

Brand Concierge 대화

Brand Concierge 대화의 경우 사용자 프롬프트, 에이전트 응답 및 피드백을 추적하는 세 개의 데이터 세트가 자동으로 생성됩니다.

구조화되지 않은 데이터가 있는 프로필에 대해 이러한 데이터 세트를 활성화하려면 세 데이터 세트 각각의 ID를 제공하는 동시에 v2/dataSets 끝점에 대한 PATCH 요청을 수행해야 합니다.

accordion

비정형 데이터가 있는 프로필에 대한 데이터 세트를 활성화하는 샘플 패치 요청 및 응답.

code language-shell

curl -X PATCH https://platform.adobe.io/data/foundation/catalog/v2/dataSets/67b3077efa10d92ab7a71858
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {
        "adobe_unifiedProfile": {
            "semanticProfile": {
                "enablement": {
                    "status": "READY"
                }
            }
        }
    }
  }'

성공적인 응답은 새로 업데이트된 데이터 세트의 ID와 함께 HTTP 상태 200을 반환합니다.

code language-json
`[ "@/dataSets/67b3077efa10d92ab7a71858" ]`

프로필 컨텍스트 구성

구조화되지 않은 데이터를 Experience Platform으로 수집한 후 프로필 컨텍스트를 구성하여 대화를 개인화할 수 있습니다. Coworker 또는 Experience Platform API를 사용하여 이 프로필 설명을 구성할 수 있습니다.

CX Enterprise Coworker

Coworker 내에서 "의미 체계 프로필 구성을 만들겠습니다."를 선택하여 설정을 시작할 수 있습니다.

동료는 다음 단계를 진행하여 비정형 데이터로 프로필을 설정하는 단계를 안내합니다.

동료가 "사용 사례는 무엇입니까?"에 문의할 것입니다.
사용 사례를 설명한 후 Coworker는 사용 사례를 기반으로 관련 속성 목록을 제공합니다
특성이 제대로 표시되는지 확인하면 Coworker가 다음 작업을 확인합니다. 기본적으로 Coworker에는 대상 설명 no개, 프로필 설명 precise개, 데이터 거버넌스 레이블 no개 및 사용자 네임스페이스 default개가 있습니다.
- 대상자 설명을 프로필 내러티브에 추가하려면
- 프로필 묘사의 정확성
- 데이터 거버넌스 레이블 추가 및 개인 네임스페이스 설정

이러한 단계를 거치고 나면 구조화되지 않은 데이터 컨텍스트가 있는 프로필이 만들어집니다.

API 호출

Experience Platform API를 사용하여 구조화되지 않은 데이터 컨텍스트로 프로필을 설정할 수 있습니다.

계속하기 전에 시작 안내서를 참조하여 관련 설명서에 대한 링크, 이 섹션의 샘플 API 호출 읽기 지침 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요 정보를 확인하십시오.

범주 가져오기 get-categories

먼저 프로필 컨텍스트에 대한 범주를 가져와야 합니다. 범주는 샌드박스에서 사용할 수 있는 프로필 속성 그룹입니다.

API 형식

code language-http
`GET /semanticprofile/config/category`

요청

다음 요청은 샌드박스 내에서 사용 가능한 모든 카테고리와 해당 속성의 목록을 검색합니다.

accordion

사용 가능한 카테고리를 검색하기 위한 샘플 요청입니다.

code language-shell

curl -X GET https://platform.adobe.io.data/core/semanticprofile/config/category \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공적인 응답은 조직과 샌드박스에 사용할 수 있는 범주 목록이 포함된 HTTP 상태 200을 반환합니다.

accordion

조직 및 샌드박스에 속하는 카테고리 및 속성 목록을 포함하는 샘플 응답

code language-json

{
  "requestId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "result": [
    {
      "categories": [
        {
          "name": "Customer Demographics",
          "attributes": [
            "person.name.firstName",
            "person.name.lastName",
            "person.gender",
            "person.maritalStatus"
          ]
        },
        {
          "name": "Contact Information",
          "attributes": [
            "personalEmail.address",
            "mobilePhone.number"
          ]
        }
      ]
    }
  ]
}

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
필드	유형	설명
`requestId`	문자열	요청에 대한 고유 ID입니다.
`result`	배열	샌드박스에 사용할 수 있는 카테고리를 포함하는 배열입니다.
`categories.name`	문자열	범주의 이름입니다.
`categories.attributes`	배열	범주 내에서 사용 가능한 속성 목록을 포함하는 배열입니다.

구성 만들기

샌드박스에 사용할 수 있는 범주를 가져온 후 구성을 만들 수 있습니다. 구성에는 프로필 데이터의 카테고리와 속성, 강조할 대상, 마케팅 작업, 내러티브 정밀도와 네임스페이스가 포함됩니다.

API 형식

code language-http
`POST /semanticprofile/config/configuration`

요청

다음 요청은 지정된 대상, 마케팅 작업 없음, 퍼지 서술형 정밀도 및 이메일 네임스페이스를 포함하여 고객 인구 통계 범주를 사용하여 구조화되지 않은 데이터 구성으로 프로필을 만듭니다.

accordion

프로필 구성을 만들기 위한 샘플 요청입니다.

code language-shell

curl -X POST https://platform.adobe.io/data/core/semanticprofile/config/configuration \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "data": {
        "name": "CustomerSummary":,
        "configurationDetails": {
            "category": [
                {
                    "name": "Customer Demographics",
                    "attributes": [
                        "person.name.firstName",
                        "person.name.lastName"
                    ]
                }
            ],
            "segments": {
                "limit": 1,
                "selection_mode": "inclusion",
                "inclusion": [
                    {
                        "id": "b2cf20ca-5d07-4ef2-b50a-994eb2c11349",
                        "priority": "1"
                    }
                ],
                "exclusion": []
            },
            "marketingActions": [],
            "narrative_precision": "fuzzy",
            "personNamespace": {
                "isPersonNamespaceEnabled": true,
                "code": ["Email"]
            }
        }
    }
 }'

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4
필드	필수	유형	설명
`name`	예	문자열	구성의 이름입니다. 이 API는 Narrative API에서 키로 사용됩니다.
`configurationDetails`	예	개체	카테고리, 대상 세부 정보, 마케팅 작업, 내러티브 정밀도 및 네임스페이스를 포함하여 구성에 대한 세부 정보가 포함된 객체입니다.
`category`	예	배열	구성에 사용할 범주에 대한 정보가 포함된 배열입니다.
`category.name`	예	문자열	사용할 범주의 이름입니다. 이 must은(는) GET 범주 API 호출의 값과 일치합니다.
`category.attributes`	예	배열	사용할 속성 배열입니다. 이 특성 must은(는) 사용한 범주에 속합니다.
`segments`	아니오	개체	구성에 추가하려는 대상이 포함된 객체입니다.
`segments.limit`	아니오	숫자	구성에 추가할 최대 대상자 수입니다.
`segments.selection_mode`	아니오	문자열	대상자를 선택하는 메서드입니다. 현재 `inclusion`만 지원됩니다.
`segments.inclusion`	아니오	배열	포함할 대상이 포함된 배열입니다. 대상자는 세그먼트 정의 ID와 우선 순위를 모두 포함하는 객체로 작성됩니다. 여기서 낮은 숫자가 높은 우선 순위를 의미하므로 "1"이 가장 높은 우선 순위입니다.
`marketingActions`	아니오	배열	구성에 적용할 마케팅 작업이 포함된 배열입니다. 마케팅 액션에 대한 자세한 내용은 마케팅 액션 끝점 안내서를 참조하십시오.
`narrativePrecision`	아니오	문자열	구성 서술의 정밀도 수준입니다. 지원되는 값은 `precise`, `fuzzy` 및 `value_only`입니다.
`personNamespace`	아니오	개체	구성에 대한 ID 네임스페이스의 세부 정보가 포함된 객체입니다. 이 필드를 비워 두면 샌드박스의 기본 네임스페이스가 사용됩니다.
`personNamespace.isPersonNamespaceEnabled`	아니오	부울	`true`(으)로 설정하면 `personNamespace.code`에 나열된 네임스페이스가 사용됩니다. 그렇지 않으면 샌드박스의 기본 네임스페이스가 사용됩니다.
`personNamespace.code`	아니오	배열	서사에서 사용할 ID 네임스페이스 코드를 나열하는 배열입니다.

응답

성공적인 응답은 고유한 요청 ID와 새로 생성된 구성의 세부 정보와 함께 HTTP 상태 200을 반환합니다.

accordion

새로 생성된 구성이 포함된 샘플 응답입니다.

code language-json

{
    "requestId": "aaaa479b53a61598",
    "result": {
        [
            "CustomerSummary"
        ],
        "configurations": [
            {
                "name": "",
                "configurationDetails": {
                    "category": [
                        {
                            "name": "Customer Demographics",
                            "llm_desc": "",
                            "attributes": [
                                {
                                    "field": "person.name.firstName",
                                    "xdm_desc": "First Name",
                                    "llm_desc": ""
                                },
                                {
                                    "field": "person.name.lastName",
                                    "xdm_desc": "Last Name",
                                    "llm_desc": ""
                                }
                            ]
                        }
                    ]
                },
                "segments": {
                    "limit": 1,
                    "selection_mode": "inclusion",
                    "inclusion": [
                        {
                            "id": "b2cf20ca-5d07-4ef2-b50a-994eb2c11349",
                            "priority": "1",
                            "name": "High Value Customers",
                            "description": "Customers with LTV > $500",
                            "totalProfiles": 125000
                        }
                    ],
                    "exclusion": []
                },
                "marketingActions": [],
                "narrative_precision": "fuzzy",
                "personNamespace": {
                    "isPersonNamespaceEnabled": true,
                    "code": [
                        {
                            "code": "Email",
                            "name": "Email"
                        }
                    ]
                }
            }
        ]
    }
}

프로필 컨텍스트가 생성되었으므로 Brand Concierge 또는 다른 고객용 에이전트에 대해 구성을 저장할 수 있습니다.

Brand Concierge의 프로필 컨텍스트 profile-context-brand-concierge

Brand Concierge에서 프로필 구성을 적용할 컨시어지를 선택합니다.

Brand Concierge이 표시되어 커서니 목록을 표시합니다.

컨시어지를 선택했으면 Personalization 탭으로 이동하여 이전에 만든 구성을 선택하십시오.

개인화 탭이 Brand Concierge에 표시됩니다.

다른 고객용 에이전트와의 프로필 컨텍스트 profile-context-other

다른 고객 대면 에이전트와 함께 프로필 컨텍스트를 사용하려면 Experience Platform API를 사용하여 고객의 프로필 컨텍스트를 조회하고 대화 기록을 검색해야 합니다. 이 두 값을 모두 검색하면 상담원은 대화를 시작하기 전에 전체 및 관련 컨텍스트를 제대로 검색할 수 있습니다.

고객의 프로필 컨텍스트를 조회하려면 entityIdNS, entityId 및 configurationName을(를) 쿼리 매개 변수로 제공하는 동안 /semanticprofile/lookup/narrative 끝점에 대한 GET 요청을 수행해야 합니다.

프로필 이야기 가져오기에 대한 샘플 요청 및 응답

code language-shell

curl -X GET "https://platform.adobe.io/data/core/semanticprofile/lookup/narrative?entityIdNS=Email&entityId=jane.doe%2B1@example.com&configurationName=CustomerSummary" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "x-api-key: {API_KEY}" \
  -H "x-gw-ims-org-id: {ORG_ID}" \
  -H "x-sandbox-name: {SANDBOX_NAME}"

table 0-row-2 1-row-2 2-row-2 3-row-2
쿼리 매개변수	설명
`entityIdNS`	ID 네임스페이스. 샌드박스에 정의된 네임스페이스여야 합니다. 가능한 값은 `Email`, `ECID` 및 `CRMID`입니다.
`entityId`	네임스페이스 내의 ID 값입니다. URL로 예약된 문자를 인코딩해야합니다.
`configurationName`	이전에 만든 구성의 이름입니다.

성공적인 응답은 프로필 컨텍스트에 대한 정보와 함께 HTTP 상태 200을 반환합니다.

code language-json
`{ "requestId": "7f3a9c8e-4d7b-4a6e-9f2c-1b6e8d4a2c91", "narrative": "Jane Doe is a member of the 'High Value Loyalty' audience. Her primary email address is jane.doe+1@example.com." }`

table 0-row-2 1-row-2 2-row-2
필드	설명
`requestId`	요청에 대해 생성된 고유 ID.
`narrative`	생성된 자연어 프로필 요약입니다.

고객의 이전 대화 기록을 조회하려면 entityIdNS 및 entityId을(를) 쿼리 매개 변수로 제공하는 동안 /semanticprofile/query/v1/profile 끝점에 대한 POST 요청을 수행해야 합니다.

샘플 요청 및 응답

code language-shell

curl -X POST "https://platform.adobe.io.data/core/semanticprofile/query/v1/profile?entityIdNS=Email&entityId=jane.doe%2B1@example.com" \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "conversations": {}
 }'

table 0-row-2 1-row-2 2-row-2
쿼리 매개변수	설명
`entityIdNS`	ID 네임스페이스. 샌드박스에 정의된 네임스페이스여야 합니다. 가능한 값은 `Email`, `ECID` 및 `CRMID`입니다.
`entityId`	네임스페이스 내의 ID 값입니다. URL로 예약된 문자를 인코딩해야합니다.

| 요청 필드 | 유형 | 설명 |
| ------------- | -------- | ---- | ----------- |
| conversations | 개체 | 대화에 대한 정보를 반환할지 여부를 결정하는 개체입니다. 빈 객체로 남겨두면 상호 작용, 메타데이터 및 신호에 대한 정보가 자동으로 수신됩니다. |

샘플 응답은 요청된 엔터티의 대화에 대한 정보와 함께 HTTP 상태 200을 반환합니다.

code language-json

{
    "conversations": {
        "items": [{
            "conversation_id": "conv-001",
            "channel": "web-chat",
            "created_at": "2026-05-02T14:03:11Z",
            "last_active_at": "2026-05-02T14:21:55Z",
            "participants": [{
                "identity_map": {
                    "Email": [{
                        "id": "jane.doe+1@example.com",
                        "primary": true
                    }]
                },
                "role": "customer",
                "is_author": true
            }],
            "interactions": [{
                "interaction_id": "int-001",
                "timestamp": "2026-05-02T14:03:11Z",
                "contents": [{
                    "content_value": "Hi, I'd like to upgrade my plan.",
                    "content_type": "TEXT"
                }]
            }]
        }],
    "has_more": true,
    "page_token": "eyJjdXJzb3IiOi…"
  }
}

서사와 대화를 모두 얻은 후에는 이 정보를 타사 AI 에이전트에게 전달할 수 있습니다. 이에 따라 AI 상담원은 고객이 누구인지에 대한 정보뿐 아니라 고객이 무엇을 논의했는지에 대한 정보도 갖게 된다.