Tutorial: criar um fluxo que processe pedidos de hipoteca

1. Faça o download do cloudformation-mortgage-flow-setuparquivo.zip.

2. Descompacte o arquivo. Você pode saber mais sobre o conteúdo em CloudFormation modelos.

3. Solicite acesso aos modelos de base do Amazon Bedrock fazendo o seguinte:

   1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em https://console.aws.amazon.com/bedrock.

   2. Verifique no canto superior direito se você está na região Leste dos EUA (Norte da Virgínia). Se não estiver, mude de região.

   3. Selecione Acesso ao modelo na parte inferior do painel de navegação à esquerda.

   4. Escolha Modificar acesso ao modelo.

   5. Execute um destes procedimentos:

      • Para solicitar acesso a todos os modelos, escolha Habilitar todos os modelos. Na página para a qual você é direcionado, as caixas de seleção ao lado de todos os modelos estarão preenchidas.

      • Para solicitar acesso a modelos específicos, escolha Habilitar modelos específicos. Na página que é aberta, você tem as seguintes opções:

        • Para solicitar acesso a todos os modelos por um provedor, marque a caixa de seleção ao lado do nome do provedor.

        • Para solicitar acesso a um modelo, marque a caixa de seleção ao lado do nome do modelo.

   6. Para os tutoriais a seguir, você deve solicitar no mínimo o acesso aos modelos Titan Embeddings G1 - Text e Claude 3 Haiku. Escolha Próximo.

   7. Analise os modelos aos quais você está solicitando acesso e os Termos. Quando tudo estiver pronto, escolha Enviar para solicitar acesso.

1. Em um terminal, execute o comando a seguir para copiar os recursos em um bucket do Amazon S3 e preencher os arquivos main-stack.yaml e main-stack.json com o nome do bucket do S3 como valor padrão para o parâmetro do nome do bucket.

   bash deploy.sh

   nota

   O uso do script ébash deploy.sh <region> <bucket-name>, onde <region> e <bucket-name> são argumentos opcionais. Se você não os fornecer, os seguintes valores padrão serão usados:

   • <region>— A AWS região padrão especificada na configuração de suas AWS credenciais.

   • <bucket-name>— O bucket será nomeadomortgage-flow-deployment-<AccountId>-<Region>, onde <AccountId> está o ID AWS da sua conta e <Region> corresponde ao valor fornecido ou à AWS região padrão especificada na configuração de suas AWS credenciais.

2. Confirme os prompts. Depois que você concluir a implantação, deverá ter um modelo main-stack.yaml e main-stack.json completos para a próxima etapa.

1. Abra o CloudFormation console em https://console.aws.amazon.com/cloudformation. Verifique no canto superior direito se você está na região Leste dos EUA (Norte da Virgínia). Se não estiver, mude de região.

2. Na página Pilhas, no menu Criar pilha, escolha com novos recursos (padrão).

3. Especifique o modelo:

   1. Em Pré-requisito, escolha Escolher um modelo existente.

   2. Em Especificar modelo, escolha Fazer upload de um arquivo de modelo.

   3. Selecione Escolher arquivo, navegue até main-stack.yaml ou o modelo main-stack.json e selecione-o.

   4. Escolha Próximo.

4. Especifique os detalhes da pilha:

   1. No campo Nome da pilha, insira um nome para a pilha.

   2. No campo Parâmetros, mantenha os valores padrão.

      nota

      O valor Q01pS3BucketName deve corresponder ao nome do bucket do S3 no qual você fez upload dos recursos para esse modelo. Os argumentos restantes estão relacionados às configurações da base de conhecimento. Se você modificar qualquer um deles, verifique se as configurações são compatíveis umas com as outras. Para obter mais informações, consulte Pré-requisitos para usar o armazenamento de vetores que você criou para uma base de conhecimento.

   3. Escolha Próximo.

