GetSession - Amazon Lex V1
Request SyntaxURI 요청 파라미터Request BodyResponse Syntax응답 요소Errors참고

Amazon Lex V2를 사용하는 경우 Amazon Lex V2 가이드를 대신 참조하십시오.

 

Amazon Lex V1을 사용하는 경우 봇을 Amazon Lex V2로 업그레이드하는하는 것이 좋습니다. 더 이상 V1에 새로운 기능을 추가하지 않으므로 모든 새 봇에 V2를 사용할 것을 강력히 권장합니다.

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

GetSession

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

Request Syntax

GET /bot/botName/alias/botAlias/user/userId/session/?checkpointLabelFilter=checkpointLabelFilter HTTP/1.1

URI 요청 파라미터

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

botAlias

세션 데이터를 포함하는 봇에 사용되는 별칭입니다.

필수 여부: 예

botName

세션 데이터가 들어있는 봇의 명칭.

필수 여부: 예

checkpointLabelFilter

recentIntentSummaryView 구조에서 반환된 의도를 필터링하는 데 사용되는 문자열입니다.

필터를 지정하면 checkpointLabel 필드가 해당 문자열로 설정된 의도만 반환됩니다.

길이 제약: 최소 길이는 1. 최대 길이는 255.

패턴: [a-zA-Z0-9-]+

userId

클라이언트 애플리케이션 사용자의 ID입니다. Amazon Lex는 이를 사용하여 사용자와 봇의 대화를 식별합니다.

길이 제약: 최소 길이는 2. 최대 길이는 100.

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

필수 사항 여부: Yes

Request Body

해당 요청에는 본문이 없습니다.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
   "activeContexts": [ 
      { 
         "name": "string",
         "parameters": { 
            "string" : "string" 
         },
         "timeToLive": { 
            "timeToLiveInSeconds": number,
            "turnsToLive": number
         }
      }
   ],
   "dialogAction": { 
      "fulfillmentState": "string",
      "intentName": "string",
      "message": "string",
      "messageFormat": "string",
      "slots": { 
         "string" : "string" 
      },
      "slotToElicit": "string",
      "type": "string"
   },
   "recentIntentSummaryView": [ 
      { 
         "checkpointLabel": "string",
         "confirmationStatus": "string",
         "dialogActionType": "string",
         "fulfillmentState": "string",
         "intentName": "string",
         "slots": { 
            "string" : "string" 
         },
         "slotToElicit": "string"
      }
   ],
   "sessionAttributes": { 
      "string" : "string" 
   },
   "sessionId": "string"
}

응답 요소

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

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

activeContexts

세션에 대해 활성화된 컨텍스트 목록. 의도가 이행될 때 또는 PostContent, PostText, 또는 PutSession 작업을 호출하여 컨텍스트를 설정할 수 있습니다.

컨텍스트를 사용하여 의도를 추적할 수 있는 의도를 제어하거나 애플리케이션 작업을 수정할 수 있습니다.

유형: ActiveContext객체 어레이

배열 항목: 최소 항목 수는 0개. 최대 항목 수는 20개.

dialogAction

봇의 현재 상태를 설명합니다.

유형: DialogAction객체

recentIntentSummaryView

세션에서 사용된 의도에 대한 정보 배열. 배열에는 최대 세 개의 요약이 포함될 수 있습니다. 세션에서 세 개 이상의 의도를 사용하는 경우 recentIntentSummaryView 작업에는 마지막으로 사용한 세 개의 의도에 대한 정보가 포함됩니다.

요청에서 checkpointLabelFilter 파라미터를 설정하는 경우 배열에는 지정된 레이블의 의도만 포함됩니다.

유형: IntentSummary객체 어레이

어레이 멤버: 최소 항목 수 0개. 최대 항목 수는 3개.

sessionAttributes

세션별 컨텍스트 정보를 나타내는 키/값 페어의 맵입니다. Amazon Lex와 클라이언트 애플리케이션 간에 전달되는 요청별 정보를 포함합니다.

유형: 문자열 간 맵

sessionId

세션에 대한 고유 식별자입니다.

타입: 문자열

Errors

BadRequestException

요청 검증이 실패했거나, 컨텍스트에 사용 가능한 메시지가 없거나, 봇 빌드가 실패했거나, 아직 진행 중이거나, 빌드되지 않은 변경 사항이 포함되어 있습니다.

HTTP 상태 코드: 400

InternalFailureException

내부 서비스 오류. 호출을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

제한 초과함.

HTTP 상태 코드: 429

NotFoundException

참조된 리소스(예: Amazon Lex 봇 또는 별칭)를 찾을 수 없습니다.

HTTP 상태 코드: 404

참고

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