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

# Lex V2 봇으로 사용자 입력 캡처를 위한 시간 제한 구성
<a name="session-attribs-speech"></a>

Amazon Lex V2 스트리밍 API를 사용하면 봇이 사용자 입력에서 발화를 자동으로 감지할 수 있습니다. 의도나 슬롯을 생성할 때 발화의 최대 지속 시간, 사용자 입력을 기다리는 동안의 시간 제한, DTMF 입력의 종료 문자 등 발화의 여러 측면을 구성할 수 있습니다. 사용 사례에 맞게 봇의 동작을 사용자 지정할 수 있습니다. 예를 들어 신용 카드 번호의 자릿수를 16자리로 제한할 수 있습니다.

또한 봇과 대화를 시작할 때 세션 속성을 통해 시간 제한을 구성하고 필요한 경우 Lambda 함수에서 이를 덮어쓸 수 있습니다.

속성의 구성 키는 다음 구문을 사용합니다.

```
x-amz-lex:{{<InputType>}}:{{<BehaviorName>}}:{{<IntentName>}}:{{<SlotName>}}
```

`InputType`은 **audio**, **dtmf** 또는 **text**일 수 있습니다.

의도 또는 슬롯 이름으로 **\***을 지정하여 봇의 모든 의도 또는 슬롯에 대한 기본 설정을 구성할 수 있습니다. 모든 의도별 또는 슬롯별 설정이 기본 설정보다 우선합니다.

Amazon Lex V2는 봇에 대한 텍스트, 음성 또는 DTMF 입력으로 [StartConversation](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_StartConversation.html) 작업이 작동하는 방식을 관리하기 위한 사전 정의된 세션 속성을 제공합니다. 사전 정의된 모든 속성은 `x-amz-lex` 네임스페이스에 있습니다.

의도 또는 슬롯 이름으로 `*`을 지정하여 봇의 모든 의도, 슬롯 또는 하위 슬롯에 대한 기본 설정을 구성할 수 있습니다. 모든 의도 또는 슬롯별 설정이 기본 설정보다 우선합니다. 아래의 모든 시간 제한에 이 패턴을 사용하세요.

복합 슬롯의 하위 슬롯의 경우 `.`로 구분할 수 있습니다. 예제:

```
{{<slotName>}}.{{<subSlotName>}}
```

```
x-amz-lex:allow-interrupt:{{<intentName>}}:{{<slotName>}}.{{<subSlotName>}}
```


| 표현식 | 시나리오 | 
| --- | --- | 
| Intent:Slot.SubSlot | 이름이 ‘Slot’인 복합 슬롯 내 'SubSlot'이라는 이름의 하위 슬롯에만 적용 가능 | 
| Intent:Slot.\* | 이름이 ‘Slot’인 복합 슬롯 내부의 모든 서브 슬롯에 적용 가능 | 
| Intent:\*.SubSlot | 모든 복합 슬롯 내의 'SubSlot'이라는 이름의 하위 슬롯에만 적용 가능 | 
| Intent:\*.\* | 모든 복합 슬롯 내의 모든 하위 슬롯에 적용 가능 | 

## Lex V2 봇에서 인터럽트 동작의 작동 방식
<a name="allow-interrupt"></a>

봇의 중단 동작을 설정할 수 있습니다. 이 속성은 Amazon Lex V2에서 정의한 것입니다.

중단 허용

```
x-amz-lex:allow-interrupt:{{<intentName>}}:{{<slotName>}}
```

Amazon Lex V2 봇이 재생하는 프롬프트를 사용자가 중단할 수 있는지 여부를 정의합니다. 선택적으로 끌 수 있습니다.

**기본값:** True

## 음성 입력의 시간 제한 설정
<a name="voice-input-time-out"></a>

세션 속성을 사용하여 봇과의 음성 상호 작용에 대한 시간 제한 값을 설정할 수 있습니다. 이 속성은 Amazon Lex V2에서 정의한 것입니다. 이러한 속성을 사용하면 Amazon Lex V2가 입력 음성을 수집하기 전에 고객이 말을 마칠 때까지 기다리는 시간을 지정할 수 있습니다.

이러한 모든 속성은 `x-amz-lex:audio` 네임스페이스에 있습니다.

### 최대 발화 길이
<a name="max-utterance-length"></a>

```
x-amz-lex:audio:max-length-ms:{{<intentName>}}:{{<slotName>}}
```

Amazon Lex V2가 음성 입력이 잘리고 음성이 애플리케이션으로 반환되기 전에 대기하는 시간을 정의합니다. 긴 응답이 예상되거나 고객에게 정보를 제공할 시간을 더 주고 싶은 경우 입력 길이를 늘릴 수 있습니다.

**기본값:** 55,000밀리초(55초). 최대값은 55,000밀리초(55초)입니다.

`max-length-ms` 속성을 55,000밀리초 이상으로 설정하면 값은 기본적으로 55,000밀리초로 설정됩니다.

### 음성 시간 제한
<a name="voice-timeout"></a>

