View a markdown version of this page

브라우저 도구 사용 - 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. 세션 레코딩에서 나중에 검토할 수 있도록 S3 버킷에 대한 브라우저 세션 레코딩을 활성화할 수 있습니다.

  8. 권한에서 브라우저 도구가 액세스할 수 있는 AWS 리소스를 정의하는 IAM 실행 역할을 지정합니다.

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

AWS CLI
  1. AWS CLI를 사용하여 브라우저 도구를 생성하려면 create-browser 명령을 사용합니다.

    aws bedrock-agentcore-control create-browser \ --region <Region> \ --name "my-browser" \ --description "My browser for web interaction" \ --network-configuration '{ "networkMode": "PUBLIC" }' \ --recording '{ "enabled": true, "s3Location": { "bucket": "my-bucket-name", "prefix": "sessionreplay" } }' \ --execution-role-arn "arn:aws:iam::123456789012:role/my-execution-role"
Boto3
  1. AWS SDK for Python(Boto3)을 사용하여 브라우저 도구를 생성하려면 create_browser 메서드를 사용합니다.

    요청 구문

    다음은 요청 구문을 보여줍니다.

    response = cp_client.create_browser( name="my_custom_browser", description="Test browser for development", networkConfiguration={ "networkMode": "PUBLIC" }, executionRoleArn="arn:aws:iam::123456789012:role/Sessionreplay", clientToken=str(uuid.uuid4()), recording={ "enabled": True, "s3Location": { "bucket": "session-record-123456789012", "prefix": "replay-data" } } )
API
  1. API를 사용하여 새 브라우저 인스턴스를 생성하려면 다음 호출을 사용합니다.

    # Using awscurl awscurl -X PUT \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region> \ -d '{ "name": "test_browser_1", "description": "Test sandbox for development", "networkConfiguration": { "networkMode": "PUBLIC" }, "recording": { "enabled": true, "s3Location": { "bucket": "<your-bucket-name>", "prefix": "sessionreplay" } }, "executionRoleArn": "arn:aws:iam::123456789012:role/my-execution-role" }'

AgentCore 브라우저 도구 가져오기

계정에서 브라우저 도구에 대한 정보를 가져오고 세부 정보, 상태 및 구성을 볼 수 있습니다.

Console
  1. 콘솔을 사용하여 브라우저 도구에 대한 정보를 가져오려면

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

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

  4. 브라우저 도구는 브라우저 도구 섹션에 나열되어 있습니다.

  5. 생성한 도구를 선택하여 각 브라우저 도구의 이름, ID, 상태 및 생성 날짜와 같은 세부 정보를 볼 수 있습니다.

AWS CLI
  1. AWS CLI를 사용하여 브라우저 도구에 대한 정보를 가져오려면 get-browser 명령을 사용합니다.

    aws bedrock-agentcore-control get-browser \ --region <Region> \ --browser-id "<your-browser-id>"
Boto3
  1. AWS SDK for Python(Boto3)을 사용하여 브라우저 도구에 대한 정보를 가져오려면 get_browser 메서드를 사용합니다.

    요청 구문

    다음은 요청 구문을 보여줍니다.

    response = cp_client.get_browser( browserId="<your-browser-id>" )
API
  1. API를 사용하여 브라우저 도구를 가져오려면 다음 호출을 사용합니다.

    # Using awscurl awscurl -X GET \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers/<your-browser-id>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region>

AgentCore 브라우저 도구 나열

계정의 모든 브라우저 도구를 나열하여 세부 정보, 상태 및 구성을 볼 수 있습니다.

Console
  1. 콘솔을 사용하여 브라우저 도구를 나열하려면

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

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

  4. 브라우저 도구는 브라우저 도구 섹션에 나열되어 있습니다.

  5. 각 브라우저 도구의 이름, ID, 상태 및 생성 날짜와 같은 세부 정보를 볼 수 있습니다.

AWS CLI
  1. AWS CLI를 사용하여 브라우저 도구를 나열하려면 list-browsers 명령을 사용합니다.

    aws bedrock-agentcore-control list-browsers \ --region <Region>

    유형별로 결과를 필터링할 수 있습니다.

    aws bedrock-agentcore-control list-browsers \ --region <Region> \ --type SYSTEM

    결과 수를 제한하고 페이지 매김을 사용할 수도 있습니다.

    aws bedrock-agentcore-control list-browsers \ --region <Region> \ --max-results 10 \ --next-token "<your-pagination-token>"
Boto3
  1. AWS SDK for Python(Boto3)을 사용하여 브라우저 도구를 나열하려면 list_browsers 메서드를 사용합니다.

    요청 구문

    다음은 요청 구문을 보여줍니다.

    response = cp_client.list_browsers(type="CUSTOM")
API
  1. API를 사용하여 브라우저 도구를 나열하려면 다음 호출을 사용합니다.

    # Using awscurl awscurl -X POST \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region>

    유형별로 결과를 필터링할 수 있습니다.

    awscurl -X POST \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers?type=SYSTEM" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region>

    결과 수를 제한하고 페이지 매김을 사용할 수도 있습니다.

    awscurl -X POST \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers?maxResults=1&nextToken=<your-pagination-token>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore \ --region <Region>

AgentCore 브라우저 삭제

브라우저 도구가 더 이상 필요하지 않으면 삭제하여 리소스를 확보할 수 있습니다. 브라우저 도구를 삭제하기 전에 연결된 모든 활성 세션을 중지해야 합니다.

Console
  1. 콘솔을 사용하여 브라우저 도구를 삭제하려면

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

  3. 기본 제공 도구로 이동하여 브라우저 도구를 선택합니다.

  4. 작업 메뉴에서 삭제를 선택합니다.

  5. 확인 대화 상자에 브라우저 도구 이름을 입력하여 삭제를 확인합니다.

  6. 삭제를 선택합니다.

    참고

    활성 세션이 있는 브라우저 도구는 삭제할 수 없습니다. 도구를 삭제하기 전에 모든 세션을 중지합니다.

AWS CLI
  1. AWS CLI를 사용하여 브라우저 도구를 삭제하려면 delete-browser 명령을 사용합니다.

    aws bedrock-agentcore-control delete-browser \ --region <Region> \ --browser-id "<your-browser-id>"
Boto3
  1. AWS SDK for Python(Boto3)을 사용하여 브라우저 도구를 삭제하려면 delete_browser 메서드를 사용합니다.

    요청 구문

    다음은 요청 구문을 보여줍니다.

    response = cp_client.delete_browser( browserId="<your-browser-id>" )
API
  1. API를 사용하여 브라우저 도구를 삭제하려면 다음 호출을 사용합니다.

    # Using awscurl awscurl -X DELETE \ "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers/<your-browser-id>" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ --service bedrock-agentcore-control \ --region <Region>