

# Erste Schritte mit AgentCore Code Interpreter
<a name="code-interpreter-getting-started"></a>

AgentCore Mit dem Code Interpreter können Ihre Agenten Python-Code in einer sicheren, verwalteten Umgebung ausführen. Der Agent kann Berechnungen durchführen, Daten analysieren, Visualisierungen generieren und Antworten durch Codeausführung validieren.

Diese Seite behandelt die Voraussetzungen und bietet zwei Möglichkeiten für den Einstieg:
+  **Verwendung von AWS Strands** — Ein hochrangiges Agenten-Framework, das die Erstellung von KI-Agenten mit integrierter Toolintegration, Konversationsmanagement und automatischer Sitzungsverwaltung vereinfacht.
+  **Direkte Nutzung** — SDK- und Boto3-Ansätze, die mehr Kontrolle über das Sitzungsmanagement und die Codeausführung für benutzerdefinierte Implementierungen bieten.

**Topics**
+ [Voraussetzungen](#code-interpreter-prerequisites)
+ [Konfigurieren der Anmeldeinformationen](#code-interpreter-credentials-config)
+ [Verwenden des AgentCore Codeinterpreters über AWS Stränge](code-interpreter-using-strands.md)
+ [Direktes Verwenden des AgentCore Code Interpreters](code-interpreter-using-directly.md)

## Voraussetzungen
<a name="code-interpreter-prerequisites"></a>

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:
+  AWS Konto mit konfigurierten Anmeldeinformationen. Weitere Informationen finden [Sie unter Konfiguration Ihrer Anmeldeinformationen](#code-interpreter-credentials-config).
+ Python 3.10\+ installiert
+ Boto3 installiert. Weitere Informationen finden Sie in der [Boto3-Dokumentation](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html).
+ IAM-Ausführungsrolle mit den erforderlichen Berechtigungen. Weitere Informationen finden Sie [unter Konfiguration Ihrer Anmeldeinformationen](#code-interpreter-credentials-config).
+ Modellzugriff: Anthropic Claude Sonnet 4.0 [ist in der Amazon Bedrock-Konsole aktiviert](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access-modify.html). Informationen zur Verwendung eines anderen Modells mit den Strands Agents finden Sie im Abschnitt *Model Providers* in der [Strands Agents](https://strandsagents.com/latest/documentation/docs/) SDK-Dokumentation.
+  AWS Region, in der Amazon Bedrock verfügbar AgentCore ist. Siehe [Unterstützte AWS Regionen](agentcore-regions.md).

## Konfigurieren der Anmeldeinformationen
<a name="code-interpreter-credentials-config"></a>

Führen Sie die folgenden Schritte aus, um Ihre AWS Anmeldeinformationen zu konfigurieren und die erforderlichen Berechtigungen zuzuweisen.

1.  **Überprüfen Sie Ihre AWS Anmeldedaten** 

   Bestätigen Sie, dass Ihre AWS Anmeldeinformationen konfiguriert sind:

   ```
   aws sts get-caller-identity
   ```
**Anmerkung**  
Notieren Sie sich den hier zurückgegebenen Benutzer oder die Anmeldeinformationen, da Sie ihn beim Anhängen der erforderlichen Berechtigungen verwenden werden.

   Wenn dieser Befehl fehlschlägt, konfigurieren Sie Ihre Anmeldeinformationen. Weitere Informationen finden Sie unter [Einstellungen für die Konfiguration und die Anmeldeinformationsdatei in der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html).

1.  **Hängen Sie die erforderlichen Berechtigungen an** 

   Ihr IAM-Benutzer oder Ihre IAM-Rolle benötigt Berechtigungen zur Verwendung von AgentCore Code Interpreter. Hängen Sie diese Richtlinie an Ihre IAM-Identität an:
**Anmerkung**  
`<region>`Ersetzen Sie sie in der Richtlinie unten durch die von Ihnen gewählte Region (zum Beispiel`us-west-2`) und `<account_id>` durch Ihre AWS Konto-ID:

   ```
   {
       "Version":"2012-10-17",	
       "Statement": [
           {
               "Sid": "BedrockAgentCoreCodeInterpreterFullAccess",
               "Effect": "Allow",
               "Action": [
                   "bedrock-agentcore:CreateCodeInterpreter",
                   "bedrock-agentcore:StartCodeInterpreterSession",
                   "bedrock-agentcore:InvokeCodeInterpreter",
                   "bedrock-agentcore:StopCodeInterpreterSession",
                   "bedrock-agentcore:DeleteCodeInterpreter",
                   "bedrock-agentcore:ListCodeInterpreters",
                   "bedrock-agentcore:GetCodeInterpreter",
                   "bedrock-agentcore:GetCodeInterpreterSession",
                   "bedrock-agentcore:ListCodeInterpreterSessions"
               ],
               "Resource": "arn:aws:bedrock-agentcore:<region>:++<account_id>++:code-interpreter/*"
           }
       ]
   }
   ```

 **Um diese Richtlinie anzuhängen** 

Dazu gehen Sie wie folgt vor:

1. Rufen Sie die IAM-Konsole auf

1. Finden Sie Ihren Benutzer oder Ihre Rolle anhand der Antwort, die für den `get-caller-identity` API-Vorgang zurückgegeben wurde.

1. Wählen Sie „**Berechtigungen hinzufügen**“ und anschließend „**Inline-Richtlinie erstellen**“ 

1. Wechseln Sie zur JSON-Ansicht und fügen Sie die obige Richtlinie ein

1. Benennen Sie es `AgentCoreCodeInterpreterAccess` und speichern Sie

**Anmerkung**  
Wenn Sie Agenten für Amazon Bedrock AgentCore Runtime bereitstellen, müssen Sie auch eine IAM-Ausführungsrolle mit einer Service Trust Policy erstellen. Weitere Informationen finden Sie unter [Erste Schritte mit AgentCore Runtime](runtime-getting-started.md).

In den folgenden Abschnitten erfahren Sie, wie Sie den Amazon Bedrock AgentCore Code Interpreter mit und ohne Agent-Framework verwenden. Die direkte Verwendung des Code Interpreters ohne Agent-Framework ist besonders nützlich, wenn Sie bestimmte Codefragmente programmgesteuert ausführen möchten.