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.
Implementación de un caso de uso de Bedrock Agent independiente
Siga las step-by-step instrucciones de esta sección para configurar e implementar la solución en su cuenta.
Tiempo de implementación: aproximadamente de 10 a 30 minutos
-
Inicie sesión en la consola de administración de AWS
y seleccione el botón para lanzar la CloudFront plantilla. BedrockAgent.plantilla
-
La plantilla se lanza en la región Este de EE. UU. (Norte de Virginia) de forma predeterminada. Para lanzar la solución en una región de AWS diferente, utilice el selector de regiones de la barra de navegación de la consola.
nota
Esta solución utiliza Amazon Bedrock, que actualmente no está disponible en todas las regiones de AWS. Si utiliza estas funciones, debe lanzar esta solución en una región de AWS en la que estén disponibles estos servicios. Para obtener la disponibilidad más reciente por región, consulte la lista de servicios regionales de AWS
. -
En la página Crear pila, verifique que la dirección URL de la plantilla correcta se encuentre en el cuadro de texto URL de Amazon S3 y elija Siguiente.
-
En la página Especificar los detalles de la pila, especifique un nombre para la pila. Para obtener información sobre las limitaciones de caracteres en los nombres, consulte {https---docs-aws-amazon-com- https---docs-aws-amazon-com -IAM-latest- UserGuide -reference-iam-limits-html} [Cuotas de IAM y AWS STS] en la Guía del usuario de AWS Identity and Access Management.
-
En Parámetros, revise los parámetros de esta plantilla de solución y modifíquelos según sea necesario. Esta solución utiliza los siguientes valores predeterminados.
Parámetro Entrada predeterminada Description (Descripción) UseCaseUUID (Identificador único universal)
<_Requires input_>36 caracteres UUIDv4 para identificar este caso de uso implementado en una aplicación.
UseCaseConfigRecordKey
<Requires input>Clave correspondiente al registro que contiene las configuraciones requeridas por la función Lambda del proveedor de chat en tiempo de ejecución.
El registro de la tabla debe tener un atributo clave que coincida con este valor y un atributo de configuración que contenga la configuración deseada.
La plataforma de despliegue rellenará este registro si está en uso. Para las implementaciones independientes de este caso de uso, se requiere una entrada creada manualmente en la tabla definida en UseCaseConfigTableName.
UseCaseConfigTableName
<Requires input>`La pila leerá la configuración de los casos de uso en la tabla que se proporciona aquí y utilizará la clave de registro definida en. UseCaseConfigRecordKey
DefaultUserEmail
placeholder@example.comCorreo electrónico del usuario predeterminado para este caso de uso. La solución crea un usuario de Amazon Cognito para que este correo electrónico acceda al caso de uso.
ExistingRestApiId
(Entrada opcional)
ID de API REST de API Gateway existente que se debe utilizar. Si no se proporciona, se creará una nueva API REST de API Gateway. Por lo general, se proporciona cuando se implementa desde el panel de implementación.
Nota: El uso de APIs Existing puede ayudar a reducir la duplicación de recursos y a simplificar la administración APIs cuando se necesitan implementar varios casos de uso independientes. Al suministrar los existentes APIs para un caso de uso independiente, usted es responsable de asegurarse de que la API esté configurada con las rutas requeridas con los modelos esperados. Es necesario configurar una ruta /details preconfigurada (que recopila los detalles del caso de uso durante el chat) y, opcionalmente, una ruta /feedback (si FeedbackEnabledestá configurada para
Yespermitir la recopilación de comentarios para las respuestas del chat de LLM). Además, y también se ExistingApiRootResourceIddebe proporcionar ExistingCognitoUserPoolId. ExistingCognitoGroupPolicyTableNameExistingApiRootResourceId
(Entrada opcional)
ID de recurso raíz de la API REST de API Gateway existente que se va a utilizar. El ID de recurso raíz de la API REST se puede obtener en la consola de AWS seleccionando el recurso raíz (/) en la sección «Recursos» de la API. El ID del recurso se mostrará entonces en el panel de detalles del recurso. También puede ejecutar una llamada a la API de descripción en su API de REST para buscar el ID del recurso raíz.
FeedbackEnabled
NoSi se establece en No, la pila de casos de uso implementada no tendrá acceso a la función de comentarios.
CognitoDomainPrefix
(Entrada opcional)
Introduzca un valor si desea proporcionar un dominio para el cliente del grupo de usuarios de Amazon Cognito. Si no proporciona un valor, la solución generará uno.
ExistingCognitoUserPoolId
(Entrada opcional)
UserPoolIdde un grupo de usuarios de Amazon Cognito existente con el que desee autenticar este caso de uso. NOTA: Por lo general, proporciona este ID al realizar la implementación desde el panel de implementación, pero puede omitirlo al implementar esta pila de casos de uso de forma independiente.
ExistingCognitoUserPoolClient
(Entrada opcional)
Proporcione un cliente de grupo de usuarios (cliente de aplicaciones) para usar uno existente. Si no proporciona un cliente de grupo de usuarios, la solución crea uno. Solo puede proporcionar este parámetro si proporcionó un ExistingCognitoUserPoolId.
ExistingCognitoGroupPolicyTableName
(Entrada opcional)
Nombre de la tabla de DynamoDB que contiene las políticas del grupo de usuarios. Lo utiliza el autorizador personalizado de la API del caso de uso. NOTA: Normalmente, se proporciona este nombre cuando se implementa desde el panel de implementación, pero se puede omitir cuando se implementa esta pila de casos de uso de forma independiente.
VpcEnabled
NoSi los recursos de la pila se implementarán en una VPC.
CreateNewVpc
NoSeleccione
Yessi desea que la solución cree una nueva VPC para usted y la utilice para este caso de uso. NOTA: Este parámetro solo es relevante si lo VpcEnabledesYes.IPAMPoolId
(Entrada opcional)
Si desea asignar el rango de CIDR mediante el IPAM, proporcione el ID del grupo de IPAM que se va a utilizar. NOTA: Este parámetro solo es relevante si es y VpcEnabledes
Yes. CreateNewVpcNoExistingVpcId
(Entrada opcional)
ID de VPC de una VPC existente que se utilizará en el caso de uso. NOTA: Este parámetro solo es relevante si VpcEnabledes
Yesy CreateNewVpces.NoExistingPrivateSubnetIds
(Entrada opcional)
Lista separada por comas de subredes IDs de subredes privadas existentes que se utilizarán para implementar la función Lambda. NOTA: Este parámetro solo es relevante si VpcEnabledes y es.
YesCreateNewVpcNoExistingSecurityGroupIds
(Entrada opcional)
Lista separada por comas de los grupos de seguridad de la VPC existente que se utilizarán para configurar las funciones de Lambda. NOTA: Este parámetro solo es relevante si VpcEnabledes y es.
YesCreateNewVpcNoVpcAzs
(Entrada opcional)
Lista separada por comas de AZs en la que se crean las subredes del VPCs
Nota: Solo es relevante si VpcEnabledes
Yesy CreateNewVpces.NoBedrockAgentId
<Requires input>El ID del agente de Amazon Bedrock que se va a utilizar.
BedrockAgentAliasId
<Requires input>El seudónimo del agente de Amazon Bedrock que se va a utilizar.
Implemente la interfaz
YesSeleccione la opción de implementar la interfaz de usuario de chat de la interfaz para esta implementación. La selección
Noda como resultado la creación de la infraestructura para alojar el procesamiento APIs, la autenticación y el APIs back-end sin la interfaz de usuario del chat. -
Elija Siguiente.
-
En la página Configurar opciones de pila, elija Siguiente.
-
En la página Revisar, revise y confirme la configuración. Seleccione la casilla para aceptar que la plantilla creará recursos de IAM.
-
Elija Create stack (Crear pila) para implementar la pila.
Puede ver el estado de la pila en la CloudFormation consola de AWS en la columna Estado. Debería recibir el estado CREATE_COMPLETE en un plazo aproximado de 10 a 30 minutos.
