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

# 테스트 세트 관리
<a name="manage-test-sets"></a>

테스트 세트 창에서 테스트 세트를 다운로드, 업데이트 및 삭제할 수 있습니다. 또는 사용 가능한 테스트 세트 목록을 사용하여 테스트 세트 파일을 편집하거나 수동으로 주석을 달 수 있습니다. 그런 다음 오류나 기타 입력 문제로 인해 다시 업로드하여 검증을 다시 시도하세요.

**테스트 세트 레코드에서 테스트 세트 파일을 다운로드하려면:**

1. 테스트 세트 목록에서 테스트 세트 이름을 선택합니다.

1. 테스트 세트 레코드 창에서 화면 오른쪽의 **테스트 입력** 섹션에 있는 **다운로드** 버튼을 선택합니다.

1. 창 상단에 테스트 세트와 관련된 검증 오류 세부 정보가 있는 경우 **다운로드** 버튼을 선택하세요. 파일이 다운로드 폴더에 저장됩니다. 테스트 세트 CSV 파일의 오류 메시지에서 테스트 세트의 검증 오류를 수정할 수 있습니다. 검증 단계에서 식별된 오류를 찾아 라인을 수정하거나 제거한 다음 파일을 업로드하여 검증 단계를 다시 시도합니다.

1. 테스트 세트를 성공적으로 다운로드하면 녹색 배너 메시지가 나타납니다.

**테스트 세트 목록에서 테스트 세트를 다운로드하려면:**

1. 테스트 세트 목록에서 다운로드할 테스트 세트 항목 옆의 라디오 버튼을 선택합니다.

1. 오른쪽 상단의 작업 메뉴에서 **다운로드**를 선택합니다.

1. 테스트 세트를 성공적으로 다운로드했는지 여부를 나타내는 녹색 배너 메시지가 나타납니다. 파일이 다운로드 폴더에 저장됩니다.

# Test Workbench에서 지원하는 테스트 세트 열
<a name="file-input-test-sets"></a>

다음은 Test Workbench에서 지원하는 테스트 세트 열의 전체 목록과 Amazon Lex V2와 함께 사용하는 방법에 대한 지침입니다.


