View a markdown version of this page

AgentCore 코드 해석기 시작하기 - Amazon Bedrock AgentCore
사전 조건보안 인증 정보 구성

AgentCore 코드 해석기 시작하기

AgentCore 코드 해석기를 사용하면 에이전트가 안전한 관리형 환경에서 Python 코드를 실행할 수 있습니다. 에이전트는 코드 실행을 통해 계산을 수행하고, 데이터를 분석하고, 시각화를 생성하고, 답변을 검증할 수 있습니다.

이 페이지에서는 사전 조건을 다루고 시작하기 위한 두 가지 접근 방식을 제공합니다.

  • AWS Strands 사용 - 기본 제공 도구 통합, 대화 관리 및 자동 세션 처리를 통해 AI 에이전트 구축을 간소화하는 상위 수준 에이전트 프레임워크입니다.

  • 직접 사용 - 사용자 지정 구현을 위한 세션 관리 및 코드 실행을 더 잘 제어할 수 있는 SDK 및 Boto3 접근 방식입니다.

주제

사전 조건

시작하기 전에 다음을 갖추어야 합니다.

보안 인증 정보 구성

다음 단계를 수행하여 AWS 자격 증명을 구성하고 필요한 권한을 연결합니다.

  1. 자격 AWS 증명 확인

    자격 AWS 증명이 구성되어 있는지 확인합니다.

    aws sts get-caller-identity
    참고

    필요한 권한을 연결할 때 사용할 것이므로 여기에 반환된 사용자 또는 자격 증명을 기록해 둡니다.

    이 명령이 실패하면 자격 증명을 구성합니다. 자세한 내용은 AWS CLI의 구성 및 자격 증명 파일 설정을 참조하세요.

  2. 필요한 권한 연결

    IAM 사용자 또는 역할에는 AgentCore 코드 해석기를 사용할 수 있는 권한이 필요합니다. 이 정책을 IAM 자격 증명에 연결합니다.

    참고

    <region>를 선택한 리전(예: us-west-2 )으로 바꾸고 아래 정책에서 AWS 계정 ID<account_id>로 바꿉니다.

    {
    "Version":"2012-10-17",	
    "Statement": [
        {
            "Sid": "BedrockAgentCoreCodeInterpreterFullAccess",
            "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:<region>:++<account_id>++:code-interpreter/*"
        }
    ]
}

이 정책을 연결하려면

다음 단계를 따릅니다.

  1. IAM 콘솔로 이동합니다.

  2. get-caller-identity API 작업에 대해 반환된 응답에서 사용자 또는 역할을 찾습니다.

  3. 권한 추가를 선택한 다음 인라인 정책 생성을 선택합니다.

  4. JSON 보기로 전환하고 위의 정책을 붙여넣습니다.

  5. 이름 지정 AgentCoreCodeInterpreterAccess 및 저장

참고

Amazon Bedrock AgentCore 런타임에 에이전트를 배포하는 경우 서비스 신뢰 정책을 사용하여 IAM 실행 역할도 생성해야 합니다. 자세한 내용은 AgentCore 런타임 시작하기를 참조하세요.

다음 섹션에서는 에이전트 프레임워크를 사용하거나 사용하지 않고 Amazon Bedrock AgentCore 코드 인터프리터를 사용하는 방법을 보여줍니다. 에이전트 프레임워크 없이 코드 해석기를 직접 사용하면 특정 코드 조각을 프로그래밍 방식으로 실행하려는 경우에 특히 유용합니다.