View a markdown version of this page

AgentCore 코드 해석기 생성 - Amazon Bedrock AgentCore

AgentCore 코드 해석기 생성

Amazon Bedrock AgentCore 콘솔, AWS CLI 또는 AWS SDK를 사용하여 코드 해석기를 생성할 수 있습니다.

예
Console

  1. ====== 콘솔을 사용하여 코드 해석기를 생성하려면

  2. https://console.aws.amazon.com/bedrock-agentcore/home AgentCore 콘솔을 엽니다.

  3. 탐색 창에서 기본 제공 도구를 선택합니다.

  4. 코드 해석기 생성 도구를 선택합니다.

  5. 고유한 도구 이름과 선택적 설명을 제공합니다.

  6. 네트워크 설정에서 다음 옵션 중 하나를 선택합니다.

    • 샌드박스 - 외부 네트워크 액세스가 제한된 환경

    • 퍼블릭 네트워크 - 퍼블릭 인터넷 리소스에 대한 액세스 허용

  7. 권한에서 코드 해석기가 액세스할 수 있는 AWS 리소스를 정의하는 IAM 런타임 역할을 지정합니다.

  8. 생성(Create)을 선택합니다.

    Code Interpreter 도구를 생성하면 콘솔에 도구에 대한 중요한 세부 정보가 표시됩니다.

Tool Resource ARN

Code Interpreter 도구 리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예: arn:aws:bedrock-agentcore:<Region>:123456789012:code-interpreter/code-interpreter-custom).

Code Interpreter Tool ID

API 호출에 사용되는 Code Interpreter 도구의 고유 식별자입니다(예: code-interpreter-custom-abc123).

IAM Role

코드를 실행할 때 Code Interpreter가 수임하는 IAM 역할로, 액세스할 수 있는 AWS 리소스를 결정합니다.

Network Mode

코드 해석기(샌드박스 또는 퍼블릭)의 네트워크 구성입니다.

Creation Time

Code Interpreter 도구가 생성된 날짜와 시간입니다.

AWS CLI

  1. AWS CLI를 사용하여 코드 해석기를 생성하려면 create-code-interpreter 명령을 사용합니다.

    aws bedrock-agentcore create-code-interpreter \
  --region <Region> \
  --name "my-code-interpreter" \
  --description "My Code Interpreter for data analysis" \
  --network-configuration '{
    "networkMode": "PUBLIC"
  }' \
  --execution-role-arn "arn:aws:iam::123456789012:role/my-execution-role"
Boto3

  1. AWS SDK for Python을 사용하여 코드 해석기를 생성하려면 create_code_interpreter 메서드를 사용합니다.

    import boto3

# Initialize the boto3 client
cp_client = boto3.client(
    'bedrock-agentcore-control',
    region_name="<Region>",
    endpoint_url="https://bedrock-agentcore-control.<Region>.amazonaws.com"
)

# Create a Code Interpreter
response = cp_client.create_code_interpreter(
    name="myTestSandbox1",
    description="Test code sandbox for development",
    executionRoleArn="arn:aws:iam::123456789012:role/my-execution-role",
    networkConfiguration={
        "networkMode": "PUBLIC"
    }
)

# Print the Code Interpreter ID
code_interpreter_id = response["codeInterpreterId"]
print(f"Code Interpreter ID: {code_interpreter_id}")
API

  1. API를 사용하여 새 Code Interpreter 인스턴스를 생성하려면 다음 호출을 사용합니다.

    # Using awscurl
awscurl -X PUT "https://bedrock-agentcore-control.<Region>.amazonaws.com/code-interpreters" \
-H "Content-Type: application/json" \
--region <Region> \
--service bedrock-agentcore \
-d '{
    "name": "codeinterpreter'$(date +%m%d%H%M%S)'",
    "description": "Test code sandbox for development",
    "executionRoleArn": "'${ROLE_ARN}'",
    "networkConfiguration": {
        "networkMode": "PUBLIC"
    }
}'