지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단할 예정입니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 [Amazon Lex V2 가이드를](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Lex 봇, 의도 및 슬롯 유형을 가져오고 내보내기
Amazon Lex 봇, 의도 또는 슬롯 유형을 가져오거나 내보낼 수 있습니다. 예를 들어 다른 AWS 계정의 동료와 봇을 공유하려면 봇을 내보낸 다음 동료에게 보낼 수 있습니다. 봇에 여러 개의 utterance를 추가하려면 봇을 내보내고 utterance를 추가한 다음 해당 봇을 계정으로 다시 가져올 수 있습니다.
Amazon Lex 봇, 인텐트 및 슬롯 유형을 Amazon Lex(공유 또는 수정) 또는 Alexa 스킬 형식으로 *내보내기* 할 수 있습니다. *가져오기*는 Amazon Lex 형식으로만 가능합니다.
리소스를 내보낼 때는 내보내고 있는 대상 서비스, Amazon Lex 또는 Alexa Skills Kit와 호환되는 형식으로 내보내야 합니다. 봇을 Amazon Lex 형식으로 내보내는 경우 해당 봇을 내 계정으로 다시 가져올 수 있으며, 다른 계정의 Amazon Lex 사용자가 자신의 계정으로 가져올 수도 있습니다. 또한 Alexa Skill과 호환되는 형식으로 봇을 내보낼 수 있습니다. 그런 다음 Alexa Skills Kit를 사용하여 봇을 가져와서 Alexa와 함께 사용 가능하도록 설정할 수 있습니다. 자세한 내용은 [Alexa Skill로 내보내기](export-to-alexa.md)을 참조하세요.
봇, 의도 또는 슬롯 유형을 내보낼 때 해당 리소스는 JSON 파일에 기록됩니다. 봇, 의도 또는 슬롯 유형을 내보내기 위해 Amazon Lex 콘솔 또는 [GetExport](API_GetExport.md) 작업을 사용할 수 있습니다. [StartImport](API_StartImport.md) 섹션을 참조하여 봇, 의도 또는 슬롯 유형을 가져옵니다.
**Topics**
+ [
# Amazon Lex 형식으로 내보내기 및 가져오기
](import-export-lex.md)
+ [
# Alexa Skill로 내보내기
](export-to-alexa.md)
# Amazon Lex 형식으로 내보내기 및 가져오기
Amazon Lex로 다시 가져올 목적으로 봇, 의도 및 슬롯 유형을 Amazon Lex로부터 내보내려면 Amazon Lex 형식의 JSON 파일을 사용합니다. 이 파일에서 리소스를 편집하고 Amazon Lex로 다시 가져올 수 있습니다. 예를 들어 의도에 utterance를 추가한 다음 변경된 의도를 계정으로 다시 가져올 수 있습니다. JSON 형식을 사용하여 리소스를 공유할 수도 있습니다. 예를 들어 한 AWS 리전 에서 봇을 내보낸 다음 다른 리전으로 가져올 수 있습니다. 또는 JSON 파일을 동료에게 보내 봇을 공유할 수 있습니다.
**Topics**
+ [
# Amazon Lex 형식으로 내보내기
](export-to-lex.md)
+ [
# Amazon Lex 형식으로 가져오기
](import-from-lex.md)
+ [
# 내보내기 및 가져오기를 위한 JSON 형식
](import-export-format.md)
# Amazon Lex 형식으로 내보내기
Amazon Lex 봇, 의도 및 슬롯 유형을 AWS 계정으로 가져올 수 있는 형식으로 내보냅니다. 다음과 같은 리소스를 내보낼 수 있습니다.
+ 봇 - 봇에서 사용하는 모든 의도 및 사용자 지정 슬롯 유형 포함
+ 의도 - 의도에서 사용하는 모든 사용자 지정 슬롯 유형 포함
+ 사용자 지정 슬롯 유형 - 슬롯 유형의 모든 값 포함
번호가 지정된 버전의 리소스만 내보낼 수 있습니다. 리소스의 `$LATEST` 버전은 내보낼 수 없습니다.
내보내기는 비동기식 프로세스입니다. 내보내기가 완료되면 미리 서명된 Amazon S3 URL을 얻을 수 있습니다. URL은 내보낸 리소스가 포함된 .zip 아카이브의 위치를 JSON 형식으로 제공합니다.
콘솔 또는 [GetExport](API_GetExport.md) 작업을 사용하여 봇, 의도 및 사용자 지정 슬롯 유형을 내보냅니다.
봇, 의도 또는 슬롯 유형 내보내기 절차는 동일합니다. 다음 절차에서는 봇에 대한 의도 또는 슬롯 유형을 대체합니다.
## 봇 내보내기
**봇을 내보내려면**
1. AWS Management Console 에 로그인하여 [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)에서 Amazon Lex 콘솔을 엽니다.
1. **봇**을 선택한 다음 내보낼 봇을 선택합니다.
1. **작업** 메뉴에서 **내보내기**를 선택합니다.
1. **봇 내보내기** 대화 상자에서 내보낼 봇의 버전을 선택합니다. **플랫폼**으로 **Amazon Lex** 를 선택합니다.
1. **내보내기**를 선택합니다.
1. .zip 아카이브를 다운로드하고 저장합니다.
Amazon Lex에서 .zip 아카이브에 포함된 JSON 파일로 봇을 내보냅니다. 봇을 업데이트하려면 JSON 텍스트를 수정한 다음 Amazon Lex로 다시 가져옵니다.
**다음 단계**
[Amazon Lex 형식으로 가져오기](import-from-lex.md)
# Amazon Lex 형식으로 가져오기
리소스를 Amazon Lex 형식의 JSON 파일로 내보낸 후 리소스가 포함된 JSON 파일을 하나 이상의 AWS 계정으로 가져올 수 있습니다. 예를 들어 한 봇을 내보낸 다음 다른 AWS 리전 으로 가져올 수 있습니다. 또는 동료가 봇을 자신의 계정으로 가져올 수 있도록 해당 봇을 동료에게 보낼 수 있습니다.
봇, 의도 또는 슬롯 유형을 가져올 때는 가져오기 도중에 의도 또는 슬롯 유형과 같은 리소스의 `$LATEST` 버전을 덮어쓸지 여부를 결정하거나, 계정에 있는 리소스를 보존하기 위해 가져오기가 실패하기를 원하는지 결정해야 합니다. 예를 들어 리소스의 편집된 버전을 계정에 업로드하는 경우 `$LATEST` 버전을 덮어쓰도록 선택할 수 있습니다. 동료가 보낸 리소스를 업로드하는 경우에는 리소스 충돌이 있으면 내 고유 리소스가 교체되지 않게 하기 위해 가져오기가 실패하도록 선택할 수 있습니다.
리소스를 가져올 때는 가져오기를 요청하는 사용자에게 할당되어 있는 권한이 적용됩니다. 사용자는 가져오기가 영향을 미치는 계정의 모든 리소스에 대한 권한이 있어야 합니다. 또한 사용자는 [GetBot](API_GetBot.md), [PutBot](API_PutBot.md), [GetIntent](API_GetIntent.md), [PutIntent](API_PutIntent.md), [GetSlotType](API_GetSlotType.md), [PutSlotType](API_PutSlotType.md) 작업에 대한 권한이 있어야 합니다. 권한에 대한 자세한 내용은 [Amazon Lex에서 IAM을 사용하는 방법](security_iam_service-with-iam.md)을 참조하세요.
가져오기는 처리 중에 발생하는 오류를 보고합니다. 일부 오류는 가져오기가 시작되기 전에 보고되고 다른 오류는 가져오기 프로세스 중에 보고됩니다. 예를 들어 의도를 가져오는 계정에 해당 의도가 사용하는 Lambda 함수에 대한 호출 권한이 없는 경우, 슬롯 유형 또는 의도에 변경이 가해지기 전에 가져오기가 실패합니다. 가져오기 프로세스 중에 가져오기가 실패하는 경우 프로세스 실패 이전에 가져온 모든 의도 또는 슬롯 유형의 `$LATEST` 버전이 수정됩니다. `$LATEST` 버전에 만들어진 변경 사항을 롤백할 수 없습니다.
리소스를 가져오는 경우 모든 종속 리소스는 리소스의 `$LATEST` 버전으로 가져오기된 다음 번호가 지정된 버전을 부여받습니다. 예를 들어, 봇이 의도를 사용하는 경우 해당 의도에 번호가 지정된 버전이 부여되며, 의도가 사용자 지정 슬롯 유형을 사용하는 경우 해당 슬롯 유형에 번호가 지정된 버전이 부여됩니다.
리소스는 한 번만 가져오기됩니다. 예를 들어 봇에 `OrderPizza` 의도와 `OrderDrink` 의도가 포함되어 있고 두 의도 모두 사용자 지정 슬롯 유형 `Size`에 의존하는 경우, `Size` 슬롯 유형은 한 번 가져오기되며 두 의도 모두에 사용됩니다.
**참고**
`enableModelImprovements` 파라미터가 `false`로 설정된 상태로 봇을 내보낸 경우, 봇 정의가 포함된 .zip 파일을 열고 `enableModelImprovements` 파라미터를 다음 지역에서 `true`로 변경해야 합니다.
아시아 태평양(싱가포르)(ap-southeast-1)
아시아 태평양(도쿄)(ap-northeast-1)
EU(프랑크푸르트)(eu-central-1)
EU(런던)(eu-west-2)
봇, 의도 또는 사용자 지정 슬롯 유형 가져오기 절차는 동일합니다. 다음 절차에서는 상황에 맞게 의도 또는 슬롯 유형을 대체합니다.
## 봇 가져오기
**봇을 가져오려면**
1. AWS Management Console 에 로그인하여 [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)에서 Amazon Lex 콘솔을 엽니다.
1. **봇**을 선택한 다음 가져올 봇을 선택합니다. 새 봇을 가져오려면 이 단계를 건너뜁니다.
1. **작업**에서 **가져오기**를 선택합니다.
1. **봇 가져오기**에서 가져올 봇이 포함된 JSON 파일을 포함하는 .zip 아카이브를 선택합니다. 병합 전에 병합 충돌을 확인하려면 **병합 충돌 알림**을 선택합니다. 충돌 확인 기능을 끄면 봇에서 사용되는 모든 리소스의 `$LATEST` 버전이 덮어쓰기됩니다.
1. **가져오기**를 선택합니다. 병합 충돌에 대한 알림을 받도록 선택한 경우 충돌이 있으면 해당 충돌이 리스트된 대화 상자가 나타납니다. 충돌하는 모든 리소스의 `$LATEST` 버전을 덮어쓰려면 **덮어쓰고 계속**을 선택합니다. 가져오기를 중지하려면 **취소**를 선택합니다.
이제 계정에서 봇을 테스트할 수 있습니다.
# 내보내기 및 가져오기를 위한 JSON 형식
다음 예에서는 Amazon Lex 형식의 봇, 의도 및 슬롯 유형을 내보내고 가져오기 위한 JSON 구조를 보여 줍니다.
## 슬롯 유형 구조
다음은 사용자 지정 슬롯 유형에 대한 JSON 구조입니다. 슬롯 유형을 가져오거나 내보낼 때 그리고 사용자 정의 슬롯 유형에 의존하는 의도를 내보낼 때 이 구조를 사용하세요.
```
{
"metadata": {
"schemaVersion": "1.0",
"importType": "LEX",
"importFormat": "JSON"
},
"resource": {
"name": "slot type name",
"version": "version number",
"enumerationValues": [
{
"value": "enumeration value",
"synonyms": []
},
{
"value": "enumeration value",
"synonyms": []
}
],
"valueSelectionStrategy": "ORIGINAL_VALUE or TOP_RESOLUTION"
}
}
```
## 의도 구조
다음은 의도에 대한 JSON 구조입니다. 의도 및 의도에 의존하는 봇을 가져오거나 내보낼 때 이 구조를 사용하십세요.
## 봇 구조
다음은 봇에 대한 JSON 구조입니다. 봇을 가져오거나 내보낼 때 이 구조를 사용하세요.
# Alexa Skill로 내보내기
Alexa Skill과 호환 가능한 형식으로 봇 스키마를 내보낼 수 있습니다. 봇을 JSON 파일로 내보낸 후 스킬 빌더를 사용하여 Alexa로 봇을 업로드합니다.
**봇과 해당 스키마를 내보내려면(상호 작용 모델)**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) Amazon Lex 콘솔을 엽니다.
1. 내보내려는 봇을 선택합니다.
1. **작업**에서 **내보내기**를 선택합니다.
1. 내보내려는 봇의 버전을 선택합니다. 형식으로 **Alexa Skills Kit**를 선택한 다음 **내보내기**를 선택합니다.
1. 다운로드 대화 상자가 나타나면 파일을 저장할 위치를 선택한 후 **저장**을 선택합니다.
다운로드한 파일은 내보낸 봇의 이름을 사용하는 파일 하나가 포함된 .zip 아카이브입니다. 여기에는 봇을 Alexa skill로 가져오는 데 필요한 정보가 들어 있습니다.
**참고**
Amazon Lex와 Alexa Skills Kit는 다음과 같은 부분에서 서로 다릅니다.
대괄호([])로 표시되는 세션 속성은 Alexa Skills Kit에서 지원하지 않습니다. 세션 속성을 사용하는 프롬프트를 업데이트해야 합니다.
구두점은 Alexa Skills Kit에서 지원되지 않습니다. 구두점을 사용하는 utterance를 업데이트해야 합니다.
**봇을 Alexa Skill에 업로드하려면**
1. 개발자 포털 [https://developer.amazon.com/](https://developer.amazon.com/edw/home.html#/)에 로그인합니다.
1. **Alexa Skills** 페이지에서 **스킬 생성**을 선택합니다.
1. **새 스킬 생성** 페이지에서 스킬 이름과 스킬의 기본 언어를 입력합니다. 스킬 모델로 **사용자 지정**이 선택되었는지 확인한 후 **스킬 생성**을 선택합니다.
1. **새로 시작**을 선택했는지 확인한 후 **선택**을 선택합니다.
1. 왼쪽 메뉴에서 **JSON 편집기**를 선택합니다. 내보내려는 JSON 파일을 Amazon Lex에서 JSON 편집기로 끌어 놓습니다.
1. **모델 저장**을 선택하여 상호 작용 모델을 저장합니다.
스키마를 Alexa Skill로 업로드한 후에는 Alexa를 사용해 스킬을 실행하는 데 필요한 사항을 변경하세요. Alexa 스킬 생성에 대한 자세한 내용은 *Alexa Skill Kit*의 [Skill 빌더 사용(베타)](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/ask-define-the-vui-with-gui)을 참조하십시오.