View a markdown version of this page

사전 조건 - Amazon Bedrock AgentCore
요구 사항 및 지원되는 프레임워크SDK 및 CLI 요구 사항IAM 권한

사전 조건

AgentCore 최적화 기능을 사용하기 전에 다음 사항이 있는지 확인합니다.

요구 사항 및 지원되는 프레임워크

권장 사항 및 A/B 테스트에는 AgentCore 평가와 동일한 에이전트 요구 사항이 있습니다.

  • 관찰성이 활성화된 AgentCore 런타임에 배포된 에이전트 또는 AgentCore 관찰성으로 구성된 지원되는 프레임워크로 구축된 에이전트. 지원되는 프레임워크:

    • Strands Agents

    • opentelemetry-instrumentation-langchain 또는를 사용한 LangGraph openinference-instrumentation-langchain

  • CloudWatch에서 트랜잭션 검색이 활성화되었습니다.

  • CloudWatch Logs의 원격 측정 데이터가 포함된 에이전트 세션. 에이전트를 호출하고 CloudWatch가 원격 측정을 수집할 때까지 2~5분 기다린 후 권장 사항 또는 A/B 테스트를 시작합니다.

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