View a markdown version of this page

리소스 및 세션 관리 - Amazon Bedrock AgentCore
IAM 권한작동 방식코드 인터프리터 생성 및 세션 시작

리소스 및 세션 관리

다음 주제에서는 Amazon Bedrock AgentCore 코드 인터프리터의 작동 방식과 리소스를 생성하고 세션을 관리하는 방법을 보여줍니다.

주제

IAM 권한

다음 IAM 정책은 AgentCore 코드 해석기를 사용하는 데 필요한 권한을 제공합니다.

{
"Version":"2012-10-17",
    "Statement": [
        {
            "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:us-east-1:111122223333:code-interpreter/*"
        }
    ]
}

또한 실행 역할에 다음 신뢰 정책을 추가해야 합니다.

{
"Version":"2012-10-17",
    "Statement": [{
        "Sid": "BedrockAgentCoreBuiltInTools",
        "Effect": "Allow",
        "Principal": {
            "Service": "bedrock-agentcore.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
                "aws:SourceAccount": "111122223333"
            },
            "ArnLike": {
                "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:*"
            }
        }
    }]
}

작동 방식

  1. 코드 해석기 생성

    자체 코드 인터프리터를 빌드하거나 시스템 코드 인터프리터를 사용하여 코드 작성 및 실행 또는 복잡한 계산 수행과 같은 기능을 활성화합니다. Code Interpreter를 사용하면 에이전트 런타임을 보강하여 지연 시간이 짧은 완전 관리형 환경에서 코드를 안전하게 실행할 수 있습니다.

  2. 에이전트 내에 통합하여 호출

    기본 제공 도구 리소스 ID를 런타임 에이전트 코드에 복사하여 세션의 일부로 호출합니다. Code Interpreter 도구의 경우 코드를 실행하고 결과를 실시간으로 볼 수 있습니다.

  3. 관찰성을 사용하여 성능 평가

    CloudWatch의 각 도구에 대한 주요 지표를 모니터링하여 실시간 성능 인사이트를 얻습니다.

코드 인터프리터 생성 및 세션 시작

  1. 코드 해석기 생성

    코드 해석기를 구성할 때 네트워크 설정(샌드박스 또는 퍼블릭)과 코드 해석기가 액세스할 수 있는 AWS 리소스를 정의하는 실행 역할 역할을 선택할 수 있습니다.

  2. 세션 시작

    Code Interpreter는 세션 기반 모델을 사용합니다. 코드 인터프리터를 생성한 후 구성 가능한 제한 시간(기본값은 15분)으로 세션을 시작합니다. 세션은 제한 시간 이후에 자동으로 종료됩니다. 단일 코드 인터프리터에 대해 여러 세션을 동시에 활성화할 수 있으며 각 세션은 자체 상태 및 환경을 유지합니다.

  3. 코드 실행

    활성 세션 내에서 지원되는 언어(Python, JavaScript, TypeScript)로 코드를 실행하고 실행 간 상태를 유지할 수 있습니다. 파일 업로드/다운로드 작업을 수행하고 셸 명령 및 AWS CLI 명령에 대해 제공된 지원을 사용할 수도 있습니다.

  4. 세션 중지 및 정리

    세션 사용을 마치면 세션을 중지하여 리소스를 해제하고 불필요한 요금을 방지해야 합니다. 더 이상 사용하지 않으려는 경우 코드 인터프리터를 삭제할 수도 있습니다.