當 AI 代理使用 劇作家工作區 的遠端 MCP 伺服器時,它會驅動一個你不會即時監控的雲端瀏覽器。 會話錄製會讓你完整記錄該瀏覽器中發生了什麼。 劇作家工作區 會將每個瀏覽器工作階段的產物儲存到您擁有的 Azure 儲存體帳戶,您可在 Azure 入口網站中工作區的瀏覽器活動記錄頁面上重播這些產物。
透過工作階段錄製,您可以逐一檢視代理程式所採取的每一個動作,查看每個動作前後的頁面,並檢查主控台訊息、網路請求以及瀏覽器產生的錯誤。
何時使用工作階段錄製
在以下情況下,會話錄製很有幫助:
- 除錯失敗或意外執行代理程式。 當代理程式回報錯誤、在任務進行中途停止或回傳錯誤結果時,請重播該工作階段,找出出錯的確切步驟,例如選擇器不匹配、頁面未完成載入,或對話框阻擋下一個動作。
- 確認代理程式執行了哪些操作。 在你依賴結果之前,請確認代理人是否如你所預期地完成了任務,例如在表單中輸入了正確的數值或提交了正確的紀錄。
- 稽核並檢視代理程式活動。 保留代理程式在商務應用程式上執行的動作的可檢視紀錄,以便您的團隊能檢視代理程式行為以進行治理或合規。
- 調查私有或需要驗證的應用程式問題。 查看瀏覽器在造訪私人託管應用程式、登入頁面或採用單一登入的網站時的行為,包括網路故障與重新導向。
- 改進提示與代理程式指示。 比較成功與失敗執行的錄影,以了解代理程式如何解讀頁面,並精煉您的提示或指示。
- 與你的團隊分享證據。 給開發人員、測試人員或支援工程師一段顯示問題的錄影,而不是書面描述。
工作階段錄製中的成品
每個錄製的工作階段都包含以下成品:
| 成品 | Description |
|---|---|
| 工作階段詳細資料 | 會話摘要:工作階段名稱與 ID、創建者、狀態、開始與結束時間、可計費時間、來源類型(例如 MCP 或 瀏覽器自動化工具)、來源 ID 及瀏覽器類型。 |
| 會話回放(追蹤) | 可在 Azure 入口網站或 Trace Viewer 中重播的工作階段 Playwright 追蹤。 它包含會話的時間軸,並附有頁面快照,讓您能移動到會話中的任何時間點。 |
| Actions | 代理程式執行的瀏覽器操作清單,例如導覽、點擊、輸入及腳本評估,以及每個動作的持續時間。 對於每個動作,您可以檢視 動作前 與 動作後 的頁面。 |
| 截圖與影片 | 瀏覽器在會話中顯示的頁面的視覺擷取。 |
| 主控台 | 頁面寫入瀏覽器主控台的訊息,包括警告與錯誤。 |
| Network | 瀏覽器發出的網路請求,並附上其網址、狀態碼和時間資訊。 |
| 錯誤 | 工作階段中發生的錯誤,例如動作失敗及頁面錯誤。 |
| 日誌 | 每個動作的詳細日誌,包括呼叫參數、定位符以及 Playwright 執行的步驟。 |
| 元資料與附件 | 會話的元資料,例如瀏覽器與視埠詳細資訊,以及附加到會話的任何檔案。 |
Prerequisites
開始之前,請確定您有下列項目:
- 一個有有效訂閱的 Azure 帳號。 如果您沒有 Azure 訂用帳戶,請建立免費帳戶。
- 您的 Azure 帳戶上的 Owner、貢獻者,或其中一個經典管理員角色。
- 若要讓Azure入口網站為您指派受管理身分的儲存體權限,您必須具備可在儲存帳戶上指派角色的角色,例如擁有者、使用者存取系統管理員或Role Based 存取控制 Administrator。 如果你沒有這些角色,請有權限的人幫你指派權限。
- 連接至 劇作家工作區 遠端 MCP 伺服器的 MCP 用戶端,例如 GitHub Copilot 應用程式、搭配 GitHub Copilot 的 Visual Studio Code,或 GitHub Copilot CLI。 若要設定,請參閱 快速入門:使用遠端 MCP 伺服器自動化瀏覽器任務。
啟用可觀察性並設定儲存
會話錄製會儲存在與您的工作區連結的 Azure 儲存帳戶中。 劇作家工作區 使用受管理身份將工件寫入該儲存帳戶。 若要設定此設定,請開啟可觀測性,選擇儲存帳戶,並選擇受控識別。 您可以建立新工作區或更新現有工作區。
使用您 Azure 訂閱的認證來登入 Azure 入口網站。
在入口網站首頁,搜尋並選擇 Azure 應用程式測試。
在 Azure 應用程式測試 中心的 劇作家工作區 下,選取「建立」。
在「基礎」索引標籤的「建立 Playwright 工作區」頁面上,輸入以下資訊:
Field Description 訂閱 選取要用於此 Playwright 工作區的 Azure 訂閱。 資源群組 選取現有的資源群組。 或選取 [新建],然後為新的資源群組輸入唯一的名稱。 姓名 為您的工作區輸入一個獨特的名稱。 名稱只能包含字母數字和連字號,且長度必須為 3 到 24 個字元。 位置 選擇一個地理位置作為工作區。 選擇「 功能 」標籤,然後輸入以下資訊:
Field Description 可觀察性 開啟以擷取報告、追蹤及工作階段錄製。 記憶體帳戶 選取現有的儲存帳戶,或選取 「建立新的」 來建立一個。 劇作家工作區 會將你的工作階段錄製內容和其他資料儲存在這個儲存帳戶中。 身份類型 選擇 劇作家工作區 用來存取儲存體帳戶的受控識別:系統指派 或 使用者指派。 如果您選擇 「使用者指派」,請選擇由使用者指派的管理識別碼。 身份權限 選取「代表我為受控識別指派權限」,讓 Azure 入口網站將儲存體帳戶上的Storage Blob Data Contributor角色指派給受控識別。 只有當您有權限指派儲存帳戶角色時,才選擇此選項。 否則,請清除並手動 指派角色。 您也可以選擇在「 標籤」 索引標籤中新增標籤。標籤是用於分類資源並檢視合併帳單的名稱/值對,方法是將相同標籤套用至多個資源及資源群組。
選擇 評論 + 創建。 檢視你的設定,然後選擇 建立。
建立工作區需要幾分鐘。 請等待入口網站顯示「 您的部署已完成 」後再繼續。
Note
所有需要儲存帳戶的工作區功能,例如工作階段錄製、報告及瀏覽器設定檔,皆使用您在 功能 頁面設定的相同儲存帳戶及管理身份。
Note
劇作家工作區 的可觀察性會將您的工作階段錄製內容和其他產物儲存在 Azure 儲存體 中。 儲存費用取決於您的儲存帳戶的資料保留設定。
Note
要儲存成品,儲存帳戶必須允許透過其公用端點進行網路存取。 僅允許透過私有端點存取的儲存帳戶目前不支援儲存產物。
為受管理身份指派儲存權限
如果您已取消「代 我指派受管理身份」權限,或您沒有權限指派儲存帳戶的角色,請手動指派該角色。 如果您沒有所需的權限,請在儲存帳戶上擁有擁有者、使用者存取管理員或角色型 存取控制 管理員角色的人員完成這些步驟。
在 Azure 入口網站中,前往與您工作區連結的儲存帳戶。
選擇存取控制 (IAM)>新增>新增角色指派。
在 「角色」 索引標籤上,搜尋並選取「Storage Blob Data Contributor」,然後選擇「下一步」。
在 [ 成員] 索引標籤上,針對 [ 指派存取權] 選取 [ 受控識別]。
選擇「 選取成員」,然後選擇您為工作區所選擇的管理身份:
- 對於系統指派的身份,請選擇 Playwright 工作區 作為管理身份類型,然後選擇您的工作區。
- 對於使用者指派的識別,選擇 「使用者指派的受控識別」,然後選擇該識別。
選取 選取,然後選取 檢閱與指派。
Tip
角色分配可能需要幾分鐘才能生效。 如果錄影沒有立即顯示,請等待幾分鐘後重新執行該工作階段。
在您的 MCP 用戶端中啟用工作階段錄製
遠端 MCP 伺服器只會在您的 MCP 用戶端要求時錄製瀏覽器會話。 要啟用錄製,請在您的 MCP 用戶端中的遠端 MCP 伺服器設定中新增以下 HTTP 標頭:
| Header | Value |
|---|---|
x-ms-enable-sessionartifacts |
Enabled |
用戶端透過此 MCP 伺服器連線建立的每一個瀏覽器工作階段都會被記錄下來。 來自未傳送標頭的用戶端會話不會被記錄。 新增標頭時,請保留您現有的 URL 與驗證設定。
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 入口網站中檢視錄影,您需要對已連結的儲存帳戶具有讀取權限,且該儲存帳戶必須允許追蹤檢視器載入追蹤檔案。
為檢視錄影的人員指派儲存角色
在 Azure 入口網站中,前往與您工作區連結的儲存帳戶。
選擇存取控制 (IAM)>新增>新增角色指派。
在 「角色」 索引標籤中,搜尋並選取「儲存 Blob 資料讀取器」,然後選擇「下一步」。
在 「成員」 標籤中,選取並新增所有需要檢視會話錄影的人。
選擇 檢閱 + 指派。
允許追蹤檢視器從儲存帳戶讀取
在 Azure 入口網站中,前往連結的儲存帳戶。
選擇設定>資源共用(CORS)。
在 Blob 服務 索引標籤上,新增一個具有下列值的記錄:
Field Value 允許的來源 https://trace.playwright.dev允許的方法 GET,OPTIONS最大年齡 介於 0與2147483647之間的值。選取 [儲存]。
檢視錄製的會話
在 Azure 入口網站中,前往您的 Playwright 工作區。
選擇瀏覽器工作階段>瀏覽器活動記錄。
瀏覽器活動記錄會列出您工作區中的瀏覽器工作階段。 每個工作階段會顯示工作階段名稱、工作階段 ID、建立者、來源類型、開始時間、來源 ID、可計費時間、瀏覽器類型及狀態。 要尋找工作階段,請依 時間範圍、 來源類型、 狀態或來源 ID 篩選清單。 您的 MCP 用戶端會建立來源類型為 MCP 的會話。
選擇您的代理程式執行的會話名稱。
工作階段頁面會顯示 工作階段詳細資訊 及 工作階段回放。 在播放時,你可以:
- 沿著時間軸移動,即可在工作階段的任何時間點查看該頁面。
- 在動作清單中選取一個動作,即可查看該動作前和後的頁面。
- 使用 定位器、呼叫、記錄、錯誤、主控台、網路、來源 和 附件 索引標籤來查看各個動作的詳細資料。
- 在 Trace Viewer 中開啟該工作階段,以進行更深入的分析。
若要返回清單,請選取 「檢視所有工作階段」。
停止記錄工作階段
若要停止錄製新的工作階段,請從 MCP 用戶端設定中移除 x-ms-enable-sessionartifacts 標頭。 現有的錄音會保留在您的儲存帳戶中,直到您刪除它們,或直到您的儲存帳戶的資料保留設定將其移除為止。
資料存放位置
所有工作階段錄製及其他產物都會儲存在您連結至工作區的 Azure 儲存帳戶中。 您擁有並控制此儲存帳戶,包括其區域、存取權限、網路設定及資料保留。
劇作家工作區 僅儲存列出和管理工作階段所需的元資料,例如工作階段名稱與 ID、建立者、狀態、開始與結束時間、可計費時間、來源類型及瀏覽器類型。 劇作家工作區 不會儲存瀏覽器工作階段中的任何用戶端資料,例如頁面內容、截圖、影片、追蹤、主控台訊息或網路流量。