AWS Lambda Lex V2의 입력 이벤트 형식

Lambda 함수로 이동하는 이벤트 데이터의 형식과 Lambda 함수에서 나올 것으로 예상되는 응답 형식을 식별하는 메시지 버전입니다.

Lambda 함수를 호출한 코드 후크입니다. 다음과 같은 값이 가능합니다.

DialogCodeHook– Amazon Lex V2는 사용자 입력 후 Lambda 함수를 호출했습니다.

FulfillmentCodeHook– Amazon Lex V2는 필요한 슬롯을 모두 채운 후 Lambda 함수를 호출하고 의도를 이행할 준비가 된 후 Lambda 함수를 호출했습니다.

사용자 발화의 모드입니다. 가능한 값은 다음과 같습니다.

DTMF– 사용자가 터치톤 키패드(듀얼 톤 다중 주파수)를 사용하여 발화를 입력합니다.

Speech– 사용자가 말을 했습니다.

Text– 사용자가 발화를 입력했습니다.

사용자에 대한 봇의 응답 모드입니다. text/plain; charset=utf-8은 마지막 발화를 기록했음을 나타내며, audio로 시작하는 값은 마지막 발화를 말했음을 나타냅니다.

대화에 사용된 영숫자 세션 식별자입니다.

사용자의 입력 내용에 대한 트랜스크립션입니다.

Lambda 함수를 호출한 응답을 나타내는 값입니다. 초기 응답, 슬롯 및 확인 응답에 대한 호출 레이블을 설정할 수 있습니다.

요청을 처리한 봇에 대한 정보로, 다음 필드로 구성됩니다.

Amazon Lex V2에서 사용자의 발화와 일치할 가능성이 있다고 간주하는 의도에 대한 정보 목록입니다. 각 항목은 다음과 같은 형식으로 발화가 의도와 일치하는지에 대한 정보를 제공하는 구조입니다.

{
    "intent": {
        // see 의도 for details about the structure
    },
    "interpretationSource": "Bedrock | Lex",
    "nluConfidence": number,
    "sentimentResponse": {
        "sentiment": "MIXED | NEGATIVE | NEUTRAL | POSITIVE",
        "sentimentScore": {
            "mixed": number,
            "negative": number,
            "neutral": number,
            "positive": number
        }
    }
}

구조 내의 필드는 다음과 같습니다.

Lambda 함수가 sessionState의 dialogAction을 Delegate로 설정하면 이 필드가 나타나고 대화의 다음 단계에 대한 Amazon Lex V2의 제안을 표시합니다. 그렇지 않으면 Lambda 함수의 응답에서 반환하는 설정에 따라 다음 상태가 달라집니다. 이 구조에는 다음 두 가지 조건이 모두 충족될 때만 나타납니다.

이 정보를 사용하여 대화의 적절한 시점에 runtimeHints를 추가할 수 있습니다. 자세한 내용은 대화의 런타임 힌트를 통한 슬롯 값 인식 개선를 참조하세요. proposedNextState는 다음 필드가 포함된 구조입니다.

proposedNextState의 구조는 다음과 같습니다.

"proposedNextState": {
    "dialogAction": {
        "slotToElicit": string,
        "type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot"
    },
    "intent": {
        // see 의도 for details about the structure
    },
    "prompt": {
        "attempt": string 
    }
}

클라이언트가 요청에서 전송하는 요청별 속성을 포함하는 구조입니다. 전체 세션에서 유지할 필요가 없는 정보를 전달하려면 요청 속성을 사용합니다. 요청 속성이 존재하지 않는 경우, 값은 null이 됩니다. 자세한 내용은 Lex V2 봇의 요청 속성 설정 단원을 참조하십시오.

사용자와 Amazon Lex V2 봇 간의 현재 대화 상태입니다. 구조에 대한 자세한 내용은 세션 상태를 참조하세요.

Amazon Lex V2에서 사용자의 발화와 일치할 가능성이 있다고 간주하는 트랜스크립션 목록입니다. 자세한 내용은 음성 트랜스크립션 신뢰도 점수를 사용하여 Lex V2 봇과의 대화를 개선하세요 단원을 참조하십시오. 각 항목은 가능한 한 가지 트랜스크립션에 대한 정보를 포함하는 다음 형식의 객체입니다.

{
    "transcription": string,
    "transcriptionConfidence": number,
    "resolvedContext": {
        "intent": string
    },
    "resolvedSlots": {
        slot name: {
            // see 슬롯 for details about the structure
        },
        ...
    }
}

필드는 아래에 설명되어 있습니다.