AWS Well-Architected Agent befindet sich in der Vorschauversion und kann sich ändern.

# API-Schnellstart
<a name="agent-api-quickstart"></a>

Sie können AWS WA Agent vollständig über die AWS-CLI oder das SDK einrichten, anstatt die Konsole zu verwenden. Dieser Schnellstart führt Sie durch das Erstellen eines Profils, das Hinzufügen eines Ziels, das Hinzufügen von Anwendungskontext und das Überprüfen der Berechtigung.

**Anmerkung**  
Erstellen Sie vor der Verwendung der API die Ausführungsrolle und die Zugriffsrollen wie in [Schritt 3: Berechtigungen und Integrationen konfigurieren](agent-getting-started.md#agent-permissions-integrations) und [Schritt 6: Zugriffsrollen in Ihren Workload-Konten erstellen](agent-getting-started.md#agent-access-roles) beschrieben. Die API erstellt keine IAM-Rollen für Sie.

## Schritt 1: Erstellen eines Agentenprofils
<a name="agent-api-create-profile"></a>

Erstellen Sie ein Profil mit Ihrer Ausführungsrolle, den Zielsäulen und der Kontokonfiguration.

**So erstellen Sie ein Agentenprofil (CLI)**

1. Führen Sie den folgenden Befehl aus. Ersetzen Sie die Platzhalterwerte durch Ihre Konto-IDs, Rollen-ARNs und Zielregionen.
**Anmerkung**  
 Sie können einen gemeinsamen Namen für die Zugriffsrolle auswählen oder pro Konto einen Namen für die Zugriffsrolle eingeben. Dies ist nur in der API-Version des Onboardings verfügbar, nicht in der Konsole. 

   ```
   aws wellarchitected create-agent-profile \
       --name "my-production-profile" \
       --execution-role-arn "arn:aws:iam::{{111122223333}}:role/service-role/ExecutionRoleForWellArchitectedAgent" \
       --pillars COST_OPTIMIZATION SECURITY RESILIENCE PERFORMANCE \
       --aggregation-configuration '[{"accountId":"{{444455556666}}","accessRoleArn":"arn:aws:iam::{{444455556666}}:role/AccessRoleForWellArchitectedAgent","regions":["us-east-1","us-west-2"]}]'
   ```

1. Notieren Sie in der Antwort den Profil-ARN. Sie verwenden diesen Wert in nachfolgenden Befehlen.

## Schritt 2: Hinzufügen eines Optimierungsziels
<a name="agent-api-create-goal"></a>

Fügen Sie ein Ziel hinzu, um die Priorisierung von Empfehlungen zu steuern. Jedes Ziel ist einer oder mehreren Optimierungssäulen zugeordnet.

**So fügen Sie ein Ziel hinzu (CLI)**
+ Führen Sie den folgenden Befehl aus. Ersetzen Sie die Profil-ARN durch den Wert aus Schritt 1.

  ```
  aws wellarchitected create-agent-goal \
      --profile-arn "arn:aws:wellarchitected:{{us-east-1}}:{{111122223333}}:agent-profile/{{my-production-profile}}" \
      --title "Reduce EC2 spend by 20% by Q4 through rightsizing and Reserved Instance coverage" \
      --pillars COST_OPTIMIZATION
  ```

## Schritt 3: Anwendungskontext hinzufügen
<a name="agent-api-create-context"></a>

Stellen Sie Anwendungsmetadaten bereit, damit AWS WA Agent relevantere, personalisierte Empfehlungen generieren kann.

**So fügen Sie Anwendungskontext hinzu (CLI)**
+ Führen Sie den folgenden Befehl aus. Ersetzen Sie die Profil-ARN und die Inhaltsfelder durch Ihre Anwendungsdetails.

  ```
  aws wellarchitected create-agent-context \
      --profile-arn "arn:aws:wellarchitected:{{us-east-1}}:{{111122223333}}:agent-profile/{{my-production-profile}}" \
      --title "Payment processing service" \
      --context-type APPLICATION \
      --content '{"applicationOverview":"Real-time payment processing","criticality":"MISSION_CRITICAL","accountIds":["{{444455556666}}"],"regions":["us-east-1"]}'
  ```

## Schritt 4: Eignung des Profils überprüfen
<a name="agent-api-verify-eligibility"></a>

Überprüfen Sie, ob Ihr Profil gültig und für die Generierung von Empfehlungen geeignet ist.

**So überprüfen Sie die Eignung (CLI)**

1. Führen Sie den folgenden Befehl aus:

   ```
   aws wellarchitected get-agent-profile \
       --profile-arn "arn:aws:wellarchitected:{{us-east-1}}:{{111122223333}}:agent-profile/{{my-production-profile}}" \
       --query '{eligible: eligibleForScheduledGeneration, errors: fieldErrors}'
   ```

1. Wenn `eligibleForScheduledGeneration` den Wert `true` hat, ist Ihr Profil ordnungsgemäß konfiguriert. Geplante Empfehlungen werden innerhalb von 48 Stunden generiert.

1. Wenn `eligibleForScheduledGeneration` den Wert `false` hat, prüfen Sie die `fieldErrors`-Zuordnung auf spezifische Probleme. Informationen zu gängigen Lösungen finden Sie unter [Fehlerbehebung für AWS Well-Architected Agent](agent-troubleshooting.md).

Die vollständige API-Referenz finden Sie in der [AWS Well-Architected-API-Referenz](https://docs.aws.amazon.com/wellarchitected/latest/APIReference/Welcome.html).