AWS bedrock-agentcore documentation change
Summary
Updated documentation formatting and structure for browser session management, including adding example sections, adjusting headings, reformatting code blocks, and adding reference to InvokeBrowser API for OS-level control.
Security assessment
The changes are primarily formatting improvements (adding example sections, adjusting markdown headings, reformatting code blocks, and step numbering). The only security-related content is a minor typo fix in an existing sentence about disabling automation for sensitive information entry. There is no evidence of addressing a specific security vulnerability or incident.
Diff
diff --git a/bedrock-agentcore/latest/devguide/browser-managing-sessions.md b/bedrock-agentcore/latest/devguide/browser-managing-sessions.md index 2510618f3..7baf86f88 100644 --- a//bedrock-agentcore/latest/devguide/browser-managing-sessions.md +++ b//bedrock-agentcore/latest/devguide/browser-managing-sessions.md @@ -13 +13 @@ After creating a browser, you can start a session to interact with web applicati -AWS CLI +###### Example @@ -14,0 +15 @@ AWS CLI +AWS CLI @@ -16 +16,0 @@ AWS CLI -To start a Browser session using the AWS CLI, use the `start-browser-session` command: @@ -17,0 +18 @@ To start a Browser session using the AWS CLI, use the `start-browser-session` co + 1. To start a Browser session using the AWS CLI, use the `start-browser-session` command: @@ -30 +33 @@ Boto3 -To start a Browser session using the AWS SDK for Python (Boto3), use the `start_browser_session` method: + 1. To start a Browser session using the AWS SDK for Python (Boto3), use the `start_browser_session` method: @@ -32 +35 @@ To start a Browser session using the AWS SDK for Python (Boto3), use the `start_ -###### Request Syntax +**Request Syntax** @@ -48 +49,0 @@ The following shows the request syntax: -BrowserClient @@ -51 +52,2 @@ BrowserClient -To start a browser session using the BrowserClient class for more control over the session lifecycle: +BrowserClient + @@ -52,0 +55 @@ To start a browser session using the BrowserClient class for more control over t + 1. To start a browser session using the BrowserClient class for more control over the session lifecycle: @@ -74 +76,0 @@ To start a browser session using the BrowserClient class for more control over t -API @@ -77 +79,2 @@ API -To create a new browser session using the API, use the following call: +API + @@ -78,0 +82 @@ To create a new browser session using the API, use the following call: + 1. To create a new browser session using the API, use the following call: @@ -102 +108 @@ You can get information about a browser session that you have created. -AWS CLI +###### Example @@ -103,0 +110 @@ AWS CLI +AWS CLI @@ -105 +111,0 @@ AWS CLI -To get information about a browser session using the AWS CLI, use the `get-browser-session` command: @@ -106,0 +113 @@ To get information about a browser session using the AWS CLI, use the `get-brows + 1. To get information about a browser session using the AWS CLI, use the `get-browser-session` command: @@ -117 +126 @@ Boto3 -To get information about a browser session using the AWS SDK for Python (Boto3), use the `get_browser_session` method: + 1. To get information about a browser session using the AWS SDK for Python (Boto3), use the `get_browser_session` method: @@ -119 +128 @@ To get information about a browser session using the AWS SDK for Python (Boto3), -###### Request Syntax +**Request Syntax** @@ -130 +137,0 @@ The following shows the request syntax: -API @@ -133 +140,2 @@ API -To get information about a browser session using the API, use the following call: +API + @@ -134,0 +143 @@ To get information about a browser session using the API, use the following call + 1. To get information about a browser session using the API, use the following call: @@ -171 +182,3 @@ To get information about a browser session using the API, use the following call -Once you have started a Browser session, you can interact with it using the WebSocket API. +Once you have started a Browser session, you can interact with it using the WebSocket API. You can also use the InvokeBrowser API for direct operating system-level control, including mouse clicks, keyboard input, and full-screen screenshots. For more information, see [Browser OS action](./browser-invoke.html). + +###### Example @@ -176 +189 @@ Console -###### To interact with a Browser session using the console + 1. ====== To interact with a Browser session using the console @@ -178 +191 @@ Console - 1. Navigate to your active Browser session. + 2. Navigate to your active Browser session. @@ -180 +193 @@ Console - 2. Use the browser interface to navigate to websites, interact with web elements, and perform other browser actions. + 3. Use the browser interface to navigate to websites, interact with web elements, and perform other browser actions. @@ -182 +195 @@ Console - 3. You can view the browser activity in real-time through the live view feature. + 4. You can view the browser activity in real-time through the live view feature. @@ -190,2 +203 @@ SDK -To interact with a Browser session programmatically, use the WebSocket-based streaming API with the following URL format: - + 1. To interact with a Browser session programmatically, use the WebSocket-based streaming API with the following URL format: @@ -195,2 +207 @@ To interact with a Browser session programmatically, use the WebSocket-based str -You can use libraries like Playwright to establish a connection with the WebSocket and control the browser. Here's an example: - +You can use libraries like Playwright to establish a connection with the WebSocket and control the browser. Here’s an example: @@ -291 +301 @@ You can list all active browser sessions to monitor and manage your resources. T -AWS CLI +###### Example @@ -292,0 +303 @@ AWS CLI +AWS CLI @@ -294 +304,0 @@ AWS CLI -To list Browser sessions using the AWS CLI, use the `list-browser-sessions` command: @@ -295,0 +306 @@ To list Browser sessions using the AWS CLI, use the `list-browser-sessions` comm + 1. To list Browser sessions using the AWS CLI, use the `list-browser-sessions` command: @@ -315 +326 @@ Boto3 -To list Browser sessions using the AWS SDK for Python (Boto3), use the `list_browser_sessions` method: + 1. To list Browser sessions using the AWS SDK for Python (Boto3), use the `list_browser_sessions` method: @@ -317 +328 @@ To list Browser sessions using the AWS SDK for Python (Boto3), use the `list_bro -###### Request Syntax +**Request Syntax** @@ -343 +350,0 @@ You can also filter sessions by status: -API @@ -346 +353,2 @@ API -To list browser sessions using the API, use the following call: +API + @@ -347,0 +356 @@ To list browser sessions using the API, use the following call: + 1. To list browser sessions using the API, use the following call: @@ -381 +390 @@ When you are finished using a Browser session, you should stop it to release res -AWS CLI +###### Example @@ -382,0 +392 @@ AWS CLI +AWS CLI @@ -384 +393,0 @@ AWS CLI -To stop a Browser session using the AWS CLI, use the `stop-browser-session` command: @@ -385,0 +395 @@ To stop a Browser session using the AWS CLI, use the `stop-browser-session` comm + 1. To stop a Browser session using the AWS CLI, use the `stop-browser-session` command: @@ -396 +408 @@ Boto3 -To stop a Browser session using the AWS SDK for Python (Boto3), use the `stop_browser_session` method: + 1. To stop a Browser session using the AWS SDK for Python (Boto3), use the `stop_browser_session` method: @@ -398 +410 @@ To stop a Browser session using the AWS SDK for Python (Boto3), use the `stop_br -###### Request Syntax +**Request Syntax** @@ -409 +419,0 @@ The following shows the request syntax: -API @@ -412 +422 @@ API -To stop a browser session using the API, use the following call: +API @@ -414,0 +425,2 @@ To stop a browser session using the API, use the following call: + 1. To stop a browser session using the API, use the following call: + @@ -426 +440 @@ To stop a browser session using the API, use the following call: -You can update browser streams to enable or disable automation. This is useful when you need to enter sensitive information like login credentials that you don't want the agent to see. +You can update browser streams to enable or disable automation. This is useful when you need to enter sensitive information like login credentials that you don’t want the agent to see. @@ -428 +442 @@ You can update browser streams to enable or disable automation. This is useful w -Boto3 +###### Example @@ -429,0 +444 @@ Boto3 +Boto3 @@ -432 +447 @@ Boto3 - response = dp_client.update_browser_stream( + 1. response = dp_client.update_browser_stream( @@ -442 +456,0 @@ Boto3 -API @@ -446 +460,4 @@ API - awscurl -X PUT \ +API + + + 1. awscurl -X PUT \ @@ -460 +476,0 @@ API -CLI @@ -464 +480,4 @@ CLI - aws bedrock-agentcore update-browser-stream \ +CLI + + + 1. aws bedrock-agentcore update-browser-stream \