View a markdown version of this page

Conditions préalables - Amazon Bedrock AgentCore
Exigences et cadres pris en chargeExigences relatives au SDK et à la CLIAutorisations IAM

Conditions préalables

Avant d'utiliser les fonctionnalités d' AgentCore optimisation, assurez-vous que les éléments suivants sont en place.

Exigences et cadres pris en charge

Les recommandations et A/B les tests ont les mêmes exigences relatives aux agents que les AgentCore évaluations :

  • Un agent déployé sur AgentCore Runtime avec l'observabilité activée, ou un agent créé avec un framework compatible configuré avec AgentCore Observability. Frameworks pris en charge :

    • Agents à mèches

    • LangGraph avec opentelemetry-instrumentation-langchain ou openinference-instrumentation-langchain

  • Recherche de transactions activée dans CloudWatch.

  • Sessions d'agent avec données de télémétrie dans les journaux. CloudWatch Appelez votre agent et attendez 2 à 5 minutes pour CloudWatch assimiler la télémétrie avant de lancer une recommandation ou un test. A/B

Exigences relatives au SDK et à la CLI

  • AgentCore CLI : installez la dernière version en exécutantagentcore update.

  • AWS SDK (boto3) : Python 3.10 ou version ultérieure. Installez ou mettez à niveau avecpip install --upgrade boto3.

  • AgentCore SDK : si vous utilisez lebedrock-agentcore-sdk-python, la version 1.8 ou ultérieure est requise.

Autorisations IAM

La politique IAM suivante accorde des autorisations pour les trois fonctionnalités d'optimisation :

{
    "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/*"
        }
    ]
}