ブラウザツールの使用

コンソールを使用してブラウザツールを作成するには

https://console.aws.amazon.com/bedrock-agentcore/home# で AgentCore コンソールを開きます。

ナビゲーションペインで、組み込みツールを選択します。

ブラウザツールの作成 を選択します。

一意のツール名とオプションの Description を指定します。

ネットワーク設定 で、パブリックインターネットリソースへのアクセスを許可するパブリックネットワークを選択します。

セッション記録 では、後で確認できるように S3 バケットへのブラウザセッションの記録を有効にできます。

アクセス許可 で、ブラウザツールがアクセスできる AWS リソースを定義する IAM 実行ロールを指定します。

[作成] を選択します。

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"

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 を使用して新しいブラウザインスタンスを作成するには、次の呼び出しを使用します。

# 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"
  }'

コンソールを使用してブラウザツールに関する情報を取得するには

https://console.aws.amazon.com/bedrock-agentcore/home# で AgentCore コンソールを開きます。

ナビゲーションペインで、組み込みツールを選択します。

ブラウザツールは、ブラウザツールセクションに記載されています。

作成したツールを選択して、各ブラウザツールの名前、ID、ステータス、作成日などの詳細を表示できます。

AWS CLI を使用してブラウザツールに関する情報を取得するには、 get-browser コマンドを使用します。

aws bedrock-agentcore-control get-browser \
  --region <Region> \
  --browser-id "<your-browser-id>"

AWS SDK for Python (Boto3) を使用してブラウザツールに関する情報を取得するには、 get_browserメソッドを使用します。

リクエストの構文

リクエスト構文を次に示します。

response = cp_client.get_browser(
    browserId="<your-browser-id>"
)

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>

コンソールを使用してブラウザツールを一覧表示するには

https://console.aws.amazon.com/bedrock-agentcore/home# で AgentCore コンソールを開きます。

ナビゲーションペインで、組み込みツールを選択します。

ブラウザツールは、ブラウザツールセクションに記載されています。

各ブラウザツールの名前、ID、ステータス、作成日などの詳細を表示できます。

CLI AWS を使用してブラウザツールを一覧表示するには、 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>"

AWS SDK for Python (Boto3) を使用してブラウザツールを一覧表示するには、 list_browsersメソッドを使用します。

リクエストの構文

リクエスト構文を次に示します。

response = cp_client.list_browsers(type="CUSTOM")

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>

コンソールを使用してブラウザツールを削除するには

https://console.aws.amazon.com/bedrock-agentcore/home# で AgentCore コンソールを開きます。

組み込みツールに移動し、ブラウザツールを選択します。

[Actions] (アクション) メニューから [Delete] (削除) を選択します。

確認ダイアログでブラウザツール名を入力して、削除を確認します。

[削除] を選択します。

AWS CLI を使用してブラウザツールを削除するには、 delete-browser コマンドを使用します。

aws bedrock-agentcore-control delete-browser \
  --region <Region> \
  --browser-id "<your-browser-id>"

AWS SDK for Python (Boto3) を使用してブラウザツールを削除するには、 delete_browserメソッドを使用します。

リクエストの構文

リクエスト構文を次に示します。

response = cp_client.delete_browser(
    browserId="<your-browser-id>"
    )

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>