기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 설명을 사용하여 설명형 봇 빌더로 Lex V2에서 봇 빌드
**참고**
생성형 AI 기능을 활용하려면 먼저 다음 사전 조건을 충족해야 합니다.
Amazon Bedrock 사용 요금에 대한 자세한 내용은 [Amazon Bedrock 요금](https://aws.amazon.com/bedrock/pricing/)을 참조하세요.
봇 로캘에 맞는 생성형 AI 기능을 켭니다. 이렇게 하려면 [생성형 AI를 사용하여 Lex V2 봇 생성 및 성능 최적화](generative-features.md) 단원의 절차를 따르세요.
설명형 봇 빌더를 사용하면 대규모 언어 모델에 대한 Amazon Bedrock의 액세스를 활용하여 봇 생성 프로세스의 효율성을 개선할 수 있습니다. 봇의 목적과 수행해야 할 작업이 포함된 자연어를 사용하여 프롬프트를 제공합니다. Amazon Lex V2는 Amazon Bedrock의 기능을 활용하여 설명에 따라 봇에 적합한 의도와 슬롯 유형을 생성합니다. 유지하려는 의도와 슬롯 유형을 선택한 후에는 봇을 반복하여 특정 사용 사례에 맞게 수정할 수 있습니다. 설명형 봇 빌더를 사용하면 봇에 대한 의도와 슬롯 유형을 수동으로 만들지 않아도 되므로 시간을 절약할 수 있습니다.
설명형 봇 빌더는 영어 로캘에서 사용할 수 있습니다([Amazon Lex V2에서 지원하는 언어 및 로캘](how-languages.md)의 표에서 `en_`로 시작하는 로캘 참조).
봇을 생성하기 전에 다음을 수행합니다.
1. [Lex V2에서 자연어 설명이 포함된 봇을 만드는 데 필요한 권한](nld-permissions.md)의 단계를 검토하여 역할에 올바른 권한이 있는지 확인합니다.
1. 사용할 설명을 결정합니다. 봇 설명 예시는 [설명형 봇 빌더의 봇 설명 예시](nld-examples.md) 단원을 참조할 수 있습니다.
자연어를 사용하여 봇이 수행할 수 있어야 하는 작업을 설명하여 봇을 만듭니다. Amazon Lex V2는 Amazon Bedrock 모델을 간접적으로 호출하여 봇의 사용 사례에 맞는 의도와 슬롯 유형을 생성합니다. 콘솔 또는 API를 사용하여 봇을 만들 수 있습니다.
------
#### [ Console ]
**설명형 봇 빌더를 사용하여 봇 생성**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/lexv2/home](https://console.aws.amazon.com/lexv2/home) Amazon Lex V2 콘솔을 엽니다.
1. **봇** 페이지에서 **봇 생성**을 선택합니다.
1. **생성 방법**에서 **설명형 봇 빌더 - GenAI**를 선택합니다.
1. 봇의 이름과 설명(선택 사항)을 입력하고, IAM 권한을 구성하고, 봇에 COPPA가 적용될지 여부를 선택합니다. 그런 후 **다음**을 선택합니다.
1. 봇을 만들 언어, 봇의 음성, 의도 분류를 위한 신뢰도 임곗값을 선택합니다(자세한 내용은 [Lex V2에서 의도 신뢰도 점수를 사용하여 의도 선택 향상](using-intent-confidence-scores.md) 참조).
1. **설명형 봇 빌더 - GenAI**에서 만들려는 봇에 대한 설명을 입력합니다. 봇에 대한 적절하고 충분한 의도를 생성하는 데 도움이 되도록 **상세하고 **정확하게 설명해야 합니다. 의도 생성 프로세스를 개선하기 위해 작업 목록을 포함하세요.
1. **모델 선택**에서 모델 제공업체 및 모델을 선택합니다.
1. 다른 로캘로 봇을 만들려면 **다른 언어 추가**를 선택합니다. 언어 추가 작업을 마쳤으면 **완료**를 선택합니다. Amazon Lex V2가 봇을 만들고 설명형 봇 빌더가 봇에 대한 의도와 슬롯을 생성합니다. 로캘이 생성되면 배너가 파란색에서 녹색으로 바뀝니다. **검토**를 선택하여 생성된 의도 및 슬롯 유형을 확인합니다.
**참고**
설명형 봇 빌더는 현재 영어 로캘에서만 사용할 수 있습니다. 하지만 봇을 만든 후 영어 이외의 로캘로 복사할 수 있습니다
**생성된 의도와 슬롯 유형을 검토하여 봇에 추가**
1. 봇의 사용 사례에 적용할 수 있는 의도와 슬롯 유형이 충분하다면 생성된 의도를 검토할 수 있습니다.
1. **생성된 의도**를 검토합니다.
1. 봇에 추가할 의도 목록에서 의도 옆의 확인란을 선택하여 의도 목록에서 제거합니다.
1. 의도 이름을 선택하면 해당 의도에 대해 생성된 **샘플 표현** 및 **슬롯**을 볼 수 있습니다.
1. 기본적으로 모든 표현 및 슬롯이 선택되어 있습니다. 확인란을 선택하여 해당 항목을 의도에서 제거합니다. **선택 항목에 추가**를 선택하여 선택한 항목을 의도에 유지합니다.
1. **생성된 슬롯 유형**을 검토합니다.
1. 슬롯 유형 옆의 확인란을 선택하여 봇에 추가할 의도 목록에서 해당 슬롯 유형을 제거합니다.
1. 슬롯 유형을 봇에 추가한 후에 슬롯 유형에 값을 추가할 수 있습니다.
1. 의도 및 슬롯 유형에 만족하면 페이지 상단의 **의도 및 슬롯 유형 추가**를 선택하여 봇에 의도 및 슬롯 유형을 추가합니다.
1. 리소스 추가가 완료되면 녹색 성공 배너가 나타납니다. **의도** 및 **슬롯** 유형으로 이동하여 생성된 것을 편집하고 값을 더 추가합니다.
1. **생성된 의도** 및 **생성된 슬롯 유형**이 만들려는 봇에 대부분 적용되지 않는 경우 다음 단계를 수행합니다.
1. **설명형 봇 빌더 세부 정보** 섹션에서 **새 생성**을 선택합니다.
1. 프롬프트를 다시 작성하고 **다시 생성**을 선택하여 새 의도 및 슬롯 유형을 생성합니다. 다른 모델을 사용하는 경우에는 결과가 달라집니다.
**중요**
동일한 의도 및 슬롯이 생성된다는 보장은 없습니다. 의도 및 슬롯 유형을 다시 생성할 때마다 요금이 부과됩니다.
------
#### [ API ]
**자연어 설명을 사용하여 봇 생성**
API를 통해 설명형 봇 빌더를 사용하면 Amazon S3 버킷에 .zip 파일로 봇 정의가 생성됩니다. 이 파일을 다운로드하고 봇 정의를 Amazon Lex V2로 가져와서 봇을 만듭니다.
1. [CreateBot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBot.html) 요청을 보내 새 봇을 만듭니다. 그런 다음 [CreateBotLocale](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotLocale.html) 요청을 보내 봇의 로캘을 만듭니다.
1. 봇의 ID, 버전 및 로캘을 지정하여 [StartBotResourceGeneration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_StartBotResourceGeneration.html) 요청을 보냅니다. 봇 버전으로 `DRAFT`를 사용할 수 있습니다. `generationInputPrompt` 필드에 프롬프트를 입력합니다. 봇에 대한 적절하고 충분한 의도를 생성하는 데 도움이 되도록 **상세하고 **정확하게 설명해야 합니다. 의도 생성 프로세스를 개선하기 위해 작업 목록을 포함하세요.
1. 응답의 `generationId`를 기록해 둡니다.
1. `StartBotResourceGeneration` 응답에서 받은 `generationId`를 사용하여 [DescribeBotResourceGeneration](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeBotResourceGeneration.html) 요청을 보냅니다. 봇 ID, 버전, 로캘을 포함하세요.
1. `DescribeBotResourceGeneration` 응답의 `generationStatus`가 `Complete`인 경우 `generatedBotLocaleUrl` 필드도 채워집니다. 이 Amazon S3 URI를 사용하여 [객체 다운로드](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html)의 단계에 따라 봇 정의를 다운로드합니다.
**생성된 봇 정의를 확인하고 가져오기**
1. `DescribeBotResourceGeneration` 응답의 `generationStatus`에 있는 Amazon S3 URI를 사용하여 [객체 다운로드](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html)의 단계에 따라 봇 정의를 다운로드합니다.
1. 파일을 편집하여 봇의 특정 사용 사례에 맞게 생성된 콘텐츠를 직접 수정할 수 있습니다. 다른 `StartBotResourceGeneration` 요청을 전송하여 의도 및 슬롯을 다시 생성할 수도 있습니다.
**중요**
동일한 의도 및 슬롯이 생성된다는 보장은 없습니다. 의도 및 슬롯 유형을 다시 생성할 때마다 요금이 부과됩니다.
1. 봇 정의를 가져오려면 [Lex V2에서 봇 가져오기](import.md)의 단계를 따르세요.
1. 가져온 후에는 [UpdateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html), [UpdateSlot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateSlot.html) 및 [UpdateSlotType](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateSlotType.html) 작업을 사용하여 생성된 의도 및 슬롯을 수정할 수 있습니다.
봇 로캘에 대해 생성된 모든 항목에 대한 메타데이터를 나열하려면 [ListBotResourceGenerations](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListBotResourceGenerations.html) 작업을 사용합니다. 생성된 봇 정의에 대한 Amazon S3 URI를 검색하려면 `DescribeBotResourcGeneration` 요청에서 반환된 `generationId` 값 중 하나를 사용합니다.
------
**Topics**
+ [설명형 봇 빌더의 봇 설명 예시](nld-examples.md)
+ [Lex V2에서 자연어 설명이 포함된 봇을 만드는 데 필요한 권한](nld-permissions.md)
# 설명형 봇 빌더의 봇 설명 예시
다음은 Amazon Lex V2의 설명형 봇 빌더와 함께 사용할 수 있는 몇 가지 유용한 봇 설명 예시입니다.
| Industry | 프롬프트 예제 |
| --- | --- |
| 금융 서비스 | 저희는 사용자가 새 카드를 받았을 때 카드 활성화, 핀 이메일 또는 우편 발송, 새 카드 인증(우편번호 사용) 등의 작업을 수행하는 데 도움을 주는 금융 카드 서비스입니다. 또한 신용카드 혜택 조회, 카드 분실 신고, 새 카드 신청, 카드 핀 재설정, 카드 청구서 납부 등 기존 카드와 관련된 작업도 도와드립니다. |
| 음식 서비스 | 봇이 고객이 음식 주문(품목 ID, 수량, 크기 사용), 주문 상태 확인, 주문 취소를 할 수 있도록 도와주기를 원합니다. 주문을 인덱싱하려면 주문 ID를 사용합니다. |
| 항공사 | 사용자가 항공권을 예약하고, 예약 세부 정보를 확인하고, 예약한 항공편의 영수증을 받고, 항공편 상태를 조회하고, 예약한 항공편의 일정을 변경하고, 항공편 세부 정보를 유도하고, 예약한 항공편을 취소할 수 있도록 도와주는 항공사 도메인입니다. 도메인 설명에 있는 기능을 지원하는 데 도움이 되는 경우 추가 의도를 생성할 수도 있습니다. |
| 보험 | 목표: 저희는 자동차, 주택, 연금 보험을 판매하는 보험 회사입니다. 보험금 청구 상태를 확인하고, 보험금을 청구하고, 보험금을 지급하고, 보험을 취소할 수 있는 봇을 만들고 싶습니다. 계정 식별 및 유효성 검사를 위해 policy\$1id와 SSN의 마지막 4개를 사용하며, 봇에 최소한 다음과 같은 의도와 슬롯이 있어야 합니다. 인증 - policy\$1id, last4SSN보험 유형: 자동차, 주택, 연금보험 상태: 잔액 확인, 만기일 확인, 보장 범위 확인보험료 납부: 일시불, 할부, 액수 |
| 차량 관리 | 저희는 차량이 견인된 도시의 운전자가 차량의 위치를 찾을 수 있도록 도와주는 견인된 차량 조회 봇을 구축하고 있습니다. 이 봇은 차량이 견인된 곳의 주소 또는 위치, 차량 번호판과 제조사, 모델, 연식 등 차량에 대한 세부 정보를 요청해야 합니다. 봇은 견인된 차량의 주차장 위치와 운영 시간을 회신해야 합니다. |
| 여행 | 저는 여행사 직원이고 고객이 디즈니 여행을 예약할 수 있도록 봇이 도와주기를 원합니다. Disney는 전 세계에 여러 개의 공원을 보유하고 있으며, 호텔, 식당, 특별 엔터테인먼트도 예약할 수 있습니다. 봇 사용자는 예약을 수정하거나 취소할 수 있어야 합니다. 예약에는 최소한 공원, 날짜, 호텔이 포함되어야 합니다. 식사 또는 엔터테인먼트 포함 여부는 선택 사항이며 나중에 추가하거나 변경할 수 있습니다. |
# Lex V2에서 자연어 설명이 포함된 봇을 만드는 데 필요한 권한
+ Amazon Lex V2 콘솔에서 이 기능에 액세스하려면 콘솔 역할에 `bedrock:ListFoundationModels` 및 `bedrock:ListInferenceProfiles` 권한이 있는지 확인하세요.
+ 봇과 연결된 IAM 역할에 `bedrock:InvokeModel` 권한이 있어야 합니다. Amazon Lex 콘솔에서 이 기능을 활성화하면 봇이 Amazon Lex에서 생성한 서비스 연결 역할을 사용하는 경우 정책이 봇 역할에 자동으로 추가됩니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel"
],
"Resource": [
"arn:aws:bedrock:us-east-1::foundation-model/model-id"
]
}
]
}
```
------