As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Tutorial: criar um fluxo que processe pedidos de hipoteca
Para nos familiarizarmos com os recursos do Amazon Bedrock e suas capacidades, usaremos um CloudFormation modelo para configurar um [fluxo](flows.md) que automatiza os processos do processo de solicitação de hipoteca combinando vários recursos do Amazon Bedrock e outros. AWS
**nota**
Para este tutorial, usaremos a {{us-east-1}} Região. Você pode usar qualquer região que permita o uso de agentes, fluxos, barreiras de proteção, bases de conhecimento e gerenciamento de prompts. Para ver uma tabela recursos compatíveis por região, consulte [Suporte de recursos por Região da AWS na Amazon Bedrock](features-regions.md). Você deve ter permissões para criar recursos do Amazon S3, Amazon Bedrock, Lambda e DynamoDB na região que você usa.
Esse fluxo não se destina a implantações. Ele deve ser usado como um tutorial para entender os recursos do Amazon Bedrock. A seguinte imagem é uma representação visual do fluxo no Console de gerenciamento da AWS:
O fluxo combina um [agente](agents.md) do Amazon Bedrock, [prompts](prompt-management.md) e uma [função do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) para criar um fluxo de processamento de hipotecas que coleta informações financeiras do cliente e examina se o cliente se qualifica para um empréstimo. Uma [base de conhecimento](knowledge-base.md) e uma [barreira de proteção](guardrails.md) do Amazon Bedrock também estão conectadas ao agente do fluxo para aumentar as respostas e oferecer proteções. Para ter mais informações sobre os componentes do fluxo, consulte [Detalhes sobre o fluxo de processamento de hipotecas](getting-started-mortgage-flow-details.md).
**Topics**
+ [Pré-requisitos](#getting-started-mortgage-flow-prereqs)
+ [Crie o fluxo de processamento de hipotecas usando CloudFormation](#getting-started-mortgage-flow-create)
+ [Testar o fluxo de processamento de hipotecas](#getting-started-mortgage-flow-test)
+ [Limpar: exclusão de recursos](#getting-started-mortgage-flow-delete)
+ [CloudFormation modelos](getting-started-mortgage-flow-template.md)
+ [Detalhes sobre o fluxo de processamento de hipotecas](getting-started-mortgage-flow-details.md)
## Pré-requisitos
Para criar esse fluxo, você baixará um arquivo .zip e seguirá as instruções para executar um script que configurará os recursos e o modelo para você.
**Importante**
Enquanto você não excluir os recursos da Amazon que você criar, você receberá cobranças por eles.
Em seguida, atenda aos seguintes pré-requisitos:
1. Baixe o arquivo [cloudformation-mortgage-flow-setup.zip](samples/cloudformation-mortgage-flow-setup.zip).
1. Descompacte o arquivo. Você pode saber mais sobre o conteúdo em [CloudFormation modelos](getting-started-mortgage-flow-template.md).
1. 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](https://console.aws.amazon.com/bedrock).
1. 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.
1. Selecione **Acesso ao modelo** na parte inferior do painel de navegação à esquerda.
1. Escolha **Modificar acesso ao modelo**.
1. 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.
1. Para os tutoriais a seguir, você deve solicitar no mínimo o acesso aos modelos **Titan Embeddings G1 - Text** e **Claude Haiku 4.5**. Escolha **Próximo**.
1. Analise os modelos aos quais você está solicitando acesso e os **Termos**. Quando tudo estiver pronto, escolha **Enviar** para solicitar acesso.
## Crie o fluxo de processamento de hipotecas usando CloudFormation
Para criar o fluxo de processamento de hipotecas e seus recursos associados, criaremos um CloudFormation modelo e o usaremos para criar uma pilha contendo recursos do Amazon Bedrock.
**Importante**
Enquanto você não excluir os recursos da Amazon que você criar, você receberá cobranças por eles.
### Crie os recursos e CloudFormation arquivo de modelo
Primeiro, use o script do arquivo.zip para carregar os recursos em um bucket do S3 e criar os CloudFormation modelos.
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 {{}} {{}}`, onde {{}} e {{}} são argumentos opcionais. Se você não os fornecer, os seguintes valores padrão serão usados:
{{}}— A AWS região padrão especificada na configuração de suas AWS credenciais.
{{}}— O bucket será nomeado{{mortgage-flow-deployment--}}, onde {{}} está o ID AWS da sua conta e {{}} corresponde ao valor fornecido ou à AWS região padrão especificada na configuração de suas AWS credenciais.
1. 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.
**nota**
Se o script falhar, você poderá preparar manualmente os recursos fazendo o seguinte:
Faça upload do *conteúdo* (não inclua a pasta em si) da `cloudformation-mortgage-flow-setup` pasta descompactada em um bucket do S3 no Leste dos EUA (Norte da Virgínia) no console do Amazon S3 em. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
Encontre o arquivo `templates/json/main-stack-tmp.yaml` ou `templates/json/main-stack-tmp.json` e faça o seguinte:
Altere o `Default` valor do `Q01pS3BucketName` parâmetro de {{MortgageFlowBucket}} para o nome do bucket do S3.
Remova `-tmp` do nome do arquivo, de forma que ele se torne `templates/json/main-stack.yaml` ou`templates/json/main-stack.json`.
### Crie a pilha usando o CloudFormation console
Em seguida, use o modelo que você salvou para provisionar uma CloudFormation pilha.
1. Abra o CloudFormation console em [https://console.aws.amazon.com/cloudformation](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.
1. Na página **Pilhas**, no menu **Criar pilha**, escolha **com novos recursos (padrão)**.
1. Especifique o modelo:
1. Em **Pré-requisito**, escolha **Escolher um modelo existente**.
1. Em **Especificar modelo**, escolha **Fazer upload de um arquivo de modelo**.
1. Selecione **Escolher arquivo**, navegue até `main-stack.yaml` ou o modelo `main-stack.json` e selecione-o.
1. Escolha **Próximo**.
1. Especifique os detalhes da pilha:
1. No campo **Nome da pilha**, insira um nome para a pilha.
1. 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](knowledge-base-setup.md).
1. Escolha **Próximo**.
1. 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`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html) no *Guia do usuário do CloudFormation *.
1. Em **Capacidades**, marque a caixa para reconhecer que isso CloudFormation pode criar recursos do IAM em sua conta.
1. Escolha **Próximo**.
1. 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.
1. 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](https://console.aws.amazon.com/bedrock).
1. No painel de navegação à esquerda, escolha **Bases de conhecimento** e selecione a base de conhecimento que você criou, chamada `AWSDocsTutorial-MortgageKB`.
1. 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`.
1. Escolha **Sincronizar**. Assim que a sincronização for concluída, você poderá testar o fluxo.
## Testar o fluxo de processamento de hipotecas
Depois que o fluxo de processamento da hipoteca for criado, você poderá usar o console do Amazon Bedrock para examinar, testar e modificar o fluxo. Também é possível examinar, testar e modificar os recursos individuais no 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](https://console.aws.amazon.com/bedrock).
1. 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.
1. Na seção **Fluxos**, selecione o fluxo que foi criado a partir do CloudFormation modelo. Deveria ser `AWSDocsTutorial-MortgageFlow`.
1. Escolha **Editar no construtor de fluxo**. Você pode arrastar nós individuais no fluxo para modificar a representação visual do fluxo.
1. 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.
1. 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 máximo acessível calculado, o prompt **ProcessApplication** é acionado e enviado para a **hipoteca ProcessingAgent**, 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.
1. (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/](https://console.aws.amazon.com/dynamodb/)
1. No painel de navegação à esquerda, selecione **Tabelas**.
1. Selecione a tabela que diz **AWSDocsTutorial-PropertyListing**.
1. Escolha **Explore table items** (Explorar itens da tabela).
1. Você pode usar qualquer um dos valores na coluna **mls\_id** na entrada do fluxo.
Você também pode navegar até as páginas de **gerenciamento de **Agentes**, **Bases de Conhecimento**, **Guardrails** e Prompt** no Console de gerenciamento da AWS para examinar cada recurso do Amazon Bedrock usado no fluxo, de forma independente. Para saber mais sobre o fluxo e entender mais detalhadamente os componentes, consulte [Detalhes sobre o fluxo de processamento de hipotecas](getting-started-mortgage-flow-details.md).
## Limpar: exclusão de recursos
Depois que você explorar os recursos e entender melhor as capacidades dos diferentes recursos do Amazon Bedrock, excluiremos a pilha e os recursos que ela contém.
**Importante**
Enquanto você não excluir os recursos da Amazon que você criar, você receberá cobranças por eles.
1. Abra a [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. No painel de navegação à esquerda, escolha **Pilhas**.
1. 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.