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

# 목록을 사용하여 사용자 지정 어휘 생성
<a name="custom-vocabulary-create-list"></a>

**중요**  
목록 형식의 사용자 지정 어휘는 더 이상 사용되지 않으므로 새 사용자 지정 어휘를 생성하는 경우 [테이블 형식](custom-vocabulary-create-table.md)을 사용하는 것이 좋습니다.

또는 AWS Management Console AWS CLI AWS SDKs.
+ **AWS Management Console**: 사용자 지정 어휘가 포함된 텍스트 파일을 생성하고 업로드해야 합니다. 줄로 구분하거나 쉼표로 구분한 항목을 사용할 수 있습니다. 목록은 텍스트(\*.txt) 파일로 저장해야 합니다. `LF` 및 `CRLF` 줄 끝이 모두 지원됩니다.
+ **AWS CLI** 및 **AWS SDK**: [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html#transcribe-CreateVocabulary-request-Phrases](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html#transcribe-CreateVocabulary-request-Phrases) 플래그를 사용하여 사용자 지정 어휘를 API 호출 내의 쉼표로 구분된 항목으로 포함해야 합니다.

항목에 여러 단어가 포함된 경우 각 단어에 하이픈을 넣어야 합니다. 예를 들어 'Los Angeles'는 **Los-Angeles**로 포함하고 'Andorra la Vella'는 **Andorra-la-Vella**로 포함합니다.

다음은 두 가지 유효한 목록 형식의 예입니다. 메서드별 예시는 [사용자 지정 어휘 목록 생성](#custom-vocabulary-create-list-examples)를 참조하세요.
+ 쉼표로 구분된 항목:

  ```
  Los-Angeles,CLI,Eva-Maria,ABCs,Andorra-la-Vella
  ```
+ 줄로 구분된 항목:

  ```
  Los-Angeles
  CLI
  Eva-Maria
  ABCs
  Andorra-la-Vella
  ```

**중요**  
해당 언어에 지원되는 문자만 사용할 수 있습니다. 자세한 내용은 해당 언어의 [문자 집합](charsets.md)을 참조하세요.

사용자 지정 어휘 목록은 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html) 작업에서 지원되지 않습니다. 사용자 지정 의료 어휘를 생성하는 경우 테이블 형식을 사용해야 합니다. 지침은 [테이블을 사용하여 사용자 지정 어휘 생성](custom-vocabulary-create-table.md)를 참조하세요.

## 사용자 지정 어휘 목록 생성
<a name="custom-vocabulary-create-list-examples"></a>

에서 사용할 사용자 지정 어휘 목록을 처리하려면 다음 예제를 Amazon Transcribe참조하세요.

### AWS CLI
<a name="vocab-create-list-cli"></a>

이 예시에서는 목록 형식의 사용자 지정 어휘 파일과 함께 [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) 명령을 사용합니다. 자세한 내용은 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html) 단원을 참조하십시오.

```
aws transcribe create-vocabulary \ 
--vocabulary-name {{my-first-vocabulary}} \ 
--language-code {{en-US}} \ 
--phrases {{{CLI,Eva-Maria,ABCs}}}
```

다음은 [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) 명령을 사용하는 또 다른 예 및 사용자 지정 어휘를 생성하는 요청 본문입니다.

```
aws transcribe create-vocabulary \
--cli-input-json file://{{filepath}}/{{my-first-vocab-list}}.json
```

*my-first-vocab-list.json* 파일에는 다음과 같은 요청 본문이 포함되어 있습니다.

```
{
  "VocabularyName": "{{my-first-vocabulary}}",
  "LanguageCode": "{{en-US}}",
  "Phrases": [
        "{{CLI}}","{{Eva-Maria}}","{{ABCs}}"
  ]
}
```

`VocabularyState`가 `PENDING`에서 `READY`로 변경되면 사용자 지정 어휘를 트랜스크립션과 함께 사용할 수 있습니다. 사용자 지정 어휘의 현재 상태를 보려면 다음을 실행합니다.

```
aws transcribe get-vocabulary \
--vocabulary-name {{my-first-vocabulary}}
```

### AWS SDK for Python (Boto3)
<a name="vocab-create-list-python-batch"></a>

이 예제에서는 AWS SDK for Python (Boto3) 를 사용하여 [create\_vocabulary 메서드를 사용하여 목록에서 사용자 지정 어휘](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_vocabulary)를 생성합니다. 자세한 내용은 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html) 단원을 참조하십시오.

기능별, 시나리오 및 교차 서비스 예제 AWS SDKs를 사용하는 추가 예제는 [AWS SDKs를 사용한 Amazon Transcribe의 코드 예제](service_code_examples.md)장을 참조하세요.

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
vocab_name = "{{my-first-vocabulary}}"
response = transcribe.create_vocabulary(
    LanguageCode = '{{en-US}}',
    VocabularyName = vocab_name,
    Phrases = [
        '{{CLI}}','{{Eva-Maria}}','{{ABCs}}'
    ]
)

while True:
    status = transcribe.get_vocabulary(VocabularyName = vocab_name)
    if status['VocabularyState'] in ['READY', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```

**참고**  
사용자 지정 어휘 파일에 대한 새 Amazon S3 버킷을 생성하는 경우 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html) 요청을 하는 IAM 역할에이 버킷에 액세스할 수 있는 권한이 있는지 확인합니다. 역할에 올바른 권한이 없는 경우 요청이 실패합니다. 선택적으로 `DataAccessRoleArn` 파라미터를 포함하여 요청 내에서 IAM 역할을 지정할 수 있습니다. 의 IAM 역할 및 정책에 대한 자세한 내용은 섹션을 Amazon Transcribe참조하세요[Amazon Transcribe 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md).