Agen AWS Well-Architected berada dalam tahap rilis pratinjau dan dapat mengalami perubahan.

# Menerapkan Rekomendasi di Agen AWS Well-Architected
<a name="agent-implement-rec"></a>

Agen AWS WA menyediakan beberapa opsi implementasi, termasuk remediasi otomatis melalui AWS Systems Manager, tindakan yang dipandu dan dilakukan sendiri, dan dukungan human-in-the-loop, yang tersedia dengan paket Premier Support.

## Model Remediasi
<a name="agent-remediation-models"></a>

Agen AWS WA menggunakan dua model remediasi, bergantung pada cara rekomendasi dihasilkan:
+ **Otomatisasi Runbook SSM:** Rekomendasi yang diperoleh dari pemeriksaan AWS Trusted Advisor memiliki Runbook SSM yang sudah dibuat sebelumnya. Ini adalah otomatisasi deterministik dan teruji yang dapat dijalankan secara langsung atau dijadwalkan untuk pelaksanaan berulang. Agen AWS WA dapat memicu remediasi satu klik atas nama Anda dengan persetujuan Anda.
+ **Tindakan yang dipandu (buatan AI):** Rekomendasi yang dihasilkan oleh mesin AI Agen AWS WA (sumber daya, aplikasi, dan jenis arsitektur) mencakup tindakan yang dipandu langkah demi langkah. Ini mungkin termasuk perintah AWS CLI, kode SDK, penelusuran konsol, atau templat IaC yang diperbarui. Tindakan yang dipandu adalah penasihat dan harus ditinjau sebelum dilaksanakan.

**penting**  
Agen AWS WA tidak menjalankan langkah-langkah remediasi yang dihasilkan AI atas nama Anda. Tindakan yang dipandu yang dihasilkan AI disediakan untuk peninjauan dan validasi Anda. Anda bertanggung jawab untuk meninjau, menguji, dan melaksanakan langkah-langkah ini di lingkungan Anda. Ini mengikuti model tanggung jawab bersama AWS untuk konten yang dihasilkan AI.

## Jalankan Runbook SSM untuk remediasi
<a name="agent-ssm-runbook-remediation"></a>

Ketika remediasi otomatis yang dijadwalkan sebelumnya tidak dikonfigurasi untuk rekomendasi, Anda dapat melihat detail Runbook SSM dan menjalankan Runbook SSM untuk remediasi.

**Untuk menggunakan remediasi otomatis**

1. Lanjutkan ke halaman detail rekomendasi spesifik.

1.  Buka bagian "remediasi otomatis yang dijadwalkan sebelumnya", jika tersedia.

1. Tinjau detail Runbook SSM, termasuk jadwal dan waktu proses berikutnya.

1. Pilih Runbook SSM.

1. Pilih **Jalankan runbook SSM** untuk segera menjalankan otomatisasi.

1. Memantau status pelaksanaan dan hasil.

## Memulai Remediasi yang Dipandu
<a name="agent-start-remediation"></a>

Setelah meninjau rekomendasi, pilih **Mulai remediasi** untuk memulai alur kerja remediasi yang dipandu. Agen AWS WA menghasilkan prosedur operasi standar (SOP) langkah demi langkah yang disesuaikan dengan sumber daya spesifik di lingkungan Anda. SOP sadar sumber daya: setiap langkah mereferensikan ARN dan nama sumber daya aktual dari akun Anda, bukan placeholder generik.

**Untuk memulai remediasi**

1. Di halaman detail rekomendasi, pilih **Mulai remediasi.**

1. Pilih metode remediasi:
   + **Menggunakan Konsol Manajemen AWS:** Petunjuk navigasi konsol langkah demi langkah.
   + **Menggunakan AWS CLI:** Perintah AWS CLI yang dapat Anda salin dan jalankan.
   + **Menggunakan SDK:** Kode SDK (Python/boto3) Anda dapat adaptasi dan jalankan.

Agen AWS WA menghasilkan SOP bertahap untuk metode yang dipilih. Setiap metode menghasilkan SOP yang berbeda dengan instruksi yang sesuai dengan alat tersebut. Misalnya, SOP konsol memandu Anda dalam navigasi UI, sedangkan SOP CLI menyediakan perintah siap dijalankan.

