Tutorial: Crie um fluxo que processe pedidos de hipoteca

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

2. Descompacte o arquivo. Você pode aprender mais sobre o conteúdo emCloudFormation modelos.

3. Solicite acesso aos modelos da Amazon Bedrock Foundation fazendo o seguinte:

   1. Faça login no AWS Management Console 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 se você está na região Leste dos EUA (Norte da Virgínia) verificando sua região no canto superior direito. Se não estiver, troque 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 fins do tutorial a seguir, você deve solicitar minimamente o acesso aos Claude 3 Haikumodelos Titan Embeddings G1 - Texte. 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 main-stack.json arquivos main-stack.yaml e 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 as instruções. Depois que a implantação for concluída, você deverá ter um main-stack.json modelo completo main-stack.yaml para a próxima etapa.

1. Abra o AWS CloudFormation console em https://console.aws.amazon.com/cloudformation. Verifique se você está na região Leste dos EUA (Norte da Virgínia) verificando sua região no canto superior direito. Se não estiver, troque 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. Escolha Escolher arquivo, navegue até o main-stack.yaml ou o main-stack.json modelo 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, deixe os valores padrão.

      nota

      O Q01pS3BucketName valor deve corresponder ao nome do bucket do S3 para o qual você fez o upload dos recursos desse modelo. Os argumentos restantes estão relacionados às configurações da base de conhecimento. Se você modificar qualquer um deles, certifique-se de que as configurações sejam compatíveis entre si. Para obter mais informações, consulte Pré-requisitos para usar um repositório 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 obter mais informações, consulte o DeletionPolicyatributo no Guia AWS CloudFormation do usuário.

   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. AWS CloudFormation cria a pilha. A criação levará alguns minutos. Depois que a criação da pilha for concluída, você poderá usar a guia Recursos na página de detalhes da pilha para visualizar os recursos que foram provisionados em sua conta.

7. Depois 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 AWS Management Console 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 esquerdo, escolha Bases de conhecimento e, em seguida, selecione a base de conhecimento que foi criada, chamadaAWSDocsTutorial-MortgageKB.

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

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

Para testar o fluxo

1. Faça login no AWS Management Console 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 esquerdo, escolha Fluxos. Verifique se você está na região Leste dos EUA (Norte da Virgínia) verificando sua região no canto superior direito. Se não estiver, troque 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 criador 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 acessível máximo 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, digite 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 mlsId valores correspondem às propriedades listadas no Multiple Listing Service. Você pode encontrar mlsId valores válidos fazendo o seguinte:

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

   2. No painel de navegação esquerdo, 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 Stacks.

3. Escolha a pilha que você criou a partir do modelo. Em seguida, escolha Excluir e confirme Excluir.

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