View a markdown version of this page

Voraussetzungen - Amazon Grundgestein AgentCore
Anforderungen und unterstützte FrameworksSDK- und CLI-AnforderungenIAM-Berechtigungen

Voraussetzungen

Bevor Sie AgentCore Optimierungsfunktionen verwenden, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind.

Anforderungen und unterstützte Frameworks

Für Empfehlungen und A/B Tests gelten dieselben Agentenanforderungen wie für AgentCore Evaluierungen:

  • Ein auf AgentCore Runtime bereitgestellter Agent mit aktivierter Observability oder ein Agent, der mit einem unterstützten Framework erstellt wurde, das mit AgentCore Observability konfiguriert ist. Unterstützte Frameworks:

    • Strands, Agenten

    • LangGraph mit opentelemetry-instrumentation-langchain oder openinference-instrumentation-langchain

  • Transaktionssuche aktiviert in CloudWatch.

  • Agentensitzungen mit Telemetriedaten in CloudWatch Protokollen. Rufen Sie Ihren Agenten auf und warten Sie 2—5 Minuten, bis die Telemetriedaten CloudWatch aufgenommen wurden, bevor Sie eine Empfehlung oder einen Test starten. A/B

SDK- und CLI-Anforderungen

  • AgentCore CLI: Installieren Sie die neueste Version, indem Sie sie ausführenagentcore update.

  • AWS SDK (boto3): Python 3.10 oder höher. Installieren oder aktualisieren Sie mit. pip install --upgrade boto3

  • AgentCore SDK: Wenn Sie das verwendenbedrock-agentcore-sdk-python, ist Version 1.8 oder höher erforderlich.

IAM-Berechtigungen

Die folgende IAM-Richtlinie gewährt Berechtigungen für alle drei Optimierungsfunktionen:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ConfigurationBundles",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateConfigurationBundle",
                "bedrock-agentcore:GetConfigurationBundle",
                "bedrock-agentcore:GetConfigurationBundleVersion",
                "bedrock-agentcore:ListConfigurationBundles",
                "bedrock-agentcore:ListConfigurationBundleVersions",
                "bedrock-agentcore:UpdateConfigurationBundle",
                "bedrock-agentcore:DeleteConfigurationBundle"
            ],
            "Resource": "arn:aws:bedrock-agentcore:*:*:configuration-bundle/*"
        },
        {
            "Sid": "Recommendations",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:StartRecommendation",
                "bedrock-agentcore:GetRecommendation",
                "bedrock-agentcore:ListRecommendations",
                "bedrock-agentcore:DeleteRecommendation"
            ],
            "Resource": "arn:aws:bedrock-agentcore:*:*:recommendation/*"
        },
        {
            "Sid": "ABTesting",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateABTest",
                "bedrock-agentcore:GetABTest",
                "bedrock-agentcore:ListABTests",
                "bedrock-agentcore:UpdateABTest",
                "bedrock-agentcore:DeleteABTest"
            ],
            "Resource": "arn:aws:bedrock-agentcore:*:*:ab-test/*"
        },
        {
            "Sid": "CloudWatchLogs",
            "Effect": "Allow",
            "Action": [
                "logs:GetLogEvents",
                "logs:FilterLogEvents",
                "logs:StartQuery",
                "logs:GetQueryResults"
            ],
            "Resource": "arn:aws:logs:*:*:log-group:/aws/bedrock-agentcore/runtimes/*"
        }
    ]
}