세그먼트 이벤트 참조
다음 표는 watsonx Assistant 가 세그먼트 확장 을 사용하여 세그먼트에 보내는 이벤트의 세부사항을 표시합니다. 이러한 이벤트는 세그먼트 웨어하우스에서 테이블로 표시되고 다른 대상에서는 일반 이벤트로 표시됩니다.
watsonx Assistant v2 API를 사용하여 생성되고 사용자 ID와 연관된 이벤트만 포함됩니다.
메시지 처리됨
어시스턴트가 메시지 처리를 완료할 때 전송됩니다.
| 특성 | 유형 | 설명 |
|---|---|---|
accountId |
문자열 | IBM 계정의 ID입니다. |
assistantId |
문자열 | 어시스턴트의 ID입니다. |
browser |
문자열 | 메시지를 보내는 데 사용된 브라우저입니다. |
channel |
문자열 | 고객이 메시지를 보내는 데 사용한 채널 (예: phone 또는 chat). |
device |
문자열 | 메시지를 보내는 데 사용된 디바이스의 유형입니다. |
environment |
문자열 | 메시지가 처리된 환경 (예: draft 또는 live) |
language |
문자열 | 어시스턴트의 언어입니다. |
pageUrl |
문자열 | 메시지가 전송된 웹 페이지의 URL. |
serviceInstance |
문자열 | IBM watsonx Assistant 서비스 인스턴스. |
sessionId |
문자열 | 메시지가 처리된 세션의 ID입니다. |
skillsInvoked |
문자열[] | 메시지 처리 중에 호출된 모든 기술을 나열하는 문자열 배열 (예: main skill 또는 actions skill). |
다음 특성은 조치 스킬에서 처리된 메시지에 대해서만 포함됩니다.
| 특성 | 유형 | 설명 |
|---|---|---|
action |
문자열 | 메시지 처리 중에 방문한 조치의 고유 ID입니다 (예: action_202). |
actionCompleted |
부울 | 메시지 처리 중에 조치가 완료되었는지 여부입니다. |
actionCompletedReason |
문자열 | 조치가 완료된 이유 (예: all_steps_done 또는 fallback) |
actionStarted |
부울 | 메시지 처리 중에 조치 처리가 시작되었는지 여부입니다. |
actionTitle |
문자열 | 메시지 처리 중에 방문한 조치의 제목입니다 (예: I want to pay my bill). |
actionsVisited |
문자열[] | 메시지 처리 중에 방문한 조치를 나열하는 문자열의 배열입니다. |
fallbackReason |
문자열 | 대체 조치를 방문한 이유 (예: 휴먼 에이전트로 에스컬레이션되거나 일치하는 조치가 없음). |
handler |
문자열 | 호출된 핸들러의 이름입니다. |
stepsVisited |
오브젝트[] | 메시지 처리 중에 사용자가 방문한 단계를 나열하는 두 개의 특성 ( stepId 및 stepTitle) 이 있는 오브젝트입니다. |
subaction |
문자열 | 메시지에 의해 트리거된 조치에 의해 호출된 다른 조치의 이름입니다. |
다음 특성은 대화 스킬에서 처리된 메시지에만 포함됩니다.
| 특성 | 유형 | 설명 |
|---|---|---|
branchExited |
부울 | 메시지 처리 중에 대화 상자 분기가 종료되었는지 여부입니다. |
branchExitedReason |
문자열 | 대화 상자 분기가 종료된 이유입니다 (예: completed). |
nodesVisited |
문자열[] | 메시지 처리 중에 방문한 대화 상자 노드를 나열하는 문자열의 배열입니다. 각 대화 상자 노드에 대해 문자열은 노드 제목 (있는 경우) 또는 노드 ID를 지정합니다. |
조치가 시작됨
조치 처리가 시작될 때 송신됩니다.
| 특성 | 유형 | 설명 |
|---|---|---|
accountId |
문자열 | IBM 계정의 ID입니다. |
action |
문자열 | 조치의 고유 ID입니다 (예: action_202). |
actionTitle |
문자열 | 조치의 제목입니다 (예: I want to pay my bill). |
actionCompleted |
부울 | 동일한 대화 전환 중에 조치가 완료되었는지 여부입니다. |
actionCompletedReason |
문자열 | 조치가 완료된 이유 (예: all_steps_done 또는 fallback) |
assistantId |
문자열 | 어시스턴트의 ID입니다. |
browser |
문자열 | 조치를 트리거한 메시지를 보내는 데 사용된 브라우저입니다. |
channel |
문자열 | 고객이 조치를 트리거한 메시지를 보내는 데 사용한 채널입니다 (예: phone 또는 chat). |
device |
문자열 | 조치를 트리거한 메시지를 보내는 데 사용된 디바이스의 유형입니다. |
environment |
문자열 | 조치가 시작된 환경 (예: draft 또는 live) |
fallbackReason |
문자열 | 대체 조치가 시작된 이유입니다 (예: 휴먼 에이전트로 에스컬레이션되거나 일치하는 조치가 없음). |
handler |
문자열 | 호출된 핸들러의 이름입니다. |
language |
문자열 | 어시스턴트의 언어입니다. |
pageUrl |
문자열 | 조치를 트리거한 메시지가 전송된 웹 페이지의 URL 입니다. |
serviceInstance |
문자열 | IBM watsonx Assistant 서비스 인스턴스. |
sessionId |
문자열 | 조치를 시작한 메시지가 전송된 세션의 ID입니다. |
skillsInvoked |
문자열[] | 조치를 시작한 메시지 처리 중에 호출된 모든 기술을 나열하는 문자열 배열 (예: main skill 또는 actions skill). |
stepsVisited |
오브젝트[] | 메시지 처리 중에 사용자가 방문한 단계를 나열하는 두 개의 특성 ( stepId 및 stepTitle) 이 있는 오브젝트입니다. |
subaction |
문자열 | 처리 중에 조치가 호출한 기타 조치의 이름입니다. |
조치가 완료됨
조치 처리가 종료될 때 송신됩니다.
| 특성 | 유형 | 설명 |
|---|---|---|
accountId |
문자열 | IBM 계정의 ID입니다. |
action |
문자열 | 조치의 고유 ID입니다 (예: action_202). |
actionCompletedReason |
문자열 | 조치가 완료된 이유 (예: all_steps_done 또는 fallback) |
actionStarted |
부울 | 동일한 대화 전환 중에 조치가 시작되었는지 여부입니다. |
actionTitle |
문자열 | 조치의 제목입니다 (예: I want to pay my bill). |
assistantId |
문자열 | 어시스턴트의 ID입니다. |
browser |
문자열 | 조치를 트리거한 메시지를 보내는 데 사용된 브라우저입니다. |
channel |
문자열 | 고객이 조치를 시작한 메시지를 보내는 데 사용한 채널입니다 (예: phone 또는 chat). |
device |
문자열 | 조치를 트리거한 메시지를 보내는 데 사용된 디바이스의 유형입니다. |
environment |
문자열 | 조치가 완료된 환경 (예: draft 또는 live) |
fallbackReason |
문자열 | 대체 조치가 호출된 이유입니다 (예: 휴먼 에이전트로 에스컬레이션되거나 일치하는 조치가 없음). |
handler |
문자열 | 조치에 의해 호출된 핸들러의 이름입니다. |
language |
문자열 | 어시스턴트의 언어입니다. |
pageUrl |
문자열 | 조치를 트리거한 메시지가 전송된 웹 페이지의 URL 입니다. |
serviceInstance |
문자열 | IBM watsonx Assistant 서비스 인스턴스. |
sessionId |
문자열 | 조치를 시작한 메시지가 전송된 세션의 ID입니다. |
skillsInvoked |
문자열[] | 조치를 시작한 메시지 처리 중에 호출된 모든 기술을 나열하는 문자열 배열 (예: main skill 또는 actions skill). |
stepsVisited |
오브젝트[] | 메시지 처리 중에 사용자가 방문한 단계를 나열하는 두 개의 특성 ( stepId 및 stepTitle) 이 있는 오브젝트입니다. |
subaction |
문자열 | 처리 중에 조치가 호출한 기타 조치의 이름입니다. |
세션이 시작됨
새 세션이 시작될 때 송신됩니다.
참고: v2 Stateless API는 세션 시작을 위한 이벤트를 생성하지 않습니다.
| 특성 | 유형 | 설명 |
|---|---|---|
accountId |
문자열 | IBM 계정의 ID입니다. |
assistantId |
문자열 | 어시스턴트의 ID입니다. |
browser |
문자열 | 세션을 시작한 메시지를 보내는 데 사용된 브라우저입니다. |
channel |
문자열 | 세션을 시작한 채널 (예: phone 또는 chat). |
device |
문자열 | 세션을 시작한 메시지를 보내는 데 사용된 디바이스의 유형입니다. |
environment |
문자열 | 세션이 시작된 환경 (예: draft 또는 live) |
pageUrl |
문자열 | 세션을 시작한 메시지가 전송된 웹 페이지의 URL 입니다. |
serviceInstance |
문자열 | IBM watsonx Assistant 서비스 인스턴스. |
sessionId |
문자열 | 세션의 ID입니다. |