啟動瀏覽器工作階段取得瀏覽器工作階段與瀏覽器工作階段互動列出瀏覽器工作階段停止瀏覽器工作階段更新瀏覽器串流

管理瀏覽器工作階段

啟動瀏覽器工作階段

建立瀏覽器後，您可以啟動工作階段來與 Web 應用程式互動。

範例

AWS CLI

若要使用 CLI AWS 啟動瀏覽器工作階段，請使用 start-browser-session命令：


 aws bedrock-agentcore start-browser-session \
  --region <Region> \
  --browser-identifier "my-browser" \
  --name "my-browser-session" \
  --session-timeout-seconds 900 \
  --view-port width=1456,height=819

Boto3

若要使用適用於 Python 的 AWS SDK (Boto3) 啟動瀏覽器工作階段，請使用 start_browser_session方法：

請求語法

以下顯示請求語法：


response = dp_client.start_browser_session(
    browserIdentifier="aws.browser.v1",
    name="browser-session-1",
    sessionTimeoutSeconds=3600,
    viewPort={
        'height': 819,
        'width': 1456
    }
)

BrowserClient

若要使用 BrowserClient 類別啟動瀏覽器工作階段，以進一步控制工作階段生命週期：


from bedrock_agentcore.tools.browser_client import BrowserClient

# Create a browser client
client = BrowserClient(region="us-west-2")

# Start a browser session
client.start()
print(f"Session ID: {client.session_id}")

try:
    # Generate WebSocket URL and headers
    url, headers = client.generate_ws_headers()

    # Perform browser operations with your preferred automation tool

finally:
    # Always close the session when done
    client.stop()

API

若要使用 API 建立新的瀏覽器工作階段，請使用下列呼叫：


# Using awscurl
awscurl -X PUT \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/aws.browser.v1/sessions/start" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "name": "browser-session-abc12345",
    "description": "browser sandbox session",
    "sessionTimeoutSeconds": 300,
    "viewPort": {
       "height": 819,
       "width": 1456
    }
  }'

取得瀏覽器工作階段

您可以取得您已建立之瀏覽器工作階段的相關資訊。

範例

AWS CLI

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


aws bedrock-agentcore get-browser-session \
  --region <Region> \
  --browser-identifier "aws.browser.v1" \
  --session-id "<your-session-id>"

Boto3

若要使用適用於 Python 的 AWS SDK (Boto3) 取得瀏覽器工作階段的相關資訊，請使用 get_browser_session方法：

請求語法

以下顯示請求語法：
```
response = dp_client.get_browser_session(
    browserIdentifier="aws.browser.v1",
    sessionId="<your-session-id>"
)
```

API

若要使用 API 取得瀏覽器工作階段的相關資訊，請使用下列呼叫：


# Using awscurl
awscurl -X GET \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/aws.browser.v1/sessions/get?sessionId=<your-session-id>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region>

{
  "browserIdentifier": "aws.browser.v1",
  "createdAt": "2025-07-14T22:16:40.713152248Z",
  "lastUpdatedAt": "2025-07-14T22:16:40.713152248Z",
  "name": "testBrowserSession1752531400",
  "sessionId": "<your-session-id>",
  "sessionReplayArtifact": null,
  "sessionTimeoutSeconds": 900,
  "status": "TERMINATED",
  "streams": {
    "automationStream": {
      "streamEndpoint": "wss://bedrock-agentcore.<Region>.amazonaws.com/browser-streams/aws.browser.v1/sessions/<your-session-id>/automation",
      "streamStatus": "ENABLED"
    },
    "liveViewStream": {
      "streamEndpoint": "https://bedrock-agentcore.<Region>.amazonaws.com/browser-streams/aws.browser.v1/sessions/<your-session-id>/live-view"
    }
  },
  "viewPort": {
    "height": 819,
    "width": 1456
  }
}

與瀏覽器工作階段互動

啟動瀏覽器工作階段後，您可以使用 WebSocket API 與其互動。您也可以使用 InvokeBrowser API 進行直接作業系統層級控制，包括滑鼠點選、鍵盤輸入和全螢幕螢幕擷取畫面。如需詳細資訊，請參閱瀏覽器作業系統動作。

範例

Console

====== 使用主控台與瀏覽器工作階段互動
導覽至作用中的瀏覽器工作階段。
使用瀏覽器界面導覽至網站、與 Web 元素互動，以及執行其他瀏覽器動作。
您可以透過即時檢視功能即時檢視瀏覽器活動。

SDK

若要以程式設計方式與瀏覽器工作階段互動，請使用 WebSocket 型串流 API 搭配下列 URL 格式：


https://bedrock-agentcore.<Region>.amazonaws.com/browser-streams/{browser_id}/sessions/{session_id}/automation

