Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Déploiement d'un cas d'utilisation autonome de l'agent Bedrock
Suivez les step-by-step instructions de cette section pour configurer et déployer la solution dans votre compte.
Temps de déploiement : environ 10 à 30 minutes
-
Connectez-vous à l'AWS Management Console
et sélectionnez le bouton pour lancer le CloudFront modèle. -
Le modèle est lancé par défaut dans la région USA Est (Virginie du Nord). Pour lancer la solution dans une autre région AWS, utilisez le sélecteur de région dans la barre de navigation de la console.
Note
Cette solution utilise Amazon Bedrock, qui n'est actuellement pas disponible dans toutes les régions AWS. Si vous utilisez ces fonctionnalités, vous devez lancer cette solution dans une région AWS où ces services sont disponibles. Pour connaître la disponibilité la plus récente par région, consultez la liste des services régionaux AWS
. -
Sur la page Create stack, vérifiez que l'URL du modèle est correcte dans la zone de texte URL Amazon S3 et choisissez Next.
-
Sur la page Spécifier les détails de la pile, attribuez un nom à votre pile de solutions. Pour plus d'informations sur les limites relatives aux caractères de dénomination, consultez {https---docs-aws-amazon-com- https---docs-aws-amazon-com -IAM-latest- UserGuide -reference-iam-limits-html} [quotas IAM et AWS STS] dans le guide de l'utilisateur d'AWS Identity and Access Management.
-
Sous Paramètres, passez en revue les paramètres de ce modèle de solution et modifiez-les si nécessaire. Cette solution utilise les valeurs par défaut suivantes.
Paramètre Entrée par défaut Description UseCaseUUID
<_Requires input_>36 caractères UUIDv4 pour identifier ce cas d'utilisation déployé au sein d'une application.
UseCaseConfigRecordKey
<Requires input>Clé correspondant à l'enregistrement contenant les configurations requises par la fonction Lambda du fournisseur de chat lors de l'exécution.
L'enregistrement de la table doit avoir un attribut clé correspondant à cette valeur et un attribut de configuration contenant la configuration souhaitée.
Cet enregistrement sera renseigné par la plateforme de déploiement si elle est utilisée. Pour les déploiements autonomes de ce cas d'utilisation, une entrée créée manuellement dans le tableau défini dans UseCaseConfigTableNameest requise.
UseCaseConfigTableName
<Requires input>`La pile lira la configuration des cas d'utilisation à partir du tableau fourni ici et à l'aide de la clé d'enregistrement définie dans UseCaseConfigRecordKey.
DefaultUserEmail
placeholder@example.comAdresse e-mail de l'utilisateur par défaut pour ce cas d'utilisation. La solution crée un utilisateur Amazon Cognito pour cet e-mail afin d'accéder au cas d'utilisation.
ExistingRestApiId
(Entrée facultative)
ID d'API REST API Gateway existant à utiliser. Si elle n'est pas fournie, une nouvelle API REST API Gateway sera créée. Généralement fourni lors du déploiement depuis le tableau de bord de déploiement.
Remarque : L'utilisation d' APIs Existing peut contribuer à réduire la duplication des ressources et à simplifier la gestion APIs lorsque vous devez déployer plusieurs cas d'utilisation autonomes. Lorsque vous fournissez APIs des données existantes pour un cas d'utilisation autonome, vous devez vous assurer que l'API est configurée avec les routes requises avec les modèles attendus. Une route /details préconfigurée obligatoire (récupère les détails des cas d'utilisation pendant le chat) et éventuellement une route /feedback (si elle FeedbackEnabledest définie pour permettre la collecte de commentaires pour les réponses de chat LLM) doivent
Yesêtre configurées. En outre ExistingApiRootResourceId, ExistingCognitoUserPoolIdet ExistingCognitoGroupPolicyTableNamedoit également être fourni.ExistingApiRootResourceId
(Entrée facultative)
ID de ressource racine de l'API REST API Gateway existant à utiliser. L'ID de ressource racine de l'API REST peut être obtenu à partir de la console AWS en sélectionnant la ressource racine (/) dans la section « Ressources » de l'API. L'ID de ressource sera ensuite affiché dans le panneau des détails de la ressource. Vous pouvez également exécuter un appel d'API de description sur votre API REST pour trouver l'ID de ressource racine.
FeedbackEnabled
NoSi ce paramètre est défini sur Non, la pile de cas d'utilisation déployée n'aura pas accès à la fonctionnalité de feedback.
CognitoDomainPrefix
(Entrée facultative)
Entrez une valeur si vous souhaitez fournir un domaine au client du groupe d'utilisateurs Amazon Cognito. Si vous ne fournissez aucune valeur, la solution en génère une.
ExistingCognitoUserPoolId
(Entrée facultative)
UserPoolIdd'un groupe d'utilisateurs Amazon Cognito existant auprès duquel vous souhaitez authentifier ce cas d'utilisation. REMARQUE : vous fournissez généralement cet identifiant lors du déploiement depuis le tableau de bord de déploiement, mais vous pouvez l'omettre lors du déploiement de cette pile de cas d'utilisation autonome.
ExistingCognitoUserPoolClient
(Entrée facultative)
Fournissez un client de groupe d'utilisateurs (client d'application) pour utiliser un client existant. Si vous ne fournissez pas de client de groupe d'utilisateurs, la solution en crée un. Vous ne pouvez fournir ce paramètre que si vous avez fourni un ExistingCognitoUserPoolId.
ExistingCognitoGroupPolicyTableName
(Entrée facultative)
Nom de la table DynamoDB contenant les politiques de groupe d'utilisateurs. Ceci est utilisé par l'autorisateur personnalisé sur l'API du cas d'utilisation. REMARQUE : vous fournissez généralement ce nom lors du déploiement depuis le tableau de bord de déploiement, mais vous pouvez l'omettre lors du déploiement de cette pile de cas d'utilisation autonome.
VpcEnabled
NoSi les ressources de la pile doivent être déployées au sein d'un VPC.
CreateNewVpc
NoIndiquez
Yessi vous souhaitez que la solution crée un nouveau VPC pour vous et l'utilise dans ce cas d'utilisation. REMARQUE : Ce paramètre n'est pertinent que s'il l'VpcEnabledestYes.IPAMPoolId
(Entrée facultative)
Si vous souhaitez attribuer la plage d'adresses CIDR à l'aide d'IPAM, indiquez l'ID du pool IPAM à utiliser. REMARQUE : Ce paramètre n'est pertinent que s'il VpcEnabledest
Yeset s'CreateNewVpcil estNo.ExistingVpcId
(Entrée facultative)
ID VPC d'un VPC existant à utiliser pour le cas d'utilisation. REMARQUE : Ce paramètre n'est pertinent que s'il VpcEnabledest
Yeset s'CreateNewVpcil estNo.ExistingPrivateSubnetIds
(Entrée facultative)
Liste séparée par des virgules IDs des sous-réseaux privés existants à utiliser pour déployer la fonction Lambda. REMARQUE : Ce paramètre n'est pertinent que s'il VpcEnabledest
Yeset s'CreateNewVpcil estNo.ExistingSecurityGroupIds
(Entrée facultative)
Liste séparée par des virgules des groupes de sécurité du VPC existant à utiliser pour configurer les fonctions Lambda. REMARQUE : Ce paramètre n'est pertinent que s'il VpcEnabledest
Yeset s'CreateNewVpcil estNo.VpcAzs
(Entrée facultative)
Liste séparée par des AZs virgules indiquant dans laquelle les sous-réseaux du VPCs sont créés
Remarque : N'est pertinent que s'il VpcEnabledest
Yeset s'CreateNewVpcil estNo.BedrockAgentId
<Requires input>L'ID de l'agent Amazon Bedrock à utiliser.
BedrockAgentAliasId
<Requires input>L'identifiant d'alias de l'agent Amazon Bedrock à utiliser.
Interface utilisateur de déploiement
YesSélectionnez l'option permettant de déployer l'interface utilisateur de discussion frontale pour ce déploiement. La sélection
Noentraîne la création de l'infrastructure pour héberger le APIs, l'authentification pour le APIs et le traitement principal sans l'interface utilisateur de chat. -
Choisissez Next (Suivant).
-
Sur la page Configurer les options de pile, choisissez Suivant.
-
Sur la page Vérification, vérifiez et confirmez les paramètres. Cochez la case indiquant que le modèle créera des ressources IAM.
-
Sélectionnez Create stack (Créer une pile) pour déployer la pile.
Vous pouvez consulter l'état de la pile dans la CloudFormation console AWS dans la colonne Status. Vous devriez recevoir le statut CREATE_COMPLETE dans 10 à 30 minutes environ.