REST Resource: projects.locations.brands.sessionRecords

리소스: SessionRecord

단일 세션 레코드를 나타냅니다.

JSON 표현 
{
  "name": string,
  "sessionStartTime": string,
  "storeId": string,
  "laneId": string,
  "interactions": [
    {
      object (Interaction)
    }
  ],
  "outcomeLabel": string,
  "outcomeGroupLabel": string,
  "audioRecordingPath": string,
  "order": {
    object (Order)
  },
  "sessionDuration": string,
  "upsellAttemptRecords": [
    {
      object (UpsellAttemptRecord)
    }
  ],
  "audioRecording": string,
  "trafficType": enum (TrafficType),
  "channelType": enum (ChannelType)
}
필드
name

string

식별자. SessionRecord의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/brands/{brand}/sessionRecords/{sessionRecord}
sessionStartTime

string (Timestamp format)

출력 전용입니다. 세션이 시작된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
storeId

string

변경할 수 없습니다. 주문이 접수된 매장의 ID입니다.
laneId

string

변경할 수 없습니다. 주문 세션의 레인 ID입니다.
interactions[]

object (Interaction)

출력 전용입니다. 대화 차례입니다.
outcomeLabel

string

출력 전용입니다. 주문의 최종 결과 라벨입니다.
outcomeGroupLabel

string

출력 전용입니다. 결과의 그룹 라벨입니다.
audioRecordingPath

string

출력 전용입니다. 전체 오디오 녹음 파일의 경로입니다.
order

object (Order)

출력 전용입니다. 세션 기록과 연결된 주문입니다.
sessionDuration

string (Duration format)

출력 전용입니다. 세션의 총 지속 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
upsellAttemptRecords[]

object (UpsellAttemptRecord)

출력 전용입니다. 세션 중에 실행된 업셀입니다.
audioRecording

string (bytes format)

출력 전용입니다. 세션의 오디오 녹음입니다. 이 필드는 sessionRecords.get을 호출할 때만 채워집니다.

base64 인코딩 문자열입니다.
trafficType

enum (TrafficType)

출력 전용입니다. 세션의 트래픽 유형입니다.
channelType

enum (ChannelType)

출력 전용입니다. 세션에 사용된 채널 유형 (예: 드라이브 스루, 모바일 앱, 전화 통화)입니다.

상호작용

대화의 턴에서 단일 상호작용을 나타냅니다.

JSON 표현 
{
  "turnPosition": string,

  // Union field interaction can be only one of the following:
  "userUtterance": {
    object (UserUtterance)
  },
  "agentUtterance": {
    object (AgentUtterance)
  },
  "resolveOrder": {
    object (ResolveOrder)
  },
  "submitOrder": {
    object (SubmitOrder)
  },
  "matchIntent": {
    object (MatchIntent)
  },
  "clientExecution": {
    object (ClientExecution)
  },
  "clientOrderUpdate": {
    object (ClientOrderUpdate)
  }
  // End of list of possible types for union field interaction.
}
필드
turnPosition

string (int64 format)

출력 전용입니다. 대화에서 위치를 바꿉니다.
통합 필드 interaction. 상호작용 유형입니다. interaction은 다음 중 하나여야 합니다.
userUtterance

object (UserUtterance)

사용자 발화
agentUtterance

object (AgentUtterance)

상담사 발화입니다.
resolveOrder

object (ResolveOrder)

상담사가 실행한 ResolveOrder 호출
submitOrder

object (SubmitOrder)

에이전트가 실행한 SubmitOrder 호출
matchIntent

object (MatchIntent)

에이전트가 실행한 MatchIntent 호출
clientExecution

object (ClientExecution)

에이전트가 실행한 ClientExecution 호출
clientOrderUpdate

object (ClientOrderUpdate)

클라이언트가 시작한 주문 상태 업데이트

UserUtterance

사용자 발화입니다.

JSON 표현 
{
  "text": string,
  "createTime": string
}
필드
text

string

사용자 발화의 텍스트입니다.
createTime

string (Timestamp format)

출력 전용입니다. 사용자 발화가 발생한 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

AgentUtterance

에이전트 발화입니다.

JSON 표현 
{
  "text": string,
  "createTime": string
}
필드
text

string

에이전트 발화의 텍스트입니다.
createTime

string (Timestamp format)

출력 전용입니다. 상담사 발화가 발생한 시점의 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

ResolveOrder

해결 주문 상호작용입니다.

JSON 표현 
{
  "input": {
    object (ResolveOrderInput)
  },
  "output": {
    object (ResolveOrderOutput)
  }
}
필드
input

