Agent AWS Well-Architected est actuellement disponible en version préliminaire et susceptible d’être modifié.
# Implémentation de recommandations dans Agent AWS Well-Architected
Agent AWS WA propose de nombreuses options d’implémentation, notamment des corrections automatisées via AWS Systems Manager, des actions guidées en libre-service et un support avec intervention humaine (HITL), disponible dans le cadre des plans de support Premier.
## Modèles de correction
Agent AWS WA utilise deux modèles de correction en fonction de la façon dont la recommandation a été générée :
+ **Automatisation des dossiers d’exploitation SSM** : les recommandations issues des vérifications AWS Trusted Advisor sont prédéfinies dans les dossiers d’exploitation SSM. Il s’agit d’une automatisation déterministe testée qui peut être exécutée directement ou planifiée pour une exécution récurrente. Agent AWS WA peut déclencher une correction en un clic en votre nom avec votre consentement.
+ **Actions guidées (générées par l’IA)** : les recommandations générées par le moteur d’IA Agent AWS WA (de type ressource, application et architecture) incluent des actions guidées étape par étape. Il peut s’agir de commandes AWS CLI, de code SDK, de présentations de consoles ou de modèles IaC mis à jour. Les actions guidées sont consultatives et doivent être examinées avant d’être exécutées.
**Important**
Agent AWS WA n’exécute pas les étapes de correction générées par l’IA en votre nom. Les actions guidées générées par l’IA sont fournies pour que vous les examiniez et les validiez. Vous êtes responsable de l’examen, du test et de l’exécution de ces étapes dans votre environnement. Cela suit le modèle de responsabilité partagée AWS pour le contenu généré par l’IA.
## Exécution du dossier d’exploitation SSM pour la correction
Lorsqu’une correction automatique préprogrammée n’est pas configurée pour une recommandation, vous pouvez consulter les détails du dossier d’exploitation SSM et exécuter le dossier d’exploitation SSM à des fins de correction.
**Pour utiliser la correction automatique**
1. Accédez à la page des détails de la recommandation spécifique.
1. Accédez à la section de correction automatique préprogrammée, si disponible.
1. Consultez les détails du dossier d’exploitation SSM, y compris le calendrier et l’heure de la prochaine exécution.
1. Choisissez le dossier d’exploitation SSM.
1. Choisissez **Exécuter le dossier d’exploitation SSM** pour exécuter l’automatisation immédiatement.
1. Surveillez le statut et les résultats de l’exécution.
## Démarrage de la correction guidée
Après avoir examiné une recommandation, choisissez **Commencer la correction** pour démarrer un flux de travail de correction guidé. Agent AWS WA génère une procédure opérationnelle standard (SOP) étape par étape adaptée aux ressources spécifiques de votre environnement. La SOP tient compte des ressources : chaque étape fait référence aux noms de ressources et aux ARN réels de votre compte plutôt qu’à des espaces réservés génériques.
**Pour commencer la correction**
1. Sur la page des détails de la recommandation, choisissez **Commencer la correction**.
1. Sélectionnez une méthode de correction :
+ **À l’aide de la Console de gestion AWS** : instructions de navigation étape par étape dans la console.
+ **À l’aide de l’AWS CLI** : les commandes de l’AWS CLI que vous pouvez copier et exécuter.
+ **À l’aide du kit SDK** : code du kit SDK (Python/boto3) que vous pouvez adapter et exécuter.
Agent AWS WA génère une SOP progressive pour la méthode sélectionnée. Chaque méthode produit une SOP différente avec des instructions adaptées à cet outil. Par exemple, la SOP de la console vous guide dans la navigation de l’interface utilisateur, tandis que la SOP de la CLI fournit des commandes prêtes à être exécutées.
## Suivre la SOP guidée
La vue des corrections est organisée en trois panneaux :
+ **Panneau de gauche (phases)** : répertorie toutes les phases de la SOP (par exemple, phase 1 sur 10, phase 2 sur 10). La phase en cours est mise en surbrillance. Les titres des phases décrivent l’action (par exemple, « Activer les clés de compartiment S3 pour le compartiment des journaux CloudTrail »).
+ **Panneau central (instructions)** : instructions détaillées pour la phase en cours. Selon la méthode de correction, cela peut inclure des étapes de navigation dans la console, des commandes CLI avec des boutons de copie ou des extraits de code du kit SDK.
+ **Panneau de droite (ressources)** : liens vers la documentation AWS pertinente pour la phase en cours.
Pour progresser dans la SOP :
+ Choisissez **Marquer comme terminé** pour enregistrer que vous avez terminé la phase en cours, puis cliquez sur **Suivant** pour avancer.
+ Vous pouvez accéder à n’importe quelle phase en la sélectionnant dans le panneau de gauche.
+ Les phases sont spécifiques à vos ressources. Par exemple, si une recommandation concerne quatre compartiments S3, la SOP inclut une phase distincte pour chaque compartiment, en le référençant par son nom.
Les phases typiques des SOP incluent :
1. Conditions préalables (vérification de l’installation de l’outil, des informations d’identification)
1. Étapes de correction par ressource (une ou plusieurs phases par ressource affectée)
1. Vérification (confirmation que la modification a pris effet)
1. Documentation (enregistrement des modifications à des fins de conformité et d’audit)
**Important**
Les SOP de correction sont générées à l’aide de fonctionnalités d’IA générative AWS et peuvent contenir des erreurs ou des informations incomplètes. Les recommandations peuvent contenir des informations relatives à la sécurité, un sujet nuancé. Vous êtes responsable de l’évaluation de la recommandation dans votre contexte spécifique et de l’implémentation d’une surveillance et de mesures de protection appropriées. Examinez toutes les étapes avant de les exécuter en production. Pour plus d’informations sur les pratiques AWS en matière d’IA responsable, consultez [https://aws.amazon.com/ai/responsible-ai/policy/](https://aws.amazon.com/ai/responsible-ai/policy/).
## Téléchargement de la SOP complète
Choisissez **Télécharger la SOP complète** pour exporter l’intégralité de la procédure correspondant à la méthode de correction actuellement sélectionnée. Le téléchargement contient toutes les phases, commandes et références de ressources dans un seul document.
Chaque méthode de correction (console, CLI, kit SDK) possède sa propre SOP téléchargeable. Changez de méthode à l’aide des cases d’option situées en haut de la page de correction pour télécharger la version dont vous avez besoin.
Les SOP téléchargées sont utiles pour :
+ l’exécution hors ligne dans des environnements sans accès à la console ;
+ les joindre aux tickets de gestion des modifications pour approbation ;
+ transférer l’implémentation à un autre membre de l’équipe ;
+ l’archivage sous forme d’enregistrement de la procédure de correction.
## Terminer une correction
### Console
Une fois toutes les phases terminées, choisissez **Marquer la recommandation comme terminée** en haut de la page de correction. La recommandation est déplacée dans vos recommandations archivées. Si la condition sous-jacente se reproduit lors d’un futur cycle d’actualisation, Agent AWS WA génère une nouvelle recommandation.
### CLI
Pour marquer une recommandation comme terminée :
```
aws wellarchitected update-agent-recommendation-status \
--recommendation-arn "{{arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id}}" \
--status COMPLETED
```
Pour supprimer une recommandation :
```
aws wellarchitected update-agent-recommendation-status \
--recommendation-arn "{{arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id}}" \
--status SUPPRESSED \
--update-reason "{{Not applicable to our environment}}"
```
Pour rouvrir une recommandation précédemment fermée :
```
aws wellarchitected update-agent-recommendation-status \
--recommendation-arn "{{arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id}}" \
--status ACTIVE
```