View a markdown version of this page

先决条件 - Amazon Bedrock AgentCore
要求和支持的框架软件开发工具包和 CLI 要求IAM 权限

先决条件

在使用 AgentCore 优化功能之前，请确保以下内容准备就绪。

要求和支持的框架

建议和 A/B 测试的代理要求与 AgentCore 评估相同：

  • 在 AgentCore Runtime 上部署且启用了可观察性的代理，或者使用配置了可AgentCore 观察性的受支持框架构建的代理。支持的框架：

    • Strands Agents

    • LangGraph 用opentelemetry-instrumentation-langchain或 openinference-instrumentation-langchain

  • 已在中启用@@ 交易搜索 CloudWatch。

  • CloudWatch 日志中包含遥测数据的代理会话。调用您的代理并等待 2-5 分钟 CloudWatch 以获取遥测数据，然后再开始推荐或测试。 A/B

软件开发工具包和 CLI 要求

  • AgentCore CLI：通过运行安装最新版本agentcore update。

  • AWS SDK (boto3)：Python 3.10 或更高版本。使用安装或升级pip install --upgrade boto3。

  • AgentCore SDK：如果使用bedrock-agentcore-sdk-python，则需要版本 1.8 或更高版本。

IAM 权限

以下 IAM 策略授予所有三种优化功能的权限：

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