Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Tutorial: creación de un flujo que procese solicitudes hipotecarias
Para familiarizarnos con los recursos de Amazon Bedrock y sus capacidades, utilizaremos una CloudFormation plantilla para configurar un [flujo](flows.md) que automatice los procesos del proceso de solicitud de una hipoteca mediante la combinación de varios recursos de Amazon Bedrock y otros recursos. AWS
**nota**
Para este tutorial, utilizaremos la región. {{us-east-1}} Puede usar cualquier región que admita agentes, flujos, barreras de protección, bases de conocimiento y administración de peticiones. Para ver una tabla de compatibilidad de las características por región, consulte [Soporte de funciones por parte de Región de AWS en Amazon Bedrock](features-regions.md). Asegúrese de tener permisos para crear recursos de Amazon S3, Amazon Bedrock, Lambda y DynamoDB en la región que utilice.
Este flujo no está pensado para fines de implementación, sino para usarlo como un tutorial para conocer los recursos de Amazon Bedrock. La siguiente imagen es la representación visual del flujo en la Consola de administración de AWS:
El flujo combina un [agente](agents.md) de Amazon Bedrock, [peticiones](prompt-management.md) y una [función de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) para crear un flujo de procesamiento hipotecario que incorpora la información financiera del cliente y la procesa si el cliente reúne los requisitos para un préstamo. También se asocian una [base de conocimiento](knowledge-base.md) y una [barrera de protección](guardrails.md) de Amazon Bedrock al agente del flujo para aumentar las respuestas y proporcionar medidas de seguridad. Para obtener información detallada acerca de los componentes del flujo, consulte [Detalles sobre el flujo de procesamiento de hipotecas](getting-started-mortgage-flow-details.md).
**Topics**
+ [Requisitos previos](#getting-started-mortgage-flow-prereqs)
+ [Cree el flujo de procesamiento de la hipoteca mediante CloudFormation](#getting-started-mortgage-flow-create)
+ [Prueba del flujo de procesamiento de hipotecas](#getting-started-mortgage-flow-test)
+ [Limpieza: eliminación de recursos](#getting-started-mortgage-flow-delete)
+ [CloudFormation plantillas](getting-started-mortgage-flow-template.md)
+ [Detalles sobre el flujo de procesamiento de hipotecas](getting-started-mortgage-flow-details.md)
## Requisitos previos
Para crear este flujo, debe descargar un archivo .zip y seguir las instrucciones para ejecutar un script que configurará los recursos y la plantilla por usted.
**importante**
Se le cobrarán los recursos de Amazon que cree hasta que los elimine.
A continuación, complete los requisitos previos siguientes:
1. Descargue el archivo [cloudformation-mortgage-flow-setup.zip](samples/cloudformation-mortgage-flow-setup.zip).
1. Descomprima el archivo. Puede obtener más información sobre el contenido en [CloudFormation plantillas](getting-started-mortgage-flow-template.md).
1. Solicite acceso a los modelos fundacionales de Amazon Bedrock de la siguiente manera:
1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola Amazon Bedrock en [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Asegúrese de que está en la región **Este de EE. UU. (Norte de Virginia)** marcando su región en la esquina superior derecha. Si no está en esa región, cambie de región.
1. Seleccione **Acceso a modelos** en la parte inferior del panel de navegación de la izquierda.
1. Seleccione **Modificar el acceso al modelo**.
1. Realice una de las siguientes acciones:
+ Para solicitar el acceso a todos los modelos, seleccione **Activar todos los modelos**. En la página a la que se le dirige, se rellenarán las casillas de verificación situadas junto a todos los modelos.
+ Para solicitar el acceso a modelos específicos, seleccione **Activar modelos específicos**. En la página a la que se le dirige, tendrá las siguientes opciones:
+ Para solicitar acceso a todos los modelos por parte de un proveedor, seleccione la casilla de verificación situada junto al nombre del proveedor.
+ Para solicitar acceso a un modelo, seleccione la casilla de verificación situada junto al nombre del modelo.
1. Para los siguientes tutoriales, debe solicitar como mínimo acceso a los modelos **Titan Embeddings G1 - Text** y **Claude Haiku 4.5**. A continuación, elija **Siguiente**.
1. Revise los modelos a los que solicita acceso y los **Términos**. Cuando haya terminado, elija **Enviar** para solicitar acceso.
## Cree el flujo de procesamiento de la hipoteca mediante CloudFormation
Para crear el flujo de procesamiento de hipotecas y sus recursos asociados, crearemos una CloudFormation plantilla y la usaremos para crear una pila que contenga los recursos de Amazon Bedrock.
**importante**
Se le cobrarán los recursos de Amazon que cree hasta que los elimine.
### Cree los recursos y CloudFormation archivo de plantilla
En primer lugar, utilice el script del archivo.zip para cargar los recursos en un bucket de S3 y crear las CloudFormation plantillas.
1. En una ventana de terminal, ejecute el siguiente comando para copiar los recursos en un bucket de Amazon S3 y rellenar los archivos `main-stack.yaml` y `main-stack.json` con el nombre del bucket de S3 como valor predeterminado para el parámetro del nombre del bucket.
```
bash deploy.sh
```
**nota**
El uso del script es`bash deploy.sh {{}} {{}}`, donde {{}} y {{}} son argumentos opcionales. Si no los proporciona, se utilizarán los siguientes valores predeterminados:
{{}}— La AWS región predeterminada especificada en la configuración de sus AWS credenciales.
{{}}— Se asignará un nombre al depósito{{mortgage-flow-deployment--}}, donde {{}} estará el ID de su AWS cuenta y {{}} coincidirá con el valor que haya indicado o con la AWS región predeterminada especificada en la configuración de sus AWS credenciales.
1. Confirme las peticiones. Una vez finalizada la implementación, debe tener una plantilla `main-stack.yaml` y `main-stack.json` completas para el siguiente paso.
**nota**
Si se produce un error en el script, puede preparar los recursos manualmente de la siguiente manera:
Cargue el *contenido* (no incluya la carpeta en sí) de la `cloudformation-mortgage-flow-setup` carpeta descomprimida en un bucket de S3 en EE. UU. Este (Virginia del Norte) en la consola de Amazon S3 en. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
Busque el archivo `templates/json/main-stack-tmp.yaml` o `templates/json/main-stack-tmp.json` y haga lo siguiente:
Cambia el `Default` valor del `Q01pS3BucketName` parámetro de {{MortgageFlowBucket}} a tu nombre de bucket de S3.
Elimine `-tmp` del nombre del archivo, de modo que pase a ser `templates/json/main-stack.yaml` o `templates/json/main-stack.json`.
### Cree la pila mediante el CloudFormation consola
A continuación, usa la plantilla que has guardado para aprovisionar una CloudFormation pila.
1. Abre la CloudFormation consola en [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/). Asegúrese de que está en la región **Este de EE. UU. (Norte de Virginia)** marcando su región en la esquina superior derecha. Si no está en esa región, cambie de región.
1. En la página **Pilas**, en el menú **Crear pila** elija **Con nuevos recursos (estándar)**.
1. En Especificar plantilla:
1. En **Requisito previo**, elija **Seleccionar una plantilla existente**.
1. En **Especificar plantilla**, elija **Cargar un archivo de plantilla**.
1. Seleccione **Elegir archivo** para acceder a la plantilla `main-stack.yaml` o `main-stack.json` y seleccionarla.
1. Elija **Siguiente**.
1. Especifique los detalles de la pila:
1. En **Nombre de la pila**, escriba un nombre para la pila.
1. En el campo **Parámetros**, deje los valores predeterminados.
**nota**
El valor de `Q01pS3BucketName` debe coincidir con el nombre del bucket de S3 en donde ha cargado los recursos de esta plantilla. Los argumentos restantes están relacionados con las configuraciones de la base de conocimiento; si modifica alguno de ellos, asegúrese de que las configuraciones sean compatibles entre sí. Para obtener más información, consulte [Requisitos previos para usar un almacén de vectores que haya creado para una base de conocimiento](knowledge-base-setup.md).
1. Elija **Siguiente**.
1. Configure las opciones la pila:
1. En las **opciones de error de pila**, seleccione **Eliminar todos los recursos recién creados.**
**nota**
Si elige esta opción, evita que se le facturen los recursos cuya política de eliminación especifique que se conservarán incluso si se produce un error durante la creación de la pila. Para obtener más información, consulte [Atributo `DeletionPolicy`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html) en la *Guía del usuario de CloudFormation *.
1. En **Capacidades**, marca la casilla para confirmar que esto CloudFormation podría crear recursos de IAM en tu cuenta.
1. Elija **Siguiente**.
1. Revisa los detalles de la pila y selecciona **Enviar**. CloudFormation crea la pila. Se tardan varios minutos en crear la pila. Una vez que se complete la creación de la pila, puede usar la pestaña **Recursos** de la página de detalles de la pila para ver los recursos que se aprovisionaron en su cuenta.
1. Una vez finalizada la creación de la pila, haga lo siguiente para sincronizar el origen de datos de la base de conocimiento para poder consultarla:
1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola Amazon Bedrock en [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. En el panel de navegación izquierdo, seleccione **Base de conocimientos** y elija la base de conocimiento que creó, llamada `AWSDocsTutorial-MortgageKB`.
1. En la sección **Origen de datos**, seleccione la casilla de verificación situada junto al origen de datos que creó, llamado `AWSDocsTutorial-MortgageKB-DS`.
1. Elija **Sincronizar**. Una vez completada la sincronización, puede probar el flujo.
## Prueba del flujo de procesamiento de hipotecas
Una vez creado el flujo de procesamiento de hipotecas, puede utilizar la consola de Amazon Bedrock para examinar, probar y modificar el flujo. También puede examinar, probar y modificar los recursos individuales del flujo.
**Cómo probar el flujo**
1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola Amazon Bedrock en [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. En el panel de navegación izquierdo, seleccione **Flujos**. Asegúrese de que está en la región **Este de EE. UU. (Norte de Virginia)** marcando su región en la esquina superior derecha. Si no está en esa región, cambie de región.
1. En la sección **Flujos**, seleccione el flujo que se creó a partir de la CloudFormation plantilla. Debería ser `AWSDocsTutorial-MortgageFlow`.
1. Seleccione **Editar en generador de flujos**. Puede arrastrar nodos individuales en el flujo para modificar la representación visual del flujo.
1. En el panel **Probar flujo**, introduzca lo siguiente en el campo de texto y, a continuación, seleccione **Ejecutar**.
```
{
"income": 80000,
"totalDebt": 5000,
"loanTerm": 30,
"loanAmount": 600000,
"creditScore": 750,
"mlsId": "MLS-5678"
}
```
Como el importe del préstamo es superior al préstamo máximo asequible calculado, se desencadena la petición **incomeDebt** y el flujo genera una carta de rechazo. Puede seleccionar **Mostrar rastro** para ver los nodos que se ejecutaron en el flujo.
1. De nuevo, en el panel **Probar flujo**, introduzca lo siguiente en el campo de texto y, a continuación, seleccione **Ejecutar**.
```
{
"income": 120000,
"totalDebt": 5000,
"loanTerm": 30,
"loanAmount": 200000,
"creditScore": 650,
"mlsId": "MLS-3456"
}
```
Como el importe del préstamo es inferior al préstamo máximo asequible calculado, se activa el mensaje **ProcessApplication** y se envía a la **hipoteca ProcessingAgent**, que consulta la base de conocimientos adjunta y genera una respuesta en la que se evalúa, en función de los valores introducidos, si el cliente reúne los requisitos para solicitar un préstamo.
1. (Opcional) Intente ejecutar el flujo utilizando valores diferentes para los campos del objeto JSON. Los valores de `mlsId` corresponden a las propiedades que figuran en el Servicio de listado múltiple. Puede encontrar los valores de `mlsId` válidos de la siguiente forma:
1. Inicie sesión en la consola de DynamoDB Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)
1. En el panel de navegación izquierdo, elija **Tablas**.
1. Seleccione la tabla que dice. **AWSDocsTutorial-PropertyListing**
1. Elija **Explorar elementos de la tabla**.
1. Puede usar cualquiera de los valores de la columna **mls\_id** en la entrada del flujo.
También puede navegar a las páginas **Agents**, **Knowledge Bases**, **Guardrails** y **Prompt Management** Consola de administración de AWS para examinar cada recurso de Amazon Bedrock utilizado en el flujo de forma independiente. Para obtener más información sobre el flujo y conocer los componentes con más detalle, consulte [Detalles sobre el flujo de procesamiento de hipotecas](getting-started-mortgage-flow-details.md).
## Limpieza: eliminación de recursos
Tras explorar los recursos y conocer mejor las capacidades de los distintos recursos de Amazon Bedrock, eliminaremos la pila y los recursos que contiene.
**importante**
Se le cobrarán los recursos de Amazon que cree hasta que los elimine.
1. Abra la [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. En el panel de navegación izquierdo, seleccione **Pila**.
1. Elija la pila que ha creado a partir de la plantilla. A continuación, elija **Eliminar** y confirme la operación eligiendo de nuevo **Eliminar**.
CloudFormation inicia la eliminación de la pila principal, todas sus pilas anidadas y todos los recursos incluidos en las pilas.