대화 데이터 형식

Customer Experience Insights는 Cloud Storage 버킷에 업로드한 대화 데이터를 사용합니다. 대화 데이터를 오디오 또는 텍스트 파일로 API에 제공할 수 있습니다.

대화 스크립트 데이터

텍스트 파일에는 다음 세부정보가 포함됩니다.

대화

대화 데이터의 최상위 객체입니다.

필드	유형	설명
conversation_info	ConversationInfo { }	선택사항. 대화의 메타데이터입니다.
entries	Entry [ ]	필수 항목입니다. 시간순으로 정렬된 대화 메시지입니다.

대화 정보

대화의 메타데이터입니다.

필드	유형	설명
categories	Category [ ]	선택사항. 대화 데이터의 커스텀 카테고리입니다.

카테고리

대화 데이터 카테고리입니다. 대화 데이터와 함께 카테고리를 제공하면 대화의 주제를 식별하는 데 카테고리가 사용됩니다. 카테고리를 제공하지 않으면 시스템에서 콘텐츠에 따라 대화를 자동으로 분류합니다.

필드	유형	설명
display_name	문자열	필수 항목입니다. 카테고리의 표시 이름입니다.

항목

단일 대화 메시지의 데이터입니다.

필드	유형	설명
텍스트	문자열	필수 항목입니다. 이 대화 메시지의 텍스트입니다.
user_id	정수	필수 항목입니다. 대화 참여자를 식별하는 번호입니다. 여러 대화에 참여하는 경우 참가자마다 반복적으로 사용하는 단일 user_id가 있어야 합니다.
role	문자열	필수 항목입니다. 대화 참여자 역할입니다. 'AGENT', 'AUTOMATED_AGENT', 'CUSTOMER', 'END_USER' 중 하나입니다.
start_timestamp_usec	정수	필수 항목입니다. 이 대화의 시작 타임스탬프가 Unix 에포크 이후 UTC 시간(마이크로초)으로 표시됩니다.

예

다음은 대화 데이터 파일의 예시입니다.

{
  "conversation_info":{
    "categories":[
      {
        "display_name":"Category 1"
      }
    ]
  },
  "entries": [
    {
      "start_timestamp_usec": 1000000,
      "text": "Hello, I'm calling in regards to ...",
      "role": "CUSTOMER",
      "user_id": 1
    },
    {
      "start_timestamp_usec": 5000000,
      "text": "Yes, I can answer your question ...",
      "role": "AGENT",
      "user_id": 2
    }
  ]
}