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.
# Utilisation BedrockAgentIntent pour utiliser un agent Amazon Bedrock dans Amazon Lex V2
**Note**
Avant de pouvoir tirer parti des fonctionnalités de l'IA générative, vous devez remplir les conditions préalables suivantes :
Pour plus d'informations sur les tarifs d'utilisation d'Amazon Bedrock, consultez les tarifs d'[Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).
Activez les fonctionnalités d'IA générative pour les paramètres régionaux de votre bot. Pour ce faire, suivez les étapes indiquées sur[Optimisez la création et les performances des robots Lex V2 en utilisant l'IA générative](generative-features.md).
Vous pouvez tirer parti des agents Amazon Bedrock pour gérer les charges de travail complexes demandées par les clients sans avoir à passer par un processus complet de définition des tâches. Amazon Lex V2 propose une fonction intégrée `AMAZON.BedrockAgentIntent` que vous pouvez ajouter à votre bot. Cette intention exploite les capacités d'intelligence artificielle générative d'Amazon Bedrock en reconnaissant les demandes des clients, en les analysant, en les argumentant et en y répondant enfin. Il a également la capacité de poser des questions de suivi afin d'accomplir la tâche requise (par exemple, image : vous avez défini un agent de vente au détail qui peut vérifier l'état de la commande du client). Lorsque le client demande l'état de la commande, l'agent demande d'abord (`customerId`ou est associé`emailId`) de récupérer les détails, et répond enfin avec un statut de commande correct). Vous pouvez également décider d'intégrer votre AMAZON. BedrockAgentIntent avec une base de connaissances Bedrock pour répondre directement aux questions des clients.
Assurez-vous que votre rôle IAM dispose des autorisations appropriées pour accéder à AMAZON. BedrockAgentIntent en suivant les étapes de la section Permissions for the AMAZON. BedrockAgentIntent
Pour profiter de l'AMAZON. BedrockAgentIntent vous devez avoir configuré l'une des banques de connaissances suivantes.
+ Amazon Bedrock Agents — Pour plus d'informations, consultez [Création d'agents Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html).
+ Base de connaissances Amazon Bedrock — Pour plus d'informations, consultez [Création d'une base de connaissances](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-create.html).
Pour utiliser l'AMAZON. BedrockAgentIntent, assurez-vous que votre rôle IAM dispose des autorisations appropriées en suivant les étapes décrites dans la section [Permissions nécessaires dans Lex V2 pour Bedrock Agent Intent](https://docs.aws.amazon.com/lexv2/latest/dg/bedrock-agent-intent-permissions.html).
**Topics**
+ [Activez Bedrock Agent Intent dans l'écran de configuration de l'IA générative](bedrock-agent-intent-genai.md)
+ [Activez Bedrock Agent Intent en ajoutant une intention intégrée à votre bot](bedrock-agent-intent-level.md)
+ [Autorisations nécessaires dans Lex V2 pour Bedrock Agent Intent](bedrock-agent-intent-permissions.md)
+ [Exemple de demande avec attributs de session](bedrock-agent-intent-sample.md)
# Activez Bedrock Agent Intent dans l'écran de configuration de l'IA générative
Vous pouvez activer Bedrock Agent Intent en accédant à l'écran Generative AI.
1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon Lex V2 [https://console.aws.amazon.com/lexv2/chez](https://console.aws.amazon.com/lexv2/home) vous.
1. Dans le volet de navigation, sous **Bots**, sélectionnez le bot que vous souhaitez utiliser pour Bedrock Agent Intent.
1. Sélectionnez la langue du bot que vous souhaitez activer.
1. Accédez à la section **Configuration de l'IA générative** à l'écran, puis sélectionnez **Configurer**.
1. Dans la section BedrockAgentIntent de configuration, sélectionnez **Créer une BedrockAgent intention**.
# Activez Bedrock Agent Intent en ajoutant une intention intégrée à votre bot
Vous pouvez activer Bedrock Agent Intent en ajoutant une intention intégrée à votre bot Amazon Lex V2.
**Note**
Vous devez d'abord activer la fonctionnalité Bedrock Agent Intent sur le panneau Generative AI afin d'activer la fonctionnalité pour les robots individuels.
1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon Lex V2 https://console.aws.amazon.com/lexv2/ chez vous.
1. Dans le volet de navigation, sous **Bots**, sélectionnez le bot que vous souhaitez utiliser pour Bedrock Agent Intent.
1. Sous Toutes les langues, sélectionnez **Anglais (États-Unis**) pour développer la liste.
1. Sélectionnez **Ajouter une intention**, puis choisissez **Utiliser une intention intégrée** dans le menu déroulant.
1. Pour plus de détails sur les configurations pour l'AMAZON. BedrockAgentIntent, voir[AMAZON.BedrockAgentIntent](built-in-intent-bedrockagent.md).
# Autorisations nécessaires dans Lex V2 pour Bedrock Agent Intent
+ Pour accéder à cette fonctionnalité sur la console Amazon Lex V2, assurez-vous que votre rôle de console dispose `bedrock:ListFoundationModels` des `bedrock:ListInferenceProfiles` autorisations nécessaires.
+ Le rôle IAM associé au bot doit disposer des autorisations requises pour`AMAZON.BedrockAgentIntent`.
Le rôle de bot doit être autorisé à appeler `bedrock:InvokeAgent` s'il utilise des agents Amazon Bedrock `bedrock:InvokeModel` et `bedrock:RetrieveAndGenerate` s'il utilise les bases de connaissances Amazon Bedrock dans le but recherché. Vous devez également joindre une déclaration pour chacun des agents que vous spécifiez dans celle de vos robots `AMAZON.BedrockAgentIntent` (voir la déclaration relative aux autorisations d'accès à l'agent Amazon Bedrock ou aux autorisations d'accès aux bases de connaissances Amazon Bedrock dans la politique ci-dessous).
Lorsque vous activez cette fonctionnalité avec la console Amazon Lex, la politique est automatiquement ajoutée au rôle de bot, à condition que votre bot utilise un rôle lié à un service généré par Amazon Lex.
# Exemple de demande avec attributs de session
L'exemple suivant montre comment invoquer l'AMAZON. BedrockAgentIntent et montre les attributs de session et de demande renseignés dans la réponse. Ces attributs contiennent les données de réponse de l'agent Bedrock et peuvent être utilisés pour accéder aux résultats de l'agent, aux sources de la base de connaissances Amazon Bedrock et aux détails d'invocation des groupes d'action.
```
{
"sessionId": "user-session-123",
"messages": [{
"content": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"contentType": "PlainText"
}],
"sessionState": {
"sessionAttributes": {
"x-amz-lex:bedrock-agent-search-response": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"x-amz-lex:bedrock-knowledge-base-search-response-source": "[{\"title\": \"Order Processing Guide\", \"uri\": \"s3://knowledge-base/orders/processing.pdf\", \"excerpt\": \"Standard orders typically ship within 2-3 business days...\"}]",
"x-amz-lex:bedrock-agent-action-group-invocation-input": "{\"actionGroupName\": \"OrderLookup\", \"function\": \"getOrderStatus\", \"parameters\": {\"orderId\": \"12345\", \"customerId\": \"67890\"}}",
"x-amz-lex:bedrock-agent-knowledge-base-lookup-input": "{\"knowledgeBaseId\": \"KB123456\", \"query\": \"order status processing time\", \"numberOfResults\": 3}"
},
"intent": {
"name": "BedrockAgentIntent",
"slots": {},
"state": "Fulfilled",
"confirmationState": "None"
},
"dialogAction": {
"type": "ElicitIntent"
}
},
"interpretations": [{
"intent": {
"name": "FallbackIntent",
"slots": {}
},
"interpretationSource": "Lex"
}],
"requestAttributes": {
"x-amz-lex:channels:platform": "Web",
"x-amz-lex:accept-content-types": "PlainText",
"x-amz-lex:bedrock-agent-search-response": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"x-amz-lex:bedrock-knowledge-base-search-response-source": "[{\"title\": \"Order Processing Guide\", \"uri\": \"s3://knowledge-base/orders/processing.pdf\", \"excerpt\": \"Standard orders typically ship within 2-3 business days...\"}]",
"x-amz-lex:bedrock-agent-action-group-invocation-input": "{\"actionGroupName\": \"OrderLookup\", \"function\": \"getOrderStatus\", \"parameters\": {\"orderId\": \"12345\", \"customerId\": \"67890\"}}",
"x-amz-lex:bedrock-agent-knowledge-base-lookup-input": "{\"knowledgeBaseId\": \"KB123456\", \"query\": \"order status processing time\", \"numberOfResults\": 3}"
}
}
```
Dans cet exemple, les attributs de session indiquent comment les données de réponse sont BedrockAgentIntent renseignées, notamment la réponse de l'agent, les sources de la base de connaissances Amazon Bedrock utilisées, les appels aux groupes d'action et les détails de recherche de la base de connaissances Amazon Bedrock utilisés pour générer la réponse.
Pour plus d'informations, consultez [AMAZON. BedrockAgentIntent](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-bedrockagent.html).