```
x-amz-lex:audio:start-timeout-ms:{{<intentName>}}:{{<slotName>}}
```

고객이 말을 하지 않을 것이라고 가정하기 전에 봇이 얼마를 기다릴지 지정합니다. 고객이 말하기 전에 정보를 찾거나 기억하는 데 시간이 더 필요할 수 있는 상황에서는 시간을 늘릴 수 있습니다. 예를 들어, 고객이 번호를 입력하기 위해 신용 카드를 꺼낼 수 있도록 시간을 줄 수 있습니다.

**기본값:** 4,000밀리초(4초)

### 사일런스 시간 제한
<a name="silence-timeout"></a>

```
x-amz-lex:audio:end-timeout-ms:{{<intentName>}}:{{<slotName>}}
```

고객이 말을 멈춘 후 발화가 끝났다고 가정하기 위해 봇이 대기하는 시간입니다. 정보를 입력하는 동안 침묵 기간이 예상되는 경우 시간을 늘릴 수 있습니다.

**기본값:** 600밀리초(0.6초)

### 오디오 입력 허용
<a name="allow-audio-input"></a>

```
x-amz-lex:allow-audio-input:{{<intentName>}}:{{<slotName>}}
```

봇이 오디오 양식을 통해서만 사용자 입력을 받아들이도록 이 속성을 활성화할 수 있습니다. 이 플래그가 false로 설정된 경우 봇은 오디오 입력을 받아들이지 않습니다. 기본적으로 이 값은 true로 설정됩니다.

**기본값:** True

## 텍스트 입력 시간 제한
<a name="text-input-attribs"></a>

다음 세션 속성을 사용하여 봇이 텍스트 대화 모드에서 작동하는 방식을 지정하세요.

이 속성은 `x-amz-lex:text` 네임스페이스에 있습니다.

### 시작 시간 제한 임곗값
<a name="start-timeout-threshold"></a>

```
x-amz-lex:text:start-timeout-ms:{{<intentName>}}:{{<slotName>}}
```

봇이 고객에게 문자 입력을 다시 요청하기 전에 기다리는 시간입니다. 고객이 텍스트 입력을 제공하기 전에 정보를 찾거나 기억할 수 있는 시간을 더 주고 싶은 상황에서는 시간을 늘릴 수 있습니다. 예를 들어 고객이 주문의 세부 정보를 찾을 시간을 더 많이 제공하려고 할 수 있습니다. 또는 임곗값을 줄여 고객에게 더 빨리 프롬프트를 표시할 수도 있습니다.

**기본값:** 30,000밀리초(30초)

## DTMF 입력을 위한 구성 설정
<a name="session-attribs-dtmf"></a>

다음 세션 속성을 사용하여 오디오 대화를 사용할 때 Amazon Lex V2 봇이 DTMF 입력에 응답하는 방식을 지정합니다.

이러한 모든 속성은 `x-amz-lex:dtmf` 네임스페이스에 있습니다.

### 삭제 문자
<a name="deletion-character"></a>

```
x-amz-lex:dtmf:deletion-character:{{<intentName>}}:{{<slotName>}}
```

누적된 DTMF 숫자를 지우고 입력을 즉시 종료하는 DTMF 문자입니다.

**기본값:** \*

### 종료 문자
<a name="end-character"></a>

```
x-amz-lex:dtmf:end-character:{{<intentName>}}:{{<slotName>}}
```

입력을 즉시 종료하는 DTMF 문자입니다. 사용자가 이 문자를 누르지 않으면 종료 시간 제한 후 입력이 종료됩니다.

**기본값:** \#

### 종료 시간 제한
<a name="end-timeout"></a>

```
x-amz-lex:dtmf:end-timeout-ms:{{<intentName>}}:{{<slotName>}}
```

입력이 완료되었다고 가정하기 전에 봇이 마지막 DTMF 문자 입력을 기다려야 하는 시간입니다.

**기본값:** 5,000밀리초(5초)

### 발화당 최대 DTMF 자리 수
<a name="max-length"></a>

```
x-amz-lex:dtmf:max-length:{{<intentName>}}:{{<slotName>}}
```

발화에 허용되는 최대 DTMF 자릿수입니다. 예를 들어 이 값을 16으로 설정하여 신용 카드 번호에 입력할 수 있는 문자 수를 제한할 수 있습니다. 이 값은 늘릴 수 없습니다.

**기본값:** 1,024자

### DTMF 입력 허용
<a name="allow-inputdtmf"></a>

세션 속성을 사용하여 봇이 받아들일 수 있는 입력 유형을 설정할 수 있습니다. 이 속성은 Amazon Lex V2에서 정의한 것입니다.

```
x-amz-lex:allow-dtmf-input:{{<intentName>}}:{{<slotName>}}
```

이 속성을 활성화하여 봇이 DTMF 방식을 통한 사용자 입력을 받아들이도록 할 수 있습니다. 이 플래그가 false로 설정된 경우 봇은 DTMF 입력을 수락하지 않습니다. 기본적으로 이 값은 true로 설정됩니다.

**기본값:** True