| 열 이름 | 테스트 세트 유형 | 값 유형 | 다중 열 지원 | 설명 | 
| --- | --- | --- | --- | --- | 
|  행 번호  |  텍스트 및 오디오  | 숫자 | 아니요 | Amazon Lex V2에서 무시되는 사용자 열입니다. 테스트 세트 작성자가 테스트 세트 행을 정렬하고 필터링할 수 있도록 돕기 위한 것입니다. 'Line \$1'를 대체 열 이름으로 사용할 수 있습니다. | 
|  대화 번호  |  텍스트 및 오디오  | 숫자 | 아니요 | 이 열을 사용하면 대화에 행을 함께 넣을 수 있습니다. 'Conversation \$1'를 대체 열 이름으로 사용할 수 있습니다. | 
|  소스  |  텍스트 및 오디오  | 열거형('사용자', '에이전트') | 아니요 | 이 열의 값은 행이 사용자용인지 에이전트용인지를 나타냅니다. 'Conversation Participant'를 대체 열 이름으로 사용할 수 있습니다. | 
|  Input  |  텍스트  | 문자열 | No | 이 열은 텍스트 테스트 세트에 대한 트랜스크립트를 추가하는 데 사용됩니다. 텍스트 입력은 사용자 행에 사용해야 합니다. 에이전트 프롬프트는 에이전트 행에 사용해야 합니다. | 
|  예상 트랜스크립션  |  오디오  | 문자열 | No | 이 열은 오디오 테스트 세트의 트랜스크립트를 추가하는 데 사용됩니다. 오디오 파일의 예상 트랜스크립션은 오디오 입력이 있는 사용자 행에서 사용해야 합니다. DTMF 입력은 DTMF 입력이 있는 사용자 행에서 사용할 수 있습니다. 에이전트 프롬프트는 에이전트 행에 사용해야 합니다. | 
|  S3 오디오 위치  |  오디오  | 문자열 | No | 이 열은 오디오 파일 위치를 추가하는 데 사용되며 오디오 테스트 세트에만 적용됩니다. S3 경로는 오디오 입력과 함께 사용자 행에서 사용해야 합니다. DTMF 입력이 있는 사용자 행에서 이 필드는 비워 두어야 합니다. 에이전트 행에서 이 필드는 비워 두어야 합니다. | 
|  입력 컨텍스트 태그  |  텍스트 및 오디오  | 문자열 | 예 | 이 열은 테스트 세트에서 행을 실행하는 동안 Lex에 입력하는 데 사용할 입력 컨텍스트의 이름을 제공하는 데 사용됩니다. 이는 [Lex V2 봇에 대한 의도 컨텍스트 설정의 입력 컨텍스트](https://docs.aws.amazon.com/lexv2/latest/dg/context-mgmt-active-context.html)를 나타냅니다. Test Workbench는 컨텍스트 이름만 지원합니다. 컨텍스트에서는 파라미터를 지원하지 않습니다. 'Input Context Tag 1', 'Input Context Tag 2' 등과 같은 이름이 지정된 여러 열을 사용할 수 있습니다. | 
|  요청 속성  |  텍스트 및 오디오  | 문자열 | 예 | 이 열은 테스트 세트에서 행을 실행하는 동안 Lex에 입력하는 데 사용할 요청 속성을 제공하는 데 사용됩니다. 열의 값은 '<request-attribute-name> = <request-attribute-value>' 형식으로 제공해야 합니다. 가독성을 위해 '=' 주위에 공백을 추가할 수 있습니다. 예: request-attribute-foo = 이것은 더미 응답 request-attribute-foo = '이것은 '더미 응답'' request-attribute-foo = '이것은 '더미 응답''입니다. 'Request Attribute 1', 'Request Attribute 2' 등과 같은 이름이 지정된 여러 열을 사용할 수 있습니다. | 
|  세션 속성  |  텍스트 및 오디오  | 문자열 | 예 | 이 열은 테스트 세트에서 행을 실행하는 동안 Lex에 입력하는 데 사용할 세션 속성을 제공하는 데 사용됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/lexv2/latest/dg/file-input-test-sets.html)  | 
|  런타임 힌트  |  텍스트 및 오디오  | 문자열 | 예 | 이 열은 테스트 세트에서 행을 실행하는 동안 Lex에 입력하는 데 사용되는 의도 내의 슬롯에 대한 런타임 힌트를 제공하는 데 사용됩니다. 다음은 두 가지 예입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/lexv2/latest/dg/file-input-test-sets.html)  | 
|  감청  |  오디오  | 부울 | 아니요 | 이 열은 테스트 세트의 행에 대해 오디오 파일을 Lex 런타임으로 전송할 때 Test Workbench가 개입해야 하는지 여부를 지정합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/lexv2/latest/dg/file-input-test-sets.html)  | 
|  예상 출력 의도  |  텍스트 및 오디오  | 문자열 | No | 이 열은 테스트 세트의 행에 대해 Lex의 출력에서 예상되는 의도의 이름을 지정하는 데 사용됩니다. | 
|  예상 출력 슬롯  |  텍스트 및 오디오  | 문자열 | 예 | 이 열은 테스트 세트에서 행을 실행하는 동안 Lex의 출력에 예상되는 슬롯 값을 제공하는 데 사용됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/lexv2/latest/dg/file-input-test-sets.html)  | 
|  예상 출력 컨텍스트 태그  |  텍스트 및 오디오  | 문자열 | 예 | 이 열은 테스트 세트의 행에 대해 Lex의 출력에 예상되는 출력 컨텍스트의 이름을 지정하는 데 사용됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/lexv2/latest/dg/file-input-test-sets.html)  | 

# Test Workbench에서 테스트 검증 오류 보기
<a name="view-errors-test-sets"></a>

검증 오류를 보고하는 테스트 세트를 수정할 수 있습니다. 이러한 검증 오류는 테스트 세트를 테스트할 준비가 되지 않은 경우 생성됩니다. Test Workbench는 테스트 세트 입력 CSV 파일에서 예상 형식의 값이 없는 필수 열을 표시할 수 있습니다.

**테스트 검증 오류를 보려면:**

1. 테스트 세트 목록에서 확인하려는 **검증 오류** 상태를 보고하는 테스트 세트의 이름을 선택합니다. 테스트 세트의 이름은 테스트 세트에 대한 세부 정보로 이동하는 활성 링크입니다.

1. 테스트 세트 레코드는 화면 상단에 확인 오류 세부 정보를 표시합니다. **세부 정보 보기**를 선택하여 검증 오류에 대한 보고서를 확인합니다.

1. 오류 보고서 창에서 행 번호 및 오류 유형을 검토하여 오류가 발생한 위치를 확인합니다. 긴 오류 목록을 보려면 오류 보고서 **다운로드**를 선택할 수 있습니다.

1. 테스트 세트 입력 CSV 파일에 나열된 오류를 원본 테스트 파일과 비교하여 문제를 수정하고 테스트 세트를 다시 업로드하세요.

다음 표에는 시나리오와 함께 입력 CSV 검증 오류 메시지가 나열되어 있습니다.


