使用瀏覽器工具

使用主控台建立瀏覽器工具

在 https：//# 開啟 AgentCore 主控台。 https://console.aws.amazon.com/bedrock-agentcore/home

在導覽窗格中，選擇內建工具。

選擇建立瀏覽器工具。

提供唯一的工具名稱和選用的描述。

在網路設定 下，選擇允許存取公有網際網路資源的公有網路。

在工作階段記錄 下，您可以啟用將瀏覽器工作階段記錄到 S3 儲存貯體以供日後檢閱。

在許可 下，指定 IAM 執行角色，以定義瀏覽器工具可存取 AWS 的資源。

選擇建立。

若要使用 CLI AWS 建立瀏覽器工具，請使用 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"

若要使用適用於 Python 的 AWS SDK (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：//# 開啟 AgentCore 主控台。 https://console.aws.amazon.com/bedrock-agentcore/home

在導覽窗格中，選擇內建工具。

瀏覽器工具列在瀏覽器工具區段中。

您可以選擇您建立的工具，以檢視其詳細資訊，例如每個瀏覽器工具的名稱、ID、狀態和建立日期。

若要使用 CLI AWS 取得瀏覽器工具的相關資訊，請使用 get-browser命令：

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

若要使用適用於 Python 的 AWS SDK (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：//# 開啟 AgentCore 主控台。 https://console.aws.amazon.com/bedrock-agentcore/home

在導覽窗格中，選擇內建工具。

瀏覽器工具列在瀏覽器工具區段中。

您可以檢視每個瀏覽器工具的名稱、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>"

若要使用適用於 Python 的 AWS SDK (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：//# 開啟 AgentCore 主控台。 https://console.aws.amazon.com/bedrock-agentcore/home

導覽至內建工具，然後選取您的瀏覽器工具。

在動作功能表中，選擇刪除。

在確認對話方塊中輸入瀏覽器工具名稱來確認刪除。

選擇 刪除。

若要使用 CLI AWS 刪除瀏覽器工具，請使用 delete-browser命令：

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

若要使用適用於 Python 的 AWS SDK (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>