本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用浏览器工具
<a name="browser-using-tool"></a>

## 创建 AgentCore 浏览器
<a name="browser-create"></a>

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

**Example**  

1.  **使用控制台创建浏览器工具 ** 

1. 在 [ https://console.aws.amazon.com/bedrock-agentcore/home \# 处打开 AgentCore 控制台](https://console.amazonaws.cn/bedrock-agentcore/home#)。

1. 在导航窗格中，选择**Built-in 工具**。

1. 选择 “**创建浏览器工具” **。

1. 提供唯一的**工具名称**和可选**描述**。

1. 在 “**网络设置” 下**，选择**允许访问公共互联网资源的公共网络**。

1. 在**会话录制下**，您可以启用将浏览器会话记录到 S3 存储桶以供日后查看。

1. 在 “**权限” 下**，指定 IAM 执行角色以定义浏览器工具可以访问的 Amazon 资源。

1. 选择**创建**。

1. 要使用 Amazon 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"
   ```

1. 要使用 Amazon 适用于 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"
         }
       }
   )
   ```

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 浏览器工具
<a name="browser-get"></a>

您可以在您的账户中获取有关浏览器工具的信息，并查看其详细信息、状态和配置。

**Example**  

1.  **使用控制台获取有关浏览器工具的信息 ** 

1. 在 [ https://console.aws.amazon.com/bedrock-agentcore/home \# 处打开 AgentCore 控制台](https://console.amazonaws.cn/bedrock-agentcore/home#)。

1. 在导航窗格中，选择**Built-in 工具**。

1. 浏览器工具**部分列出了**浏览器工具。

1. 您可以选择自己创建的工具来查看其详细信息，例如每个浏览器工具的名称、ID、状态和创建日期。

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

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

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

    **请求语法** 

   以下显示了请求语法：

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

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 浏览器工具
<a name="browser-list"></a>

您可以列出账户中的所有浏览器工具，以查看它们的详细信息、状态和配置。

**Example**  

1.  **使用控制台列出浏览器工具 ** 

1. 在 [ https://console.aws.amazon.com/bedrock-agentcore/home \# 处打开 AgentCore 控制台](https://console.amazonaws.cn/bedrock-agentcore/home#)。

1. 在导航窗格中，选择**Built-in 工具**。

1. 浏览器工具**部分列出了**浏览器工具。

1. 您可以查看每个浏览器工具的名称、ID、状态和创建日期等详细信息。

1. 要使用 Amazon 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>"
   ```

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

    **请求语法** 

   以下显示了请求语法：

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

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 浏览器
<a name="browser-delete"></a>

当您不再需要浏览器工具时，可以将其删除以释放资源。在删除浏览器工具之前，请确保停止与其关联的所有活动会话。

**Example**  

1.  **使用控制台删除浏览器工具 ** 

1. 在 [ https://console.aws.amazon.com/bedrock-agentcore/home \# 处打开 AgentCore 控制台](https://console.amazonaws.cn/bedrock-agentcore/home#)。

1. 导航到**Built-in 工具**并选择您的浏览器工具。

1. 从**操作**菜单中选择**删除**。

1. 在确认对话框中键入浏览器工具名称，确认删除。

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

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

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

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

    **请求语法** 

   以下显示了请求语法：

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

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>
   ```