GetSession - Amazon Lex

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GetSession

지정된 봇, 별칭 및 사용자에 대한 세션 정보를 반환합니다.

예를 들어, 이 작업을 사용하여 장기 실행 세션을 사용 중인 사용자의 세션 정보를 검색할 수 있습니다.

봇, 별칭 또는 세션 식별자가 없는 경우 Amazon Lex V2는BadRequestException. 로캘이 존재하지 않거나 별칭에 대해 활성화되지 않은 경우BadRequestException.

요청 구문

GET /bots/botId/botAliases/botAliasId/botLocales/localeId/sessions/sessionId HTTP/1.1

URI 요청 파라미터

요청은 다음의 URI 파라미터를 사용합니다.

botAliasId

세션 데이터가 포함된 봇에 대해 사용 중인 별칭 식별자입니다.

: 필수 예

botId

세션 데이터가 포함된 봇의 식별자입니다.

길이 제약: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

: 필수 예

localeId

세션이 사용 중인 로캘입니다.

길이 제약: 최소 길이는 1이고,

: 필수 예

sessionId

반환할 세션의 식별자입니다.

길이 제약: 최소 길이는 2이고, 최대 길이는 100입니다.

Pattern: [0-9a-zA-Z._:-]+

: 필수 예

요청 본문

요청에 요청 본문이 없습니다.

응답 구문

HTTP/1.1 200 Content-type: application/json { "interpretations": [ { "intent": { "confirmationState": "string", "name": "string", "slots": { "string" : { "shape": "string", "value": { "interpretedValue": "string", "originalValue": "string", "resolvedValues": [ "string" ] }, "values": [ "Slot" ] } }, "state": "string" }, "nluConfidence": { "score": number }, "sentimentResponse": { "sentiment": "string", "sentimentScore": { "mixed": number, "negative": number, "neutral": number, "positive": number } } } ], "messages": [ { "content": "string", "contentType": "string", "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" } } ], "sessionId": "string", "sessionState": { "activeContexts": [ { "contextAttributes": { "string" : "string" }, "name": "string", "timeToLive": { "timeToLiveInSeconds": number, "turnsToLive": number } } ], "dialogAction": { "slotElicitationStyle": "string", "slotToElicit": "string", "type": "string" }, "intent": { "confirmationState": "string", "name": "string", "slots": { "string" : { "shape": "string", "value": { "interpretedValue": "string", "originalValue": "string", "resolvedValues": [ "string" ] }, "values": [ "Slot" ] } }, "state": "string" }, "originatingRequestId": "string", "runtimeHints": { "slotHints": { "string" : { "string" : { "runtimeHintValues": [ { "phrase": "string" } ] } } } }, "sessionAttributes": { "string" : "string" } } }

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

interpretations

Amazon Lex V2가 결정한 인텐트 목록은 사용자의 발언을 만족시킬 수 있습니다.

각 해석에는 의도, 해석이 올바른지 Amazon Lex V2가 얼마나 확신하는지 나타내는 점수, 발언으로 표현된 감정을 나타내는 선택적 감정 응답이 포함됩니다.

Type: 배열Interpretation사물

배열 멤버: 최대 항목 수는 5개입니다.

messages

사용자에게 마지막으로 전송된 메시지 목록입니다. 메시지는 Lambda 함수에서 메시지를 반환한 순서 또는 메시지가 봇에 정의된 순서에 따라 정렬됩니다.

Type: 배열Message사물

배열 멤버: 최대 항목 수는 10개입니다.

sessionId

반환되는 세션의 식별자입니다.

Type: 문자열

길이 제약: 최소 길이는 1이고,

sessionState

사용자와 봇 사이의 대화 상자의 현재 상태를 나타냅니다.

이 옵션을 사용하여 대화의 진행 상황과 다음 작업을 결정할 수 있습니다.

유형: SessionState 객체

오류

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.

AccessDeniedException

HTTP 상태 코드: 403

InternalServerException

HTTP 상태 코드: 500

ResourceNotFoundException

HTTP 상태 코드: 404

ThrottlingException

HTTP 상태 코드: 429

ValidationException

HTTP 상태 코드: 400

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.