您可以使用 Playwright 之類的程式庫來建立與 WebSocket 的連線，並控制瀏覽器。範例如下：


from playwright.sync_api import sync_playwright, Playwright, BrowserType
import os
import base64
from bedrock_agentcore.tools.browser_client import browser_session

def main(playwright: Playwright):
    # Keep browser session alive during usage
    with browser_session('us-west-2') as client:

        # Generate CDP endpoint and headers
        ws_url, headers = client.generate_ws_headers()

        # Connect to browser using headers
        chromium: BrowserType = playwright.chromium
        browser = chromium.connect_over_cdp(ws_url, headers=headers)

        # Use the first available context or create one
        context = browser.contexts[0] if browser.contexts else browser.new_context()
        page = context.pages[0] if context.pages else context.new_page()

        page.goto("https://amazon.com/")
        print("Navigated to Amazon")

        # Create CDP session for screenshot
        cdp_client = context.new_cdp_session(page)
        screenshot_data = cdp_client.send("Page.captureScreenshot", {
            "format": "jpeg",
            "quality": 80,
            "captureBeyondViewport": True
        })

        # Decode and save screenshot
        image_data = base64.b64decode(screenshot_data['data'])
        with open("screenshot.jpeg", "wb") as f:
            f.write(image_data)

        print("✅ Screenshot saved as screenshot.jpeg")
        page.close()
        browser.close()

with sync_playwright() as p:
    main(p)

下列範例程式碼示範如何使用 WebSocket 型串流 API 執行即時檢視。


https://bedrock-agentcore.<Region>.amazonaws.com/browser-streams/{browser_id}/sessions/{session_id}/live-view

以下是程式碼。


import time
from rich.console import Console
from bedrock_agentcore.tools.browser_client import browser_session
from browser_viewer import BrowserViewerServer

console = Console()

def main():
    try:
         # Step 1: Create browser session
        with browser_session('us-west-2') as client:
            print("\r   ✅ Browser ready!                    ")
            ws_url, headers = client.generate_ws_headers()

            # Step 2: Start viewer server
            console.print("\n[cyan]Step 3: Starting viewer server...[/cyan]")
            viewer = BrowserViewerServer(client, port=8005)
            viewer_url = viewer.start(open_browser=True)

            # Keep running
            while True:
                time.sleep(1)

    except KeyboardInterrupt:
        console.print("\n\n[yellow]Shutting down...[/yellow]")
        if 'client' in locals():
            client.stop()
            console.print("✅ Browser session terminated")
    except Exception as e:
        console.print(f"\n[red]Error: {e}[/red]")
        import traceback
        traceback.print_exc()

if __name__ == "__main__":
    main()

列出瀏覽器工作階段

您可以列出所有作用中的瀏覽器工作階段來監控和管理資源。這有助於追蹤作用中工作階段、識別長時間執行的工作階段，或尋找需要停止的工作階段。

範例

AWS CLI

若要使用 CLI AWS 列出瀏覽器工作階段，請使用 list-browser-sessions命令：


aws bedrock-agentcore list-browser-sessions \
  --region <Region> \
  --browser-id "<your-browser-id>" \
  --max-results 10

您也可以依狀態篩選工作階段：


aws bedrock-agentcore list-browser-sessions \
  --region <Region> \
  --browser-id "<your-browser-id>" \
  --status "READY"

Boto3

若要使用適用於 Python 的 AWS SDK (Boto3) 列出瀏覽器工作階段，請使用 list_browser_sessions方法：

請求語法

以下顯示請求語法：


response = dp_client.list_browser_sessions(
    browserIdentifier="aws.browser.v1"
)

您也可以依狀態篩選工作階段：


# List only active sessions
filtered_response = dp_client.list_browser_sessions(
    browserIdentifier="aws.browser.v1",
    status="READY"
)

# Print filtered session information
for session in filtered_response['items']:
    print(f"Ready Session ID: {session['sessionId']}")
    print(f"Name: {session['name']}")
    print("---")

API

若要使用 API 列出瀏覽器工作階段，請使用下列呼叫：


# Using awscurl
awscurl -X POST \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/<your-browser-id>/sessions/list" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "maxResults": 10
  }'

您也可以依狀態篩選工作階段：


# Using awscurl
awscurl -X POST \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/aws.browser.v1/sessions/list" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "maxResults": 10,
    "status": "READY"
  }'

停止瀏覽器工作階段

使用瀏覽器工作階段完成後，您應該將其停止以釋出資源，並避免不必要的費用。

範例

更新瀏覽器串流

您可以更新瀏覽器串流來啟用或停用自動化。當您需要輸入敏感資訊，例如您不希望客服人員看到的登入登入資料時，這會很有用。

範例

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用瀏覽器工具

可觀測性