## Mengikuti SOP yang Dipandu
<a name="agent-follow-sop"></a>

Tampilan remediasi diatur menjadi tiga panel:
+ **Panel kiri (fase):** Berisi semua fase dalam SOP (misalnya, Fase 1 dari 10, Fase 2 dari 10). Fase saat ini disorot. Judul fase menjelaskan tindakannya (misalnya, "Aktifkan Kunci Bucket S3 untuk bucket log CloudTrail").
+ **Panel tengah (instruksi):** Instruksi terperinci untuk fase saat ini. Bergantung pada metode remediasinya, ini mungkin termasuk langkah navigasi konsol, perintah CLI dengan tombol salin, atau cuplikan kode SDK.
+ **Panel kanan (sumber daya):** Tautan ke dokumentasi AWS yang relevan untuk fase saat ini.

Untuk maju melalui SOP:
+ Pilih **Tandai sebagai selesai** untuk mencatat bahwa Anda telah menyelesaikan fase saat ini, lalu pilih **Berikutnya** untuk maju.
+ Anda dapat menavigasi ke fase apa pun dengan memilihnya di panel kiri.
+ Fase bersifat spesifik untuk sumber daya Anda. Misalnya, jika rekomendasi memengaruhi empat bucket S3, SOP mencakup fase terpisah untuk setiap bucket, mereferensikannya dengan nama.

Fase SOP tipikal meliputi:

1. Prasyarat (verifikasi instalasi alat, kredensial)

1. Langkah remediasi per sumber daya (satu atau lebih fase per sumber daya yang terdampak)

1. Verifikasi (konfirmasi perubahan terjadi)

1. Dokumentasi (mencatat perubahan untuk kepatuhan dan audit)

**penting**  
SOP remediasi dihasilkan menggunakan kemampuan AI generatif AWS dan dapat berisi kesalahan atau informasi yang tidak lengkap. Rekomendasi dapat berisi informasi terkait keamanan, topik bernuansa. Anda bertanggung jawab untuk mengevaluasi rekomendasi dalam konteks spesifik Anda dan menerapkan pengawasan dan perlindungan yang tepat. Tinjau semua langkah sebelum menjalankan dalam produksi. Untuk informasi lebih lanjut tentang praktik AI yang Bertanggung Jawab AWS, lihat [https://aws.amazon.com/ai/responsible-ai/policy/](https://aws.amazon.com/ai/responsible-ai/policy/).

## Mengunduh SOP Lengkap
<a name="agent-download-sop"></a>

Pilih **Unduh SOP lengkap** untuk mengekspor prosedur lengkap untuk metode remediasi yang saat ini dipilih. Unduhan berisi semua fase, perintah, dan referensi sumber daya dalam satu dokumen.

Setiap metode remediasi (Konsol, CLI, SDK) memiliki SOP unik yang dapat diunduh. Ganti metode menggunakan tombol radio di bagian atas halaman remediasi untuk mengunduh versi yang Anda butuhkan.

SOP yang diunduh berguna untuk:
+ Pelaksanaan offline di lingkungan tanpa akses konsol
+ Melampirkan ke tiket manajemen perubahan untuk persetujuan
+ Menyerahkan implementasi ke anggota tim lain
+ Pengarsipan sebagai catatan prosedur remediasi

## Menyelesaikan remediasi
<a name="agent-complete-remediation"></a>

### Konsol
<a name="agent-complete-remediation-console"></a>

Setelah menyelesaikan semua fase, pilih **Tandai rekomendasi sebagai selesai** di bagian atas halaman remediasi. Rekomendasi pindah ke rekomendasi yang diarsipkan. Jika kondisi yang mendasarinya berulang dalam siklus penyegaran di waktu mendatang, Agen AWS WA membuat rekomendasi baru.

### CLI
<a name="agent-complete-remediation-cli"></a>

Untuk menandai rekomendasi sebagai selesai:

```
aws wellarchitected update-agent-recommendation-status \
    --recommendation-arn "{{arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id}}" \
    --status COMPLETED
```

Untuk menahan rekomendasi:

```
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}}"
```

Untuk membuka kembali rekomendasi yang sebelumnya ditutup:

```
aws wellarchitected update-agent-recommendation-status \
    --recommendation-arn "{{arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id}}" \
    --status ACTIVE
```