| 시나리오 | 오류 메시지 | 참고 | 
| --- | --- | --- | 
|  테스트 세트 파일 크기 초과  |  테스트 세트 파일 크기가 200MB보다 큽니다. 더 작은 파일을 제공하고 요청을 다시 시도하세요.  |  | 
| 테스트 세트가 최대 레코드 초과 | 입력 파일의 레코드가 지원되는 최대 개수인 200,000개를 초과했습니다. |  | 
| 빈 테스트 세트 업로드 | 가져온 테스트 세트가 비어 있습니다. 비어 있지 않은 테스트 세트를 제공하고 요청을 다시 시도하세요. |  | 
| 빈 열 헤더 이름 | 열 헤더 행: 열 번호 5에서 빈 열 이름을 찾았습니다. |  | 
| 인식할 수 없는 열 헤더 이름 | 열 헤더 행: 열 번호 2에서 열 이름 '더미'를 인식할 수 없습니다. |  | 
| 중복된 열 헤더 이름 | 열 헤더 행: 'S3 오디오 링크' 및 'S3 오디오 링크' 중 동일하거나 동등한 여러 열을 찾았습니다. 해당 열 중 하나를 제거하거나 이름을 변경하세요. |  | 
| 다중 값 열 이름 제한 초과 | 열 헤더 행: '예상 출력 슬롯'의 열 수가 지원되는 최대 개수(6개)를 초과했습니다. '예상 출력 슬롯'의 일부 열을 삭제하고 다시 시도하세요. | 다중 값 열에 지원되는 최대 열 수는 6입니다.  | 
| 텍스트 또는 오디오 관련 열 헤더 없음 | 텍스트 또는 음성 대화의 열을 찾을 수 없습니다. 텍스트 대화의 경우 \$1'Text input'\$1 열을 사용하세요. 음성 대화의 경우 \$1'S3 audio link', 'Expected transcription'\$1 열을 사용하세요. | 오디오 필수 항목: \$1'S3 audio link', 'Expected transcription'\$1 텍스트 필수 항목: \$1'Text input'\$1 | 
| 텍스트 및 오디오 관련 열 헤더가 모두 존재  | 텍스트 대화와 음성 대화 모두에 대한 열을 찾았습니다. 텍스트 대화에는 \$1'Text input'\$1 열을, 음성 대화에는 \$1'S3 audio link', 'Expected transcription'\$1 열을 사용할 수 있습니다. | 오디오 필수 항목: \$1'S3 audio link', 'Expected transcription'\$1 텍스트 필수 항목: \$1'Text input'\$1 | 
| 필수 열이 누락되었음 | 필수 열 ["Expected Output Intent"]를 찾을 수 없습니다. | 필수 열: \$1"Line \$1", "Source", "Expected Output Intent"\$1 | 
| 헤더가 없는 열의 데이터를 찾았습니다 | 행 번호 6의 열 번호 8에서 데이터를 찾았지만 해당 열에 열 헤더가 없습니다. |  | 
| 필수 열에 대한 데이터를 찾을 수 없음 | 행=12: 필수 열에 대한 값을 찾을 수 없음: \$1"Source", "Expected Output Intent"\$1 |  | 
| 중복된 대화 ID가 발견됨 | 이전 대화의 경우 39번 행에서 대화 번호 '19'가 표시되었습니다.” 두 대화에 동일한 대화 번호가 입력되지 않았는지 확인하세요. 대화 번호의 모든 행을 함께 그룹화하면 됩니다. |  | 
| 잘못된 대화 ID가 제공됨 | '대화 번호' 열에서 잘못된 값인 'test\$1convertion'을 찾았습니다. 이 열의 값은 사용자 행의 경우 숫자이거나 N/A(예: 해당 없음)이어야 합니다. |  | 
| 행 번호에 숫자가 아닌 값이 제공됨 | '행 번호' 열에서 숫자가 아닌 값 'test\$1line'을 찾았습니다. 값은 숫자여야 합니다. |  | 
| 에이전트 행에서 대화 ID를 찾을 수 없음 | '대화 번호' 열에 값을 찾을 수 없습니다. 에이전트 행에 입력해야 합니다. |  | 
| 에이전트 행에서 숫자가 아닌 대화 ID 발견됨 | '대화 번호' 열에서 숫자가 아닌 값인 'test\$1convergation'을 찾았습니다. 에이전트 행의 값은 숫자여야 합니다. |  | 
| 유효하지 않은 S3 위치 | 잘못된 값 '버킷 및 폴더'가 제공되었습니다. 유효한 형식은 S3:<bucketName>//<keyName>/입니다. |  | 
| 유효하지 않은 S3 버킷 이름 | 잘못된 s3 버킷 이름 'test\$1bucket'이 제공되었습니다. 버킷 이름을 확인하세요. |  | 
| S3 오디오 위치는 폴더입니다 | 제공된 오디오 위치 'S3://bucket/folder'가 유효하지 않습니다. S3 폴더를 가리킵니다. |  | 
| 유효하지 않은 의도 이름 | 'intent @name '의도에 잘못된 문자가 있었습니다. 의도 이름을 확인하세요. | 정규식 검사: ^([0-9a-zA-Z][\$1-]?)\$1\$1 | 
| 잘못된 슬롯 이름 | 'Slot@Name' 슬롯에 잘못된 문자가 있었습니다. 슬롯 이름을 확인하세요. | 정규식: ^([0-9a-zA-Z][\$1-]?)\$1\$1 (.)으로 시작하거나 끝나서는 안 됩니다. | 
| 부모 슬롯에 제공된 슬롯 값 | 하위 슬롯 'Address.City'와 상위 슬롯 'Address'에 대해 슬롯 값이 제공되었습니다. 값은 하위 슬롯에만 제공해야 합니다. | CST의 상위 슬롯에는 슬롯 값이 없어야 합니다. | 
| 컨텍스트 이름에 잘못된 문자가 있음 | 컨텍스트 이름 'context@1'에 잘못된 문자가 있었습니다. 컨텍스트 이름을 확인하세요. | 정규식: ^([A-Za-z]\$1?)\$1\$1 | 
| 잘못된 슬롯 철자 스타일 | 잘못된 값 'test'가 제공되었습니다. 모두 대문자인지 확인하세요. 유효한 값은 ["Default", "SpellByLetter", "SpellByWord"]입니다. | 지원되는 값["Default", "SpellByLetter", "SpellByWord" | 
| 참가자 또는 출처는 에이전트 또는 사용자여야 합니다. | 잘못된 값 'bot'이 제공되었습니다. 유효한 값은 ["Agent", "User"]입니다. | 지원되는 열거형: "Agent", "User" | 
| 줄 번호는 10진수가 아니어야 합니다 | 잘못된 값 '10.1'이 제공되었습니다. 분수가 없는 유효한 숫자여야 합니다. |  | 
| 대화 번호는 10진수가 아니어야 합니다 | 잘못된 값 '10.1'이 제공되었습니다. 분수가 없는 유효한 숫자여야 합니다. |  | 
| 행 번호는 범위 내에 있어야 합니다. | 잘못된 값 '92233720368547758071'이 제공되었습니다. 1보다 크거나 같고 9223372036854775807 보다 작아야 합니다. |  | 
| 개입 열에는 부울 값만 입력할 수 있습니다 | 잘못된 값 'test'가 제공되었습니다. 이 값은 'true' 또는 'false'와 같은 유효한 부울 값이어야 합니다. 또는 'yes'와 'no'를 사용할 수 있습니다. | 가능한 값: "True", "true", "T", "Yes", "yEs", "Y", "1", "1.0", "False", "false", "F", "No", "no", "N", "0", "0.0" | 
| 예상 슬롯, 세션 속성, 요청 속성은 같은 값(=)으로 구분해야 합니다. | 값 'slotName:slotValue'에는 '='가 없습니다. 이러한 값은 '<key>=<value>' 형식의 키-값 쌍으로 제공해야 합니다. | 예: slotName = slotType | 
| 예상 슬롯, 세션 속성, 요청 속성에는 키 값 쌍이 있어야 합니다. | '=slotValue'는 '=' 앞에 키가 없습니다. 이러한 값은 '<key>=<value>' 형식의 키-값 쌍으로 제공해야 합니다. | 예: slotName = slotType | 
| 끝에 있는 따옴표가 잘못되었습니다  | 'Foo's item'"에서 잘못된 따옴표를 찾았습니다. 따옴표 문자 `"`로 시작하지만 같은 따옴표로 끝나지는 않습니다. | 예: '"Foo's item", KFC' | 
| 중간에 있는 인용문이 잘못되었습니다 | '"Foo's" Burger, etc.'에서 잘못된 인용문을 찾았습니다. 내용 안에 따옴표 문자 `"`가 포함되어 있습니다. 작은따옴표가 포함된 값은 큰따옴표로 묶어야 하며 그 반대의 경우도 마찬가지입니다. | 올바른 예: '"Foo's item", KFC' | 
| 필수 따옴표 | 'key = Foo's item'에는 작은따옴표 또는 큰따옴표가 포함되지만 따옴표로 묶이지 않았습니다. 작은따옴표가 포함된 값은 큰따옴표로 묶어야 하며 그 반대의 경우도 마찬가지입니다. |  | 
| 열에 중복된 키가 반복됨  | 키 `key1`이 `세션 속성 3`과 `세션 속성 1`이라는 두 개의 열에서 반복되었습니다. |  | 
| 런타임 힌트의 형식이 잘못되었습니다. | 런타임 힌트에 잘못된 키 'BookFlight.Car."'가 제공되었습니다. 런타임 힌트의 경우 키의 형식은 <intentName>.<slotName>이어야 합니다. | 키 중간에 '.'가 있어야 하는 경우 해당 키에서 의도 이름과 슬롯 이름을 추출할 수 없습니다. 이러한 잘못된 형식의 예: "BookFlight", ".BookFlight.Car", "BookFlight.Car." | 
| 런타임 힌트 키의 의도 이름이 잘못되었습니다 | 런타임 힌트에서 잘못된 의도 'intent@name'이 발견되었습니다. 의도 이름을 확인하세요. | 정규식 검사: ^([0-9a-zA-Z][\$1-]?)\$1\$1 | 
| 런타임 힌트 키의 슬롯 이름이 잘못되었습니다 | 런타임 힌트의 'Slot@Name'에서 잘못된 슬롯 이름을 찾았습니다. 슬롯 이름을 확인하세요. | 정규식: ^([0-9a-zA-Z][\$1-]?)\$1\$1 (.)으로 시작하거나 끝나서는 안 됩니다. | 

# Test Workbench에서 테스트 세트 삭제
<a name="delete-test-sets"></a>

테스트 세트 목록에서 테스트 세트를 쉽게 삭제할 수 있습니다.

**테스트 세트를 삭제하려면:**

1. 왼쪽 메뉴에서 **테스트 세트** 목록으로 이동하여 테스트 세트 목록을 확인하세요.

1. 테스트 세트 목록에서 삭제할 테스트 세트를 선택합니다.

1. 오른쪽 상단의 **작업** 드롭다운 메뉴로 이동하여 **삭제**를 선택합니다.

1. 테스트 세트가 삭제되었음을 확인하는 메시지가 나타납니다.

# 테스트 세트 세부 정보 편집
<a name="edit-details-test-sets"></a>

테스트 세트 목록에서 테스트 세트 이름과 세부 정보를 편집할 수 있습니다. 이름 또는 세부 정보는 나중에 추가하거나 업데이트할 수 있습니다. 하지만 봇 또는 트랜스크립션 데이터로 테스트를 실행하기 전에 테스트 세트를 업데이트해야 합니다.

**테스트 세트 세부 정보를 편집하려면:**

1. 왼쪽 메뉴에서 테스트 세트 목록으로 이동하여 테스트 세트 목록을 확인하세요.

1. 테스트 세트 목록에서 편집할 테스트 세트의 확인란을 선택합니다.

1. 오른쪽 상단의 **작업** 드롭다운 메뉴로 이동하여 **세부 정보 편집**을 선택합니다.

1. 테스트 세트가 성공적으로 편집되었다는 확인 메시지가 나타납니다.

# 테스트 세트 업데이트
<a name="update-test-sets"></a>

테스트 세트에서 항목을 업데이트, 수정, 삭제하여 베이스라인 결과를 최적화하거나 테스트 세트에서 발생했을 수 있는 기타 오류를 수정할 수 있습니다.

수정된 테스트 세트를 업로드하기 전에 테스트 세트를 다운로드하고 검증 오류를 수정할 수 있습니다. [테스트 검증 오류 보기](https://docs.aws.amazon.com/lexv2/latest/dg/view-errors-test-sets.html)를 참조하세요.

**테스트 세트를 업데이트하려면:**

1. 테스트 세트 레코드에서 오른쪽 상단의 **테스트 세트 업데이트** 버튼을 선택합니다.

1. Amazon S3 계정에서 업로드할 파일을 선택하거나 컴퓨터에서 CSV 테스트 파일을 업로드합니다. 참고: 테스트 세트를 업데이트하면 기존 데이터를 덮어쓰게 됩니다.

1. **업데이트** 버튼을 선택합니다.

1. 테스트 세트가 성공적으로 업데이트되었다는 확인 메시지가 나타납니다. 참고: 이 작업은 테스트 세트의 복잡성과 크기에 따라 몇 분 정도 걸릴 수 있습니다.

1. 테스트 세트가 성공적으로 업데이트되었다는 확인 메시지가 나타나고 **상태**는 **테스트 준비 완료로** 표시됩니다.