기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 자습서: 모기지 애플리케이션을 처리하는 흐름 생성 Amazon Bedrock 리소스와 그 기능에 익숙해지기 위해 CloudFormation 템플릿을 사용하여 다양한 Amazon Bedrock과 기타 AWS 리소스를 결합하여 모기지 애플리케이션 프로세스 프로세스를 자동화하는 [흐름을](flows.md) 설정합니다. **참고** 이 자습서에서는 {{us-east-1}} 리전을 사용합니다. 에이전트, 흐름, 가드레일, 지식 기반 및 프롬프트 관리를 지원하는 리전이면 무엇이든 사용할 수 있습니다. 리전별 기능 지원 테이블은 [Amazon Bedrock AWS 리전 에서의 기능 지원](features-regions.md) 섹션을 참조하세요. 사용 중인 리전에서 Amazon S3, Amazon Bedrock, Lambda 및 DynamoDB 리소스를 생성할 수 있는 권한이 본인에게 있는지 확인합니다. 이 흐름은 배포용이 아니라 Amazon Bedrock 리소스를 이해하기 위한 자습서용입니다. 다음 이미지는 AWS Management Console의 흐름을 시각적으로 표현한 것입니다. ![모기지 처리 흐름.](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/images/cloudformation/mortgage-processing-flow.png) 이 흐름은 Amazon Bedrock [에이전트](agents.md), [프롬프트](prompt-management.md) 및 [Lambda 함수](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)를 결합하여 고객 재무 정보를 수집하고 고객이 대출을 받을 자격이 있는지 여부를 처리하는 모기지 처리 흐름을 생성합니다. Amazon Bedrock [지식 기반](knowledge-base.md)과 [가드레일](guardrails.md)도 흐름의 에이전트에 연결되어 응답을 강화하고 보호 기능을 제공합니다. 흐름의 구성 요소에 대한 자세한 내용은 [모기지 처리 흐름에 대한 세부 정보](getting-started-mortgage-flow-details.md) 섹션을 참조하세요. **Topics** + [사전 조건](#getting-started-mortgage-flow-prereqs) + [를 사용하여 모기지 처리 흐름 생성 CloudFormation](#getting-started-mortgage-flow-create) + [모기지 처리 흐름 테스트](#getting-started-mortgage-flow-test) + [정리: 리소스 삭제](#getting-started-mortgage-flow-delete) + [CloudFormation 템플릿](getting-started-mortgage-flow-template.md) + [모기지 처리 흐름에 대한 세부 정보](getting-started-mortgage-flow-details.md) ## 사전 조건 이 흐름을 생성하려면 .zip 파일을 다운로드하고 지침에 따라 리소스와 템플릿을 설정하는 스크립트를 실행합니다. **중요** 생성한 Amazon 리소스는 삭제될 때까지 요금이 청구됩니다. 다음 사전 조건을 완료합니다. 1. [cloudformation-mortgage-flow-setup.zip](samples/cloudformation-mortgage-flow-setup.zip) 파일을 다운로드합니다. 1. 파일 압축을 풉니다. 콘텐츠에 대한 자세한 내용은 [CloudFormation 템플릿](getting-started-mortgage-flow-template.md)에서 확인할 수 있습니다. 1. 다음을 수행하여 Amazon Bedrock 파운데이션 모델에 대한 액세스를 요청합니다. 1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명 AWS Management Console 으로에 로그인합니다. 그 다음 Amazon Bedrock 콘솔([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock))을 엽니다. 1. 오른쪽 상단 모서리에서 리전을 확인하여 **미국 동부(버지니아 북부)** 리전에 있는지 확인합니다. 그렇지 않은 경우 리전을 전환합니다. 1. 왼쪽 탐색 창 하단에서 **모델 액세스**를 선택합니다. 1. **모델 액세스 수정**을 선택합니다. 1. 다음 중 하나를 수행하세요. + 모든 모델에 대한 액세스를 요청하려면 **모든 모델 활성화**를 선택합니다. 다음으로 나타나는 페이지에서 모든 모델 옆의 확인란이 채워집니다. + 특정 모델에 대한 액세스를 요청하려면 **특정 모델 활성화**를 선택합니다. 다음으로 나타나는 페이지에서 다음과 같은 옵션을 찾을 수 있습니다. + 제공업체의 모든 모델에 대한 액세스를 요청하려면 해당 제공업체 이름 옆의 확인란을 선택합니다. + 한 모델에 대한 액세스를 요청하려면 해당 모델 이름 옆의 확인란을 선택합니다. 1. 다음 자습서의 목적상 최소한 **Titan Embeddings G1 - Text** 및 **Claude Haiku 4.5** 모델에 대한 액세스를 요청해야 합니다. 그리고 **다음**을 선택합니다. 1. 액세스를 요청하려는 모델과 **약관**을 검토합니다. 준비가 되면 **제출**을 선택하여 액세스를 요청합니다. ## 를 사용하여 모기지 처리 흐름 생성 CloudFormation 모기지 처리 흐름과 관련 리소스를 생성하기 위해 CloudFormation 템플릿을 생성하고 이를 사용하여 Amazon Bedrock 리소스가 포함된 스택을 생성합니다. **중요** 생성한 Amazon 리소스는 삭제될 때까지 요금이 청구됩니다. ### 리소스 및 CloudFormation 템플릿 파일 생성 먼저 .zip 파일의 스크립트를 사용하여 리소스를 S3 버킷에 업로드하고 CloudFormation 템플릿을 생성합니다. 1. 터미널에서 다음 명령을 실행하여 리소스를 Amazon S3 버킷에 복사하고 `main-stack.yaml` 및 `main-stack.json` 파일을 버킷 이름 파라미터의 기본값인 S3 버킷 이름으로 채웁니다. ``` bash deploy.sh ``` **참고** 스크립트 사용 형식은 `bash deploy.sh {{}} {{}}`이며, 여기서 {{}} 및 {{}}은 선택적 인수입니다. 값을 제공하지 않으면 다음 기본값이 사용됩니다. {{}} - AWS 자격 증명 설정에 지정된 기본 AWS 리전입니다. {{}} - 버킷의 이름은 {{mortgage-flow-deployment--}}입니다. 여기서 {{}}는 AWS 계정 ID이고 {{}}은 사용자가 제공한 값 또는 AWS 자격 증명 설정에 지정된 기본 AWS 리전과 일치합니다. 1. 프롬프트를 확인합니다. 배포가 완료되면 다음 단계를 위한 완전한 `main-stack.yaml` 및 `main-stack.json` 템플릿이 있어야 합니다. **참고** 스크립트가 실패하면 다음을 수행하여 리소스를 수동으로 준비할 수 있습니다. Amazon S3 콘솔([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/))에서 압축 해제된 `cloudformation-mortgage-flow-setup` 폴더의 *콘텐츠*(폴더 자체는 포함하지 않음)를 미국 동부(버지니아 북부)에 있는 S3 버킷에 업로드합니다. `templates/json/main-stack-tmp.yaml` 또는 `templates/json/main-stack-tmp.json` 파일을 찾아 다음을 수행합니다. `Q01pS3BucketName` 파라미터의 `Default` 값을 {{MortgageFlowBucket}}에서 S3 버킷 이름으로 변경합니다. 파일 이름에서 `-tmp`를 제거하여 `templates/json/main-stack.yaml` 또는 `templates/json/main-stack.json`이 되도록 합니다. ### CloudFormation 콘솔을 사용하여 스택 생성 다음으로, 저장한 템플릿을 사용하여 CloudFormation 스택을 프로비저닝합니다. 1. [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/) CloudFormation 콘솔을 엽니다. 오른쪽 상단 모서리에서 리전을 확인하여 **미국 동부(버지니아 북부)** 리전에 있는지 확인합니다. 그렇지 않은 경우 리전을 전환합니다. 1. **스택** 페이지의 **스택 생성** 메뉴에서 **새 리소스 사용(표준)**을 선택합니다. 1. 템플릿을 지정합니다. 1. **사전 조건**에서 **기존 템플릿 선택**을 선택합니다. 1. **템플릿 지정**에서 **템플릿 파일 업로드**를 선택합니다. 1. **파일 선택**을 선택하고 `main-stack.yaml` 또는 `main-stack.json` 템플릿으로 이동한 후 해당 템플릿을 선택합니다. 1. **다음**을 선택합니다. 1. 스택 세부 정보를 다음과 같이 지정합니다. 1. **스택 이름** 필드에 스택의 이름을 입력합니다. 1. **파라미터** 필드에서 기본값을 그대로 둡니다. **참고** `Q01pS3BucketName` 값은 이 템플릿의 리소스를 업로드해 놓은 S3 버킷의 이름과 일치해야 합니다. 나머지 인수는 지식 기반 구성과 관련이 있습니다. 이 인수를 수정하는 경우 구성이 서로 호환되는지 확인하세요. 자세한 내용은 [지식 기반에 대해 생성된 벡터 저장소 사용의 사전 조건](knowledge-base-setup.md) 단원을 참조하십시오. 1. **다음**을 선택합니다. 1. 스택 옵션을 구성합니다. 1. **스택 실패 옵션**에서 **새로 생성된 모든 리소스 삭제**를 선택합니다. **참고** 이 옵션을 선택하면 스택 생성에 실패하더라도 삭제 정책에서 보존하도록 지정한 리소스에 대해서는 요금이 청구되지 않습니다. 자세한 내용은 *CloudFormation 사용자 안내서*의 [`DeletionPolicy` 속성](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html)을 참조하세요. 1. **기능**에서 CloudFormation이 계정에 IAM 리소스를 생성할 수 있음을 승인하는 확인란을 선택합니다. 1. **다음**을 선택합니다. 1. 스택 세부 정보를 검토하고 **Submit**. CloudFormation creates the stack을 선택합니다. 생성하는 데 몇 분 정도 걸립니다. 스택 생성이 완료되면 스택 세부 정보 페이지의 **리소스** 탭을 사용하여 계정에 프로비저닝된 리소스를 볼 수 있습니다. 1. 스택 생성이 완료되면 다음을 수행하여 지식 기반을 쿼리할 수 있도록 지식 기반의 데이터 소스를 동기화합니다. 1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명 AWS Management Console 으로에 로그인합니다. 그 다음 Amazon Bedrock 콘솔([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock))을 엽니다. 1. 왼쪽 탐색 창에서 **지식 기반**을 선택한 다음, `AWSDocsTutorial-MortgageKB`라는 이름으로 생성된 지식 기반을 선택합니다. 1. **데이터 소스** 섹션에서 `AWSDocsTutorial-MortgageKB-DS`라는 이름으로 생성된 데이터 소스 옆의 확인란을 선택합니다. 1. **동기화**를 선택합니다. 동기화가 완료되면 흐름을 테스트할 수 있습니다. ## 모기지 처리 흐름 테스트 모기지 처리 흐름이 생성되면 Amazon Bedrock 콘솔을 사용하여 흐름을 검사, 테스트 및 수정할 수 있습니다. 흐름의 개별 리소스를 검사, 테스트 및 수정할 수도 있습니다. **흐름을 테스트하는 방법** 1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명 AWS Management Console 으로에 로그인합니다. 그 다음 Amazon Bedrock 콘솔([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock))을 엽니다. 1. 왼쪽 탐색 창에서 **흐름**을 선택합니다. 오른쪽 상단 모서리에서 리전을 확인하여 **미국 동부(버지니아 북부)** 리전에 있는지 확인합니다. 그렇지 않은 경우 리전을 전환합니다. 1. **흐름** 섹션에서 CloudFormation 템플릿에서 생성된 흐름을 선택합니다. 선택한 흐름은 `AWSDocsTutorial-MortgageFlow`일 것입니다. 1. **흐름 빌더에서 편집**을 선택합니다. 흐름의 개별 노드를 끌어 흐름의 시각적 표현을 수정할 수 있습니다. 1. **테스트 흐름** 창의 텍스트 필드에 다음을 입력한 다음 **실행**을 선택합니다. ``` { "income": 80000, "totalDebt": 5000, "loanTerm": 30, "loanAmount": 600000, "creditScore": 750, "mlsId": "MLS-5678" } ``` 계산된 최대 적정 대출 금액보다 대출 금액이 많으므로 **incomeDebt** 프롬프트가 트리거되고 흐름이 거부서를 생성합니다. **추적 표시**를 선택하면 흐름에서 실행된 노드를 볼 수 있습니다. 1. 다시 **흐름 테스트** 창의 텍스트 필드에 다음을 입력한 후 **실행**을 선택합니다. ``` { "income": 120000, "totalDebt": 5000, "loanTerm": 30, "loanAmount": 200000, "creditScore": 650, "mlsId": "MLS-3456" } ``` 계산된 최대 저렴한 대출 금액보다 대출 금액이 적으므로 **processApplication** 프롬프트가 트리거되어 **mortgageProcessingAgent**로 전송됩니다. 이 프롬프트는 연결된 지식 기반을 조회하고 입력 값에 따라 고객이 대출을 받을 자격이 있는지 여부를 평가하는 응답을 생성합니다. 1. (선택 사항) JSON 객체의 필드에 다른 값을 사용하여 흐름을 실행해 보세요. `mlsId` 값은 다중 나열 서비스에 나열된 속성에 해당합니다. 다음을 수행하여 유효한 `mlsId` 값을 찾을 수 있습니다. 1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/) DynamoDB 콘솔을 엽니다. 1. 왼쪽 탐색 창에서 **테이블**을 선택합니다. 1. **AWSDocsTutorial-PropertyListing**이라는 테이블을 선택합니다. 1. **테이블 항목 탐색**을 선택합니다. 1. 흐름 입력의 **mls\_id** 열에 있는 값 중 하나를 사용할 수 있습니다. 또한의 **에이전트**, **지식 기반**, **가드레일** 및 **프롬프트 관리** 페이지로 이동하여 흐름에 사용되는 각 Amazon Bedrock 리소스를 독립적으로 검사 AWS Management Console 할 수 있습니다. 흐름에 대해 자세히 알아보고 구성 요소를 자세히 이해하려면 [모기지 처리 흐름에 대한 세부 정보](getting-started-mortgage-flow-details.md) 섹션을 참조하세요. ## 정리: 리소스 삭제 리소스를 탐색하고 다양한 Amazon Bedrock 리소스의 기능을 더 정확히 이해한 후에는 스택과 스택에 포함된 리소스를 삭제합니다. **중요** 생성한 Amazon 리소스는 삭제될 때까지 요금이 청구됩니다. 1. [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)을 엽니다. 1. 왼쪽 탐색 창에서 **스택**을 선택합니다. 1. 템플릿에서 생성한 스택을 선택합니다. **삭제**를 선택한 다음 **삭제**를 확인합니다. CloudFormation은 기본 스택, 모든 중첩 스택 및 스택에 포함된 모든 리소스의 삭제를 시작합니다.