object (ResolveOrderInput)

주문 해결 작업의 입력입니다.
output

object (ResolveOrderOutput)

주문 해결 작업의 출력입니다.

ResolveOrderInput

주문 해결 상호작용의 입력입니다.

JSON 표현 
{
  "payload": {
    object
  }
}
필드
payload

object (Struct format)

주문 해결 상호작용의 페이로드입니다.

ResolveOrderOutput

주문 해결 상호작용의 출력입니다.

JSON 표현 
{
  "payload": {
    object
  }
}
필드
payload

object (Struct format)

주문 해결 상호작용 출력의 페이로드입니다.

SubmitOrder

이 유형에는 필드가 없습니다.

주문 제출 상호작용입니다.

MatchIntent

일치 인텐트 상호작용입니다.

JSON 표현 
{
  "input": {
    object (MatchIntentInput)
  },
  "output": {
    object (MatchIntentOutput)
  }
}
필드
input

object (MatchIntentInput)

일치 인텐트 상호작용의 입력입니다.
output

object (MatchIntentOutput)

일치 인텐트 상호작용의 출력입니다.

MatchIntentInput

일치 인텐트 상호작용의 입력입니다.

JSON 표현 
{
  "payload": {
    object
  }
}
필드
payload

object (Struct format)

일치 의도 상호작용 입력의 페이로드입니다.

MatchIntentOutput

일치 인텐트 상호작용의 출력입니다.

JSON 표현 
{
  "payload": {
    object
  }
}
필드
payload

object (Struct format)

일치 인텐트 상호작용 출력의 페이로드입니다.

ClientExecution

클라이언트 실행 상호작용입니다.

JSON 표현 
{
  "toolName": string,
  "input": {
    object (ClientExecutionInput)
  },
  "output": {
    object (ClientExecutionOutput)
  }
}
필드
toolName

string

클라이언트 실행 상호작용의 도구 이름입니다.
input

object (ClientExecutionInput)

클라이언트 실행 상호작용의 입력입니다.
output

object (ClientExecutionOutput)

클라이언트 실행 상호작용의 출력입니다.

ClientExecutionInput

클라이언트 실행 상호작용의 입력입니다.

JSON 표현 
{
  "payload": {
    object
  }
}
필드
payload

object (Struct format)

클라이언트 실행 상호작용 입력의 페이로드입니다.

ClientExecutionOutput

클라이언트 실행 상호작용의 출력입니다.

JSON 표현 
{
  "payload": {
    object
  }
}
필드
payload

object (Struct format)

클라이언트 실행 상호작용 출력의 페이로드입니다.

ClientOrderUpdate

클라이언트가 시작한 주문 상태 업데이트입니다.

JSON 표현 
{
  "order": {
    object (Order)
  }
}
필드
order

object (Order)

클라이언트가 전송한 주문 상태 업데이트입니다.

UpsellAttemptRecord

업셀 시도를 나타냅니다. 이 데이터는 콘솔 주문 내역에 추가 판매 정보(추가 판매 유형, 턴 ID, 추가 판매 수락 여부)를 표시하는 데 사용되며, 처리된 로그를 기반으로 Spanner에서 채워집니다.

JSON 표현 
{
  "turnId": integer,
  "upsellType": string,
  "accepted": boolean
}
필드
turnId

integer

출력 전용입니다. 업셀링 기회가 발생한 턴의 ID입니다.
upsellType

string

출력 전용입니다. 업셀 이벤트 유형입니다.
accepted

boolean

출력 전용입니다. 업셀이 수락되었는지 여부입니다.

TrafficType

세션의 트래픽 유형입니다. 모니터링, 로깅, 관측 가능성 측정항목에 라벨을 지정하는 데 사용됩니다.

열거형
TRAFFIC_TYPE_UNSPECIFIED 트래픽 유형이 지정되지 않았습니다.
EXTERNAL 트래픽이 외부 클라이언트에서 발생합니다.
INTEGRATION_TEST 트래픽이 통합 테스트에서 발생합니다.
EVAL 트래픽이 평가 도구에서 발생합니다.
PROBER 트래픽이 프로버에서 발생합니다.
MANUAL_TEST 트래픽이 수동 테스트에서 발생합니다.
INTERNAL_TOOL 트래픽이 내부 도구에서 발생합니다.
CONSOLE 트래픽은 음식 AI 콘솔에서 발생합니다.

메서드

delete

 SessionRecord를 삭제합니다.

get

 특정 SessionRecord를 가져옵니다.

list

 지정된 브랜드의 SessionRecord를 나열합니다.