AWS Well-Architected Agent befindet sich in der Vorschauversion und kann sich ändern.
# Empfehlungen in AWS Well-Architected Agent umsetzen
AWS WA Agent bietet mehrere Umsetzungsoptionen, darunter automatisierte Problembehebung über AWS Systems Manager, geführte Self-Service-Aktionen und Unterstützung mit menschlicher Beteiligung, die mit Premier-Support-Plänen verfügbar ist.
## Problembehebungsmodelle
AWS WA Agent verwendet zwei Problembehebungsmodelle, abhängig davon, wie die Empfehlung generiert wurde:
+ **SSM-Runbook-Automatisierung:** Empfehlungen, die aus AWS Trusted Advisor-Prüfungen abgeleitet wurden, verfügen über vorgefertigte SSM-Runbooks. Dabei handelt es sich um deterministische, getestete Automatisierungen, die direkt ausgeführt oder für die wiederkehrende Ausführung geplant werden können. AWS WA Agent kann mit Ihrer Zustimmung die Problembehebung mit nur einem Klick in Ihrem Namen auslösen.
+ **Geführte Aktionen (KI-generiert):** Empfehlungen, die von der AWS WA Agent-KI-Engine generiert werden (Ressourcen-, Anwendungs- und Architekturtypen), enthalten Schritt-für-Schritt-Anleitungen für geführte Aktionen. Dazu können AWS CLI-Befehle, SDK-Code, Konsolendurchläufe oder aktualisierte IaC-Vorlagen gehören. Geführte Aktionen haben beratenden Charakter und sollten vor der Ausführung überprüft werden.
**Wichtig**
AWS WA Agent führt keine KI-generierten Problembehebungsschritte in Ihrem Namen aus. KI-generierte geführte Aktionen werden Ihnen zur Überprüfung und Validierung bereitgestellt. Sie sind dafür verantwortlich, diese Schritte in Ihrer Umgebung zu überprüfen, zu testen und auszuführen. Dies entspricht dem AWS-Modell der geteilten Verantwortung für KI-generierte Inhalte.
## SSM-Runbook für die Problembehebung ausführen
Wenn für eine Empfehlung keine vorab geplante automatische Problembehebung konfiguriert ist, können Sie die SSM-Runbook-Details anzeigen und das SSM-Runbook für die Problembehebung ausführen.
**So verwenden Sie die automatisierte Problembehebung**
1. Navigieren Sie zur Detailseite der jeweiligen Empfehlung.
1. Wechseln Sie zum Abschnitt „vorab geplante automatische Problembehebung“, sofern verfügbar.
1. Überprüfen Sie die SSM-Runbook-Details, einschließlich Zeitplan und nächster Ausführungszeit.
1. Wählen Sie das SSM-Runbook aus.
1. Wählen Sie **SSM-Runbook ausführen**, um die Automatisierung sofort auszuführen.
1. Überwachen Sie den Ausführungsstatus und die Ergebnisse.
## Geführte Problembehebung starten
Nachdem Sie eine Empfehlung überprüft haben, wählen Sie **Problembehebung starten**, um einen geführten Problembehebungs-Workflow zu starten. AWS WA Agent generiert eine schrittweise Standardarbeitsanweisung (SOP), die auf die spezifischen Ressourcen in Ihrer Umgebung zugeschnitten ist. Die SOP ist ressourcenorientiert: Jeder Schritt verweist auf tatsächliche Ressourcennamen und ARNs aus Ihrem Konto statt auf generische Platzhalter.
**So starten Sie die Problembehebung**
1. Wählen Sie auf der Detailseite der Empfehlung **Problembehebung starten**.
1. Wählen Sie eine Problembehebungsmethode aus:
+ **Mit AWS-Managementkonsole:** Schrittweise Navigationsanweisungen für die Konsole.
+ **Mit AWS CLI:** AWS CLI-Befehle, die Sie kopieren und ausführen können.
+ **Mit SDK:** SDK-Code (Python/boto3), den Sie anpassen und ausführen können.
AWS WA Agent generiert eine phasenbasierte SOP für die ausgewählte Methode. Jede Methode erzeugt eine andere SOP mit Anweisungen, die für das jeweilige Tool geeignet sind. Die Konsolen-SOP führt Sie beispielsweise durch die UI-Navigation, während die CLI-SOP sofort ausführbare Befehle bereitstellt.
## Der geführten SOP folgen
Die Problembehebungsansicht ist in drei Bereiche unterteilt:
+ **Linker Bereich (Phasen):** Listet alle Phasen in der SOP auf (z. B. Phase 1 von 10, Phase 2 von 10). Die aktuelle Phase ist hervorgehoben. Phasentitel beschreiben die Aktion (z. B. „S3-Bucket-Schlüssel für den CloudTrail-Protokoll-Bucket aktivieren“).
+ **Mittlerer Bereich (Anweisungen):** Detaillierte Anweisungen für die aktuelle Phase. Je nach Problembehebungsmethode kann dies Navigationsschritte in der Konsole, CLI-Befehle mit Kopierschaltflächen oder SDK-Codeausschnitte umfassen.
+ **Rechter Bereich (Ressourcen):** Links zur relevanten AWS-Dokumentation für die aktuelle Phase.
So durchlaufen Sie die SOP:
+ Wählen Sie **Als abgeschlossen markieren**, um festzuhalten, dass Sie die aktuelle Phase abgeschlossen haben, und wählen Sie dann **Weiter**, um fortzufahren.
+ Sie können zu jeder Phase navigieren, indem Sie sie im linken Bereich auswählen.
+ Die Phasen sind spezifisch für Ihre Ressourcen. Wenn eine Empfehlung beispielsweise vier S3-Buckets betrifft, enthält die SOP für jeden Bucket eine separate Phase und verweist namentlich darauf.
Typische SOP-Phasen umfassen:
1. Voraussetzungen (Überprüfen der Toolinstallation und der Anmeldeinformationen)
1. Problembehebungsschritte pro Ressource (eine oder mehrere Phasen pro betroffener Ressource)
1. Verifizierung (Bestätigen, dass die Änderung wirksam wurde)
1. Dokumentation (Aufzeichnen von Änderungen für Compliance und Audit)
**Wichtig**
Problembehebungs-SOPs werden mithilfe der generativen KI-Funktionen von AWS generiert und können Fehler oder unvollständige Informationen enthalten. Empfehlungen können Informationen im Zusammenhang mit Sicherheit enthalten, einem differenzierten Thema. Sie sind dafür verantwortlich, die Empfehlung in Ihrem spezifischen Kontext zu bewerten und angemessene Aufsicht und Schutzmaßnahmen umzusetzen. Überprüfen Sie alle Schritte, bevor Sie sie in der Produktion ausführen. Weitere Informationen zu den Responsible-AI-Praktiken von AWS finden Sie unter [https://aws.amazon.com/ai/responsible-ai/policy/](https://aws.amazon.com/ai/responsible-ai/policy/).
## Herunterladen der vollständigen SOP
Wählen Sie **Vollständige SOP herunterladen**, um das vollständige Verfahren für die aktuell ausgewählte Behebungsmethode zu exportieren. Der Download enthält alle Phasen, Befehle und Ressourcenverweise in einem einzigen Dokument.
Jede Behebungsmethode (Konsole, CLI, SDK) verfügt über eine eigene herunterladbare SOP. Wechseln Sie über die Optionsfelder oben auf der Behebungsseite zwischen den Methoden, um die benötigte Version herunterzuladen.
Heruntergeladene SOPs sind nützlich für:
+ Offline-Ausführung in Umgebungen ohne Konsolenzugriff
+ Anhängen an Change-Management-Tickets zur Genehmigung
+ Übergabe der Implementierung an ein anderes Teammitglied
+ Archivierung als Nachweis des Behebungsverfahrens
## Abschließen der Behebung
### Konsole
Nachdem Sie alle Phasen abgeschlossen haben, wählen Sie oben auf der Behebungsseite **Empfehlung als abgeschlossen markieren**. Die Empfehlung wird in Ihre archivierten Empfehlungen verschoben. Wenn die zugrunde liegende Bedingung in einem zukünftigen Aktualisierungszyklus erneut auftritt, generiert AWS WA Agent eine neue Empfehlung.
### CLI
So markieren Sie eine Empfehlung als abgeschlossen:
```
aws wellarchitected update-agent-recommendation-status \
--recommendation-arn "{{arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id}}" \
--status COMPLETED
```
So unterdrücken Sie eine Empfehlung:
```
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}}"
```
So öffnen Sie eine zuvor geschlossene Empfehlung erneut:
```
aws wellarchitected update-agent-recommendation-status \
--recommendation-arn "{{arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id}}" \
--status ACTIVE
```