AWS bedrock-agentcore documentation change
Summary
Updated documentation formatting and structure for the Browser Tool guide, including adding 'Example' headings, renumbering procedural steps, changing heading styles, and repositioning a note about deleting tools with active sessions.
Security assessment
The changes are purely structural and formatting updates to improve documentation clarity and consistency. There is no mention of security vulnerabilities, patches, or new security features. The note about not deleting a tool with active sessions is a standard operational warning, not evidence of a security issue.
Diff
diff --git a/bedrock-agentcore/latest/devguide/browser-using-tool.md b/bedrock-agentcore/latest/devguide/browser-using-tool.md index 05d7f49b2..06cc66496 100644 --- a//bedrock-agentcore/latest/devguide/browser-using-tool.md +++ b//bedrock-agentcore/latest/devguide/browser-using-tool.md @@ -12,0 +13,2 @@ You can create a Browser Tool using the Amazon Bedrock AgentCore console, AWS CL +###### Example + @@ -16 +18 @@ Console -###### To create a Browser Tool using the console + 1. **To create a Browser Tool using the console** @@ -18 +20 @@ Console - 1. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/home#](https://console.aws.amazon.com/bedrock-agentcore/home#). + 2. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/home#](https://console.aws.amazon.com/bedrock-agentcore/home#). @@ -20 +22 @@ Console - 2. In the navigation pane, choose **Built-in tools**. + 3. In the navigation pane, choose **Built-in tools**. @@ -22 +24 @@ Console - 3. Choose **Create browser tool**. + 4. Choose **Create browser tool**. @@ -24 +26 @@ Console - 4. Provide a unique **Tool name** and optional **Description**. + 5. Provide a unique **Tool name** and optional **Description**. @@ -26 +28 @@ Console - 5. Under **Network settings** , choose **Public network** which allows access to public internet resources. + 6. Under **Network settings** , choose **Public network** which allows access to public internet resources. @@ -28 +30 @@ Console - 6. Under **Session recording** , you can enable recording of browser sessions to an S3 bucket for later review. + 7. Under **Session recording** , you can enable recording of browser sessions to an S3 bucket for later review. @@ -30 +32 @@ Console - 7. Under **Permissions** , specify an IAM execution role that defines what AWS resources the Browser Tool can access. + 8. Under **Permissions** , specify an IAM execution role that defines what AWS resources the Browser Tool can access. @@ -32 +34 @@ Console - 8. Choose **Create**. + 9. Choose **Create**. @@ -40,2 +42 @@ AWS CLI -To create a Browser Tool using the AWS CLI, use the `create-browser` command: - + 1. To create a Browser Tool using the AWS CLI, use the `create-browser` command: @@ -63 +66 @@ Boto3 -To create a Browser Tool using the AWS SDK for Python (Boto3), use the `create_browser` method: + 1. To create a Browser Tool using the AWS SDK for Python (Boto3), use the `create_browser` method: @@ -65 +68 @@ To create a Browser Tool using the AWS SDK for Python (Boto3), use the `create_b -###### Request Syntax +**Request Syntax** @@ -88 +89,0 @@ The following shows the request syntax: -API @@ -91 +92 @@ API -To create a new browser instance using the API, use the following call: +API @@ -93,0 +95,2 @@ To create a new browser instance using the API, use the following call: + 1. To create a new browser instance using the API, use the following call: + @@ -121,0 +127,2 @@ You can get information about the Browser tool in your account and view their de +###### Example + @@ -125 +132 @@ Console -###### To get information about the Browser tool using the console + 1. **To get information about the Browser tool using the console** @@ -127 +134 @@ Console - 1. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/home#](https://console.aws.amazon.com/bedrock-agentcore/home#). + 2. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/home#](https://console.aws.amazon.com/bedrock-agentcore/home#). @@ -129 +136 @@ Console - 2. In the navigation pane, choose **Built-in tools**. + 3. In the navigation pane, choose **Built-in tools**. @@ -131 +138 @@ Console - 3. The browser tools are listed in the **Browser tools** section. + 4. The browser tools are listed in the **Browser tools** section. @@ -133 +140 @@ Console - 4. You can choose a tool that you created to view it's details such as name, ID, status, and creation date for each browser tool. + 5. You can choose a tool that you created to view it’s details such as name, ID, status, and creation date for each browser tool. @@ -141,2 +148 @@ AWS CLI -To get information about a Browser tool using the AWS CLI, use the `get-browser` command: - + 1. To get information about a Browser tool using the AWS CLI, use the `get-browser` command: @@ -152 +160 @@ Boto3 -To get information about the Browser tool using the AWS SDK for Python (Boto3), use the `get_browser` method: + 1. To get information about the Browser tool using the AWS SDK for Python (Boto3), use the `get_browser` method: @@ -154 +162 @@ To get information about the Browser tool using the AWS SDK for Python (Boto3), -###### Request Syntax +**Request Syntax** @@ -164 +170,0 @@ The following shows the request syntax: -API @@ -167 +173 @@ API -To get the browser tool using the API, use the following call: +API @@ -169,0 +176,2 @@ To get the browser tool using the API, use the following call: + 1. To get the browser tool using the API, use the following call: + @@ -182,0 +193,2 @@ You can list all browser tools in your account to view their details, status, an +###### Example + @@ -186 +198 @@ Console -###### To list browser tools using the console + 1. **To list browser tools using the console** @@ -188 +200 @@ Console - 1. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/home#](https://console.aws.amazon.com/bedrock-agentcore/home#). + 2. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/home#](https://console.aws.amazon.com/bedrock-agentcore/home#). @@ -190 +202 @@ Console - 2. In the navigation pane, choose **Built-in tools**. + 3. In the navigation pane, choose **Built-in tools**. @@ -192 +204 @@ Console - 3. The browser tools are listed in the **Browser tools** section. + 4. The browser tools are listed in the **Browser tools** section. @@ -194 +206 @@ Console - 4. You can view details such as name, ID, status, and creation date for each browser tool. + 5. You can view details such as name, ID, status, and creation date for each browser tool. @@ -202,2 +214 @@ AWS CLI -To list browser tools using the AWS CLI, use the `list-browsers` command: - + 1. To list browser tools using the AWS CLI, use the `list-browsers` command: @@ -229 +238 @@ Boto3 -To list browser tools using the AWS SDK for Python (Boto3), use the `list_browsers` method: + 1. To list browser tools using the AWS SDK for Python (Boto3), use the `list_browsers` method: @@ -231 +240 @@ To list browser tools using the AWS SDK for Python (Boto3), use the `list_browse -###### Request Syntax +**Request Syntax** @@ -239 +246,0 @@ The following shows the request syntax: -API @@ -242 +249,2 @@ API -To list browser tools using the API, use the following call: +API + @@ -243,0 +252 @@ To list browser tools using the API, use the following call: + 1. To list browser tools using the API, use the following call: @@ -279,0 +287,2 @@ When you no longer need a browser tool, you can delete it to free up resources. +###### Example + @@ -283 +292 @@ Console -###### To delete a Browser tool using the console + 1. **To delete a Browser tool using the console** @@ -285 +294 @@ Console - 1. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/home#](https://console.aws.amazon.com/bedrock-agentcore/home#). + 2. Open the AgentCore console at [https://console.aws.amazon.com/bedrock-agentcore/home#](https://console.aws.amazon.com/bedrock-agentcore/home#). @@ -287 +296 @@ Console - 2. Navigate to **Built-in tools** and select your browser tool. + 3. Navigate to **Built-in tools** and select your browser tool. @@ -289 +298 @@ Console - 3. Choose **Delete** from the **Actions** menu. + 4. Choose **Delete** from the **Actions** menu. @@ -291 +300 @@ Console - 4. Confirm the deletion by typing the browser tool name in the confirmation dialog. + 5. Confirm the deletion by typing the browser tool name in the confirmation dialog. @@ -293 +302 @@ Console - 5. Choose **Delete**. + 6. Choose **Delete**. @@ -294,0 +304 @@ Console +###### Note @@ -295,0 +306 @@ Console +You cannot delete a browser tool that has active sessions. Stop all sessions before attempting to delete the tool. @@ -298 +308,0 @@ Console -###### Note @@ -300 +309,0 @@ Console -You cannot delete a browser tool that has active sessions. Stop all sessions before attempting to delete the tool. @@ -305,2 +314 @@ AWS CLI -To delete a Browser tool using the AWS CLI, use the `delete-browser` command: - + 1. To delete a Browser tool using the AWS CLI, use the `delete-browser` command: @@ -316 +326 @@ Boto3 -To delete a Browser tool using the AWS SDK for Python (Boto3), use the `delete_browser` method: + 1. To delete a Browser tool using the AWS SDK for Python (Boto3), use the `delete_browser` method: @@ -318 +328 @@ To delete a Browser tool using the AWS SDK for Python (Boto3), use the `delete_b -###### Request Syntax +**Request Syntax** @@ -328 +336,0 @@ The following shows the request syntax: -API @@ -331 +339,2 @@ API -To delete a browser tool using the API, use the following call: +API + @@ -332,0 +342 @@ To delete a browser tool using the API, use the following call: + 1. To delete a browser tool using the API, use the following call: