View a markdown version of this page

Ressourcen- und Sitzungsmanagement - Amazon Grundgestein AgentCore

Ressourcen- und Sitzungsmanagement

Die folgenden Themen zeigen, wie der Amazon Bedrock AgentCore Code Interpreter funktioniert und wie Sie die Ressourcen erstellen und Sitzungen verwalten können.

IAM-Berechtigungen

Die folgende IAM-Richtlinie bietet die erforderlichen Berechtigungen für die Verwendung des Code Interpreters AgentCore :

{ "Version":"2012-10-17", "Statement": [ { "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:us-east-1:111122223333:code-interpreter/*" } ] }

Sie sollten der Ausführungsrolle außerdem die folgende Vertrauensrichtlinie hinzufügen:

{ "Version":"2012-10-17", "Statement": [{ "Sid": "BedrockAgentCoreBuiltInTools", "Effect": "Allow", "Principal": { "Service": "bedrock-agentcore.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:*" } } }] }

Funktionsweise

  1. Erstellen Sie einen Codeinterpreter

    Erstellen Sie Ihren eigenen Codeinterpreter oder verwenden Sie den System Code Interpreter, um Funktionen wie das Schreiben und Ausführen von Code oder das Durchführen komplexer Berechnungen zu aktivieren. Mit dem Code Interpreter können Sie die Laufzeit Ihrer Agenten erweitern, um Code in einer vollständig verwalteten Umgebung mit geringer Latenz sicher auszuführen.

  2. Integrieren Sie ihn in einen Agenten, um ihn aufzurufen

    Kopieren Sie die Ressourcen-ID des integrierten Tools in Ihren Runtime-Agent-Code, um ihn als Teil Ihrer Sitzung aufzurufen. Bei Code Interpreter-Tools können Sie Code ausführen und die Ergebnisse in Echtzeit anzeigen.

  3. Beurteilen Sie die Leistung mithilfe von Beobachtbarkeit

    Überwachen Sie die wichtigsten Kennzahlen für jedes Tool CloudWatch , um Einblicke in die Leistung in Echtzeit zu erhalten.

Einen Code-Interpreter erstellen und eine Sitzung starten

  1. Erstellen Sie einen Code-Interpreter

    Bei der Konfiguration eines Codeinterpreters können Sie Netzwerkeinstellungen (Sandbox oder Öffentlich) und die Ausführungsrolle wählen, die definiert, auf welche AWS Ressourcen der Codeinterpreter zugreifen kann.

  2. Starten Sie eine Sitzung.

    Der Codeinterpreter verwendet ein sitzungsbasiertes Modell. Nachdem Sie einen Codeinterpreter erstellt haben, starten Sie eine Sitzung mit einem konfigurierbaren Timeout-Zeitraum (Standard ist 15 Minuten). Sitzungen werden nach Ablauf des Timeouts automatisch beendet. Für einen einzelnen Codeinterpreter können mehrere Sitzungen gleichzeitig aktiv sein, wobei jede Sitzung ihren eigenen Status und ihre eigene Umgebung beibehält.

  3. Code ausführen

    In einer aktiven Sitzung können Sie Code in unterstützten Sprachen (Python, JavaScript, TypeScript) ausführen und den Status zwischen den Ausführungen beibehalten. Sie können auch upload/download Dateioperationen ausführen und die Unterstützung für die Shell-Befehle und AWS CLI-Befehle verwenden.

  4. Sitzung beenden und aufräumen

    Wenn Sie eine Sitzung nicht mehr verwenden, sollten Sie sie beenden, um Ressourcen freizusetzen und unnötige Kosten zu vermeiden. Sie können den Codeinterpreter auch löschen, wenn Sie ihn nicht mehr verwenden möchten.