View a markdown version of this page

Erste Schritte mit AgentCore Code Interpreter - Amazon Grundgestein AgentCore
VoraussetzungenKonfigurieren der Anmeldeinformationen

Erste Schritte mit AgentCore Code Interpreter

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.

Themen

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

Konfigurieren der Anmeldeinformationen

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.

  2. 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 Beispielus-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

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

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

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

  5. 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.

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.