5. Configurar as opções da pilha:

   1. Em Opções de falha de pilha, escolha Excluir todos os recursos recém-criados.

      nota

      A escolha dessa opção evita que você seja cobrado por recursos cuja política de exclusão especifica que eles sejam retidos mesmo que a criação da pilha falhe. Para ter mais informações, consulte Atributo DeletionPolicy no Guia do usuário do CloudFormation .

   2. Em Capacidades, marque a caixa para reconhecer que isso CloudFormation pode criar recursos do IAM em sua conta.

   3. Escolha Próximo.

6. Revise os detalhes da pilha e escolha Enviar. CloudFormation cria a pilha. A criação levará alguns minutos. Ao concluir a criação da pilha, você pode usar a guia Recursos na página de detalhes da pilha para visualizar os recursos que foram provisionados em sua conta.

7. Assim que a criação da pilha for concluída, faça o seguinte para sincronizar a fonte de dados da base de conhecimento para que a base de conhecimento possa ser consultada:

   1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em https://console.aws.amazon.com/bedrock.

   2. No painel de navegação à esquerda, escolha Bases de conhecimento e selecione a base de conhecimento que você criou, chamada AWSDocsTutorial-MortgageKB.

   3. Na seção Fonte de dados, selecione a caixa de seleção ao lado da fonte de dados que foi criada, chamada AWSDocsTutorial-MortgageKB-DS.

   4. Escolha Sincronizar. Assim que a sincronização for concluída, você poderá testar o fluxo.

Como testar o fluxo

1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console Amazon Bedrock em https://console.aws.amazon.com/bedrock.

2. No painel de navegação à esquerda, escolha Fluxos. Verifique no canto superior direito se você está na região Leste dos EUA (Norte da Virgínia). Se não estiver, mude de região.

3. Na seção Fluxos, selecione o fluxo que foi criado a partir do CloudFormation modelo. Deveria ser AWSDocsTutorial-MortgageFlow.

4. Escolha Editar no construtor de fluxo. Você pode arrastar nós individuais no fluxo para modificar a representação visual do fluxo.

5. No painel Testar fluxo, insira o seguinte no campo de texto e selecione Executar:

   {
       "income": 80000, 
       "totalDebt": 5000, 
       "loanTerm": 30, 
       "loanAmount": 600000, 
       "creditScore": 750, 
       "mlsId": "MLS-5678"
   }

   Como o valor do empréstimo é maior do que o empréstimo máximo viável calculado, o prompt incomeDebt é acionado e o fluxo gera uma carta de rejeição. Você pode escolher Mostrar rastreamento para ver os nós que foram executados no fluxo.

6. Novamente, no painel Testar fluxo, insira o seguinte no campo de texto e selecione Executar:

   {
       "income": 120000, 
       "totalDebt": 5000, 
       "loanTerm": 30, 
       "loanAmount": 200000, 
       "creditScore": 650, 
       "mlsId": "MLS-3456"
   }

   Como o valor do empréstimo é menor do que o empréstimo acessível máximo calculado, o prompt ProcessApplication é acionado e enviado para o mortgageProcessingAgent, que consulta a base de conhecimento anexa e gera uma resposta que avalia, com base nos valores de entrada, se o cliente se qualifica para um empréstimo.

7. (Opcional) Tente executar o fluxo usando valores diferentes para os campos no objeto JSON. Os valores de mlsId correspondem às propriedades listadas no Multiple Listing Service. Você pode encontrar valores mlsId válidos fazendo o seguinte:

   1. Faça login no Console de gerenciamento da AWS e abra o console do DynamoDB em. https://console.aws.amazon.com/dynamodb/

   2. No painel de navegação à esquerda, selecione Tabelas.

   3. Selecione a tabela que diz AWSDocsTutorial-PropertyListing.

   4. Escolha Explore table items (Explorar itens da tabela).

   5. Você pode usar qualquer um dos valores na coluna mls_id na entrada do fluxo.

1. Abra o https://console.aws.amazon.com/cloudformation.

2. No painel de navegação à esquerda, escolha Pilhas.

3. Escolha a pilha que você criou com base no modelo. Escolha Excluir e, para confirmar, selecione Excluir.

   CloudFormation inicia a exclusão da pilha principal, de todas as pilhas aninhadas e de todos os recursos incluídos nas pilhas.