儲存並檢視瀏覽器工作階段錄製

當 AI 代理使用 劇作家工作區 的遠端 MCP 伺服器時,它會驅動一個你不會即時監控的雲端瀏覽器。 會話錄製會讓你完整記錄該瀏覽器中發生了什麼。 劇作家工作區 會將每個瀏覽器工作階段的產物儲存到您擁有的 Azure 儲存體帳戶,您可在 Azure 入口網站中工作區的瀏覽器活動記錄頁面上重播這些產物。

透過工作階段錄製,您可以逐一檢視代理程式所採取的每一個動作,查看每個動作前後的頁面,並檢查主控台訊息、網路請求以及瀏覽器產生的錯誤。

何時使用工作階段錄製

在以下情況下,會話錄製很有幫助:

  • 除錯失敗或意外執行代理程式。 當代理程式回報錯誤、在任務進行中途停止或回傳錯誤結果時,請重播該工作階段,找出出錯的確切步驟,例如選擇器不匹配、頁面未完成載入,或對話框阻擋下一個動作。
  • 確認代理程式執行了哪些操作。 在你依賴結果之前,請確認代理人是否如你所預期地完成了任務,例如在表單中輸入了正確的數值或提交了正確的紀錄。
  • 稽核並檢視代理程式活動。 保留代理程式在商務應用程式上執行的動作的可檢視紀錄,以便您的團隊能檢視代理程式行為以進行治理或合規。
  • 調查私有或需要驗證的應用程式問題。 查看瀏覽器在造訪私人託管應用程式、登入頁面或採用單一登入的網站時的行為,包括網路故障與重新導向。
  • 改進提示與代理程式指示。 比較成功與失敗執行的錄影,以了解代理程式如何解讀頁面,並精煉您的提示或指示。
  • 與你的團隊分享證據。 給開發人員、測試人員或支援工程師一段顯示問題的錄影,而不是書面描述。

工作階段錄製中的成品

每個錄製的工作階段都包含以下成品:

成品 Description
工作階段詳細資料 會話摘要:工作階段名稱與 ID、創建者、狀態、開始與結束時間、可計費時間、來源類型(例如 MCP 或 瀏覽器自動化工具)、來源 ID 及瀏覽器類型。
會話回放(追蹤) 可在 Azure 入口網站或 Trace Viewer 中重播的工作階段 Playwright 追蹤。 它包含會話的時間軸,並附有頁面快照,讓您能移動到會話中的任何時間點。
Actions 代理程式執行的瀏覽器操作清單,例如導覽、點擊、輸入及腳本評估,以及每個動作的持續時間。 對於每個動作,您可以檢視 動作前 與 動作後 的頁面。
截圖與影片 瀏覽器在會話中顯示的頁面的視覺擷取。
主控台 頁面寫入瀏覽器主控台的訊息,包括警告與錯誤。
Network 瀏覽器發出的網路請求,並附上其網址、狀態碼和時間資訊。
錯誤 工作階段中發生的錯誤,例如動作失敗及頁面錯誤。
日誌 每個動作的詳細日誌,包括呼叫參數、定位符以及 Playwright 執行的步驟。
元資料與附件 會話的元資料,例如瀏覽器與視埠詳細資訊,以及附加到會話的任何檔案。

Prerequisites

開始之前,請確定您有下列項目:

啟用可觀察性並設定儲存

會話錄製會儲存在與您的工作區連結的 Azure 儲存帳戶中。 劇作家工作區 使用受管理身份將工件寫入該儲存帳戶。 若要設定此設定,請開啟可觀測性,選擇儲存帳戶,並選擇受控識別。 您可以建立新工作區或更新現有工作區。

  1. 使用您 Azure 訂閱的認證來登入 Azure 入口網站。

  2. 在入口網站首頁,搜尋並選擇 Azure 應用程式測試。

  3. 在 Azure 應用程式測試 中心的 劇作家工作區 下,選取「建立」。

  4. 在「基礎」索引標籤的「建立 Playwright 工作區」頁面上,輸入以下資訊:

    Field Description
    訂閱 選取要用於此 Playwright 工作區的 Azure 訂閱。
    資源群組 選取現有的資源群組。 或選取 [新建],然後為新的資源群組輸入唯一的名稱。
    姓名 為您的工作區輸入一個獨特的名稱。 名稱只能包含字母數字和連字號,且長度必須為 3 到 24 個字元。
    位置 選擇一個地理位置作為工作區。
  5. 選擇「 功能 」標籤,然後輸入以下資訊:

    Field Description
    可觀察性 開啟以擷取報告、追蹤及工作階段錄製。
    記憶體帳戶 選取現有的儲存帳戶,或選取 「建立新的」 來建立一個。 劇作家工作區 會將你的工作階段錄製內容和其他資料儲存在這個儲存帳戶中。
    身份類型 選擇 劇作家工作區 用來存取儲存體帳戶的受控識別:系統指派 或 使用者指派。 如果您選擇 「使用者指派」,請選擇由使用者指派的管理識別碼。
    身份權限 選取「代表我為受控識別指派權限」,讓 Azure 入口網站將儲存體帳戶上的Storage Blob Data Contributor角色指派給受控識別。 只有當您有權限指派儲存帳戶角色時,才選擇此選項。 否則,請清除並手動 指派角色。

    螢幕擷取畫面顯示「建立 Playwright 工作區」頁面的功能標籤,啟用觀察功能、已選取儲存帳戶、身份類型設為系統指派,以及已選取的受管理身份指派權限選項。

  6. 您也可以選擇在「 標籤」 索引標籤中新增標籤。標籤是用於分類資源並檢視合併帳單的名稱/值對,方法是將相同標籤套用至多個資源及資源群組。

  7. 選擇 評論 + 創建。 檢視你的設定,然後選擇 建立。

    建立工作區需要幾分鐘。 請等待入口網站顯示「 您的部署已完成 」後再繼續。

Note

所有需要儲存帳戶的工作區功能,例如工作階段錄製、報告及瀏覽器設定檔,皆使用您在 功能 頁面設定的相同儲存帳戶及管理身份。

Note

劇作家工作區 的可觀察性會將您的工作階段錄製內容和其他產物儲存在 Azure 儲存體 中。 儲存費用取決於您的儲存帳戶的資料保留設定。

Note

要儲存成品,儲存帳戶必須允許透過其公用端點進行網路存取。 僅允許透過私有端點存取的儲存帳戶目前不支援儲存產物。

為受管理身份指派儲存權限

如果您已取消「代 我指派受管理身份」權限,或您沒有權限指派儲存帳戶的角色,請手動指派該角色。 如果您沒有所需的權限,請在儲存帳戶上擁有擁有者、使用者存取管理員或角色型 存取控制 管理員角色的人員完成這些步驟。

  1. 在 Azure 入口網站中,前往與您工作區連結的儲存帳戶。

  2. 選擇存取控制 (IAM)>新增>新增角色指派。

  3. 在 「角色」 索引標籤上,搜尋並選取「Storage Blob Data Contributor」,然後選擇「下一步」。

  4. 在 [ 成員] 索引標籤上,針對 [ 指派存取權] 選取 [ 受控識別]。

  5. 選擇「 選取成員」,然後選擇您為工作區所選擇的管理身份:

    • 對於系統指派的身份,請選擇 Playwright 工作區 作為管理身份類型,然後選擇您的工作區。
    • 對於使用者指派的識別,選擇 「使用者指派的受控識別」,然後選擇該識別。
  6. 選取 選取,然後選取 檢閱與指派。

Tip

角色分配可能需要幾分鐘才能生效。 如果錄影沒有立即顯示,請等待幾分鐘後重新執行該工作階段。

在您的 MCP 用戶端中啟用工作階段錄製

遠端 MCP 伺服器只會在您的 MCP 用戶端要求時錄製瀏覽器會話。 要啟用錄製,請在您的 MCP 用戶端中的遠端 MCP 伺服器設定中新增以下 HTTP 標頭:

Header Value
x-ms-enable-sessionartifacts Enabled

用戶端透過此 MCP 伺服器連線建立的每一個瀏覽器工作階段都會被記錄下來。 來自未傳送標頭的用戶端會話不會被記錄。 新增標頭時,請保留您現有的 URL 與驗證設定。

  1. 在 GitHub Copilot 應用程式 中,從側邊欄選擇 自訂,然後選擇 已安裝 標籤。

  2. 在 MCP 伺服器下,找到 劇作家工作區 伺服器,例如 playwright-cloud-browsers-<workspace-name>,打開其「更多」選項選單,選擇「編輯設定」。

  3. 在 「標頭」下,選取 新增標頭,然後輸入下列數值:

    • 名稱: x-ms-enable-sessionartifacts
    • 值: Enabled

    截圖顯示 GitHub Copilot 應用程式 中 MCP 伺服器設定,標頭 x-ms-enable-sessionartifacts 設為 Enabled。

  4. 選取 [儲存]。

Tip

如果您的伺服器項目已有其他 劇作家工作區 標頭,例如 x-ms-browser-profile-id 或 x-ms-secret-store-id,請加入x-ms-enable-sessionartifacts同一組標頭。

使用您的代理程式執行瀏覽器工作階段

請你的代理程式執行瀏覽器任務。 例如,輸入以下提示字句:

Open https://playwright.dev, open the Docs page, and tell me the title of the page.

代理程式會在你的工作區開啟雲端瀏覽器,完成任務後關閉工作階段。 由於您的 MCP 用戶端會傳送 x-ms-enable-sessionartifacts 標頭,該工作階段的成品會儲存在連結的儲存帳戶中。

Caution

會話錄影記錄瀏覽器所顯示的內容,包括每個頁面的截圖、頁面內容及網路流量。 如果您的代理程式處理敏感資料,請限制誰能讀取連結的儲存帳戶,並設定符合您組織需求的資料保留政策。

在 Azure 入口網站檢視工作階段錄製

若要在 Azure 入口網站中檢視錄影,您需要對已連結的儲存帳戶具有讀取權限,且該儲存帳戶必須允許追蹤檢視器載入追蹤檔案。

為檢視錄影的人員指派儲存角色

  1. 在 Azure 入口網站中,前往與您工作區連結的儲存帳戶。

  2. 選擇存取控制 (IAM)>新增>新增角色指派。

  3. 在 「角色」 索引標籤中,搜尋並選取「儲存 Blob 資料讀取器」,然後選擇「下一步」。

  4. 在 「成員」 標籤中,選取並新增所有需要檢視會話錄影的人。

  5. 選擇 檢閱 + 指派。

允許追蹤檢視器從儲存帳戶讀取

  1. 在 Azure 入口網站中,前往連結的儲存帳戶。

  2. 選擇設定>資源共用(CORS)。

  3. 在 Blob 服務 索引標籤上,新增一個具有下列值的記錄:

    Field Value
    允許的來源 https://trace.playwright.dev
    允許的方法 GET,OPTIONS
    最大年齡 介於 0 與 2147483647之間的值。
  4. 選取 [儲存]。

檢視錄製的會話

  1. 在 Azure 入口網站中,前往您的 Playwright 工作區。

  2. 選擇瀏覽器工作階段>瀏覽器活動記錄。

    瀏覽器活動記錄會列出您工作區中的瀏覽器工作階段。 每個工作階段會顯示工作階段名稱、工作階段 ID、建立者、來源類型、開始時間、來源 ID、可計費時間、瀏覽器類型及狀態。 要尋找工作階段,請依 時間範圍、 來源類型、 狀態或來源 ID 篩選清單。 您的 MCP 用戶端會建立來源類型為 MCP 的會話。

    螢幕截圖顯示 Azure 入口網站中 Playwright 工作區的瀏覽器活動記錄頁面,包含瀏覽器工作階段及其來源類型、開始時間、計費時間、瀏覽器類型及狀態。

  3. 選擇您的代理程式執行的會話名稱。

    工作階段頁面會顯示 工作階段詳細資訊 及 工作階段回放。 在播放時,你可以:

    • 沿著時間軸移動,即可在工作階段的任何時間點查看該頁面。
    • 在動作清單中選取一個動作,即可查看該動作前和後的頁面。
    • 使用 定位器、呼叫、記錄、錯誤、主控台、網路、來源 和 附件 索引標籤來查看各個動作的詳細資料。
    • 在 Trace Viewer 中開啟該工作階段,以進行更深入的分析。

    顯示 Azure 入口網站中的瀏覽器工作階段的螢幕截圖,工作階段詳細資訊在上方,工作階段播放在下方,包括時間軸、動作清單、頁面快照及主控台訊息。

  4. 若要返回清單,請選取 「檢視所有工作階段」。

停止記錄工作階段

若要停止錄製新的工作階段,請從 MCP 用戶端設定中移除 x-ms-enable-sessionartifacts 標頭。 現有的錄音會保留在您的儲存帳戶中,直到您刪除它們,或直到您的儲存帳戶的資料保留設定將其移除為止。

資料存放位置

所有工作階段錄製及其他產物都會儲存在您連結至工作區的 Azure 儲存帳戶中。 您擁有並控制此儲存帳戶,包括其區域、存取權限、網路設定及資料保留。

劇作家工作區 僅儲存列出和管理工作階段所需的元資料,例如工作階段名稱與 ID、建立者、狀態、開始與結束時間、可計費時間、來源類型及瀏覽器類型。 劇作家工作區 不會儲存瀏覽器工作階段中的任何用戶端資料,例如頁面內容、截圖、影片、追蹤、主控台訊息或網路流量。