创建 AgentCore 浏览器获取 AgentCore 浏览器工具清单 AgentCore 浏览器工具删除 AgentCore 浏览器

使用浏览器工具

创建 AgentCore 浏览器

您可以使用亚马逊 Bedrock AgentCore 控制台、 AWS CLI 或 AWS SDK 创建浏览器工具。

例

Console

使用控制台创建浏览器工具
在 https://console.aws.amazon.com/bedrock-agentcore/home # 处打开 AgentCore 控制台。
在导航窗格中，选择Built-in 工具。
选择 “创建浏览器工具” 。
提供唯一的工具名称和可选描述。
在 “网络设置” 下，选择允许访问公共互联网资源的公共网络。
在会话录制下，您可以启用将浏览器会话记录到 S3 存储桶以供日后查看。
在 “权限” 下，指定 IAM 执行角色以定义浏览器工具可以访问的 AWS 资源。
选择创建。

AWS CLI

要使用 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

要使用 AWS 适用于 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

要使用 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

使用控制台获取有关浏览器工具的信息
在 https://console.aws.amazon.com/bedrock-agentcore/home # 处打开 AgentCore 控制台。
在导航窗格中，选择Built-in 工具。
浏览器工具部分列出了浏览器工具。
您可以选择自己创建的工具来查看其详细信息，例如每个浏览器工具的名称、ID、状态和创建日期。

AWS CLI

要使用 AWS CLI 获取有关浏览器工具的信息，请使用以下get-browser命令：


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

Boto3

要使用 AWS 适用于 Python 的 SDK (Boto3) 获取有关浏览器工具的信息，请使用以下get_browser方法：

请求语法

以下显示了请求语法：
```
response = cp_client.get_browser(
    browserId="<your-browser-id>"
)
```

API

要使用 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

使用控制台列出浏览器工具
在 https://console.aws.amazon.com/bedrock-agentcore/home # 处打开 AgentCore 控制台。
在导航窗格中，选择Built-in 工具。
浏览器工具部分列出了浏览器工具。
您可以查看每个浏览器工具的名称、ID、状态和创建日期等详细信息。

AWS CLI

要使用 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

要列出使用 Python AWS 开发工具包 (Boto3) 的浏览器工具，请使用以下list_browsers方法：

请求语法

以下显示了请求语法：
```
response = cp_client.list_browsers(type="CUSTOM")
```

API

要使用 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

使用控制台删除浏览器工具
在 https://console.aws.amazon.com/bedrock-agentcore/home # 处打开 AgentCore 控制台。
导航到Built-in 工具并选择您的浏览器工具。
从操作菜单中选择删除。
在确认对话框中键入浏览器工具名称，确认删除。
选择删除。

注意
您无法删除具有活动会话的浏览器工具。在尝试删除该工具之前，请停止所有会话。

AWS CLI

要使用 AWS CLI 删除浏览器工具，请使用以下delete-browser命令：


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

Boto3

要使用 AWS 适用于 Python 的软件开发工具包 (Boto3) 删除浏览器工具，请使用以下delete_browser方法：

请求语法

以下显示了请求语法：
```
response = cp_client.delete_browser(
    browserId="<your-browser-id>"
    )
```

API

要使用 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>

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

基础知识

管理浏览器会话

使用浏览器工具

创建 AgentCore 浏览器

例

获取 AgentCore 浏览器工具

例

清单 AgentCore 浏览器工具

例

删除 AgentCore 浏览器

例

注意