AI 에이전트가 극작가 작업 공간의 원격 MCP 서버를 사용할 때, 실시간으로 감시하지 않는 클라우드 브라우저를 구동합니다. 세션 녹화는 그 브라우저에서 어떤 일이 있었는지에 대한 완전한 기록을 제공합니다. 극작가 작업 공간는 각 브라우저 세션의 아티팩트를 사용자가 소유한 Azure 스토리지 계정에 저장하며, 이를 Azure 포털의 작업 공간 활동 로그 페이지에서 다시 재생합니다.
세션 녹화를 통해 에이전트가 수행한 모든 작업을 단계별로 확인하고, 각 작업 전후 페이지를 확인하며, 콘솔 메시지, 네트워크 요청, 브라우저가 생성한 오류를 확인할 수 있습니다.
세션 녹화를 사용할 때
세션 녹화는 다음과 같은 상황에서 도움이 됩니다:
- 실패했거나 예기치 않은 에이전트 실행을 디버그합니다. 에이전트가 오류를 보고하거나, 작업 도중 중단하거나, 잘못된 결과를 반환하면, 세션을 다시 재생하여 정확한 오류가 발생한 단계를 찾아보세요. 예를 들어 선택자가 일치하지 않거나, 로드를 완료하지 않은 페이지, 다음 동작을 차단한 대화 등이 그것입니다.
- 에이전트가 무엇을 했는지 확인하세요. 결과에 의존하기 전에 에이전트가 의도한 대로 작업을 완료했는지, 예를 들어 양식에 올바른 값을 입력했는지 또는 올바른 기록을 제출했는지 확인하세요.
- 에이전트 활동을 감사하고 검토하세요. 에이전트가 비즈니스 애플리케이션에서 수행한 작업을 검토 가능한 기록으로 유지하여, 팀이 거버넌스나 컴플라이언스를 위해 에이전트 행동을 검토할 수 있도록 하세요.
- 비공개 애플리케이션이나 인증된 애플리케이션의 문제를 조사하세요. 브라우저가 사설 호스팅 애플리케이션, 로그인 페이지 또는 싱글 사인온을 사용하는 사이트에 접속했을 때 네트워크 장애 및 리디렉션 등 어떻게 동작했는지 확인하세요.
- 프롬프트와 에이전트 지침을 개선하세요. 성공 및 실패한 실행 녹화를 비교하여 에이전트가 페이지를 어떻게 해석하는지 이해하고 프롬프트나 지침을 다듬으세요.
- 증거를 팀과 공유하세요. 개발자, 테스터 또는 지원 엔지니어에게 문제를 보여주는 녹화본을 제공하세요. 문제에 대한 서면 설명 대신에요.
세션 기록의 아티팩트
각 녹화된 세션에는 다음과 같은 아티팩트가 포함되어 있습니다:
| 유물 | Description |
|---|---|
| 세션 세부 정보 | 세션 요약: 세션 이름과 ID, 생성자, 상태, 시작 및 종료 시간, 청구 가능한 시간, 소스 유형(예: MCP 또는 브라우저 자동화 도구), 소스 ID, 브라우저 유형. |
| 세션 재생 (추적) | Azure 포털이나 Trace Viewer에서 재생하는 세션의 Playwright 추적입니다. 세션의 타임라인과 페이지 스냅샷이 포함되어 있어 세션의 어느 시점으로든 이동할 수 있습니다. |
| Actions | 에이전트가 수행한 브라우저 작업 목록(탐색, 클릭, 입력, 스크립트 평가 등)과 각 작업 지속 시간. 각 동작에 대해 작업 전 페이지와 후 페이지를 볼 수 있습니다. |
| 스크린샷과 동영상 | 세션 동안 브라우저가 표시한 페이지의 시각적 캡처. |
| 콘솔(Console) | 페이지가 브라우저 콘솔에 기록한 경고 및 오류 메시지. |
| Network | 브라우저가 수행한 네트워크 요청과 해당 URL, 상태 코드, 타이밍입니다. |
| 오류 | 세션 중에 발생한 오류(예: 실패한 동작 및 페이지 오류). |
| 로그 | 각 동작에 대한 상세한 로그, 호출 매개변수, 로케이터, Playwright가 수행한 단계 등이 포함됩니다. |
| 메타데이터 및 첨부 파일 | 브라우저 및 뷰포트 세부 정보와 세션에 첨부된 모든 파일 등 세션 메타데이터. |
Prerequisites
시작하기 전에 다음 항목이 있는지 확인합니다.
- 활성 구독이 있는 Azure 계정. Azure 구독이 없는 경우 무료 계정을 만드십시오.
- Azure 계정의 소유자, 기여자 또는 클래식 관리자 역할 중 하나
- Azure 포털이 관리 신원에 저장 권한을 할당하도록 하려면, 저장 계정에 대해 Owner, User Access Administrator, 또는 Role Based Access Control Administrator와 같은 역할을 할당할 수 있는 역할을 지정해야 합니다. 이 역할 중 하나가 없다면, 권한이 있는 사람에게 권한을 할당해 달라고 요청하세요.
- GitHub Copilot 앱, GitHub Copilot Visual Studio Code 또는 GitHub Copilot CLI와 같이 극작가 작업 공간 원격 MCP 서버에 연결된 MCP 클라이언트입니다. 이를 설정하려면 빠른 시작: 원격 MCP 서버로 브라우저 작업 자동화를 참조하세요.
관찰 가능성을 켜고 스토리지를 구성
세션 녹음은 작업 공간과 연결된 Azure 스토리지 계정에 저장됩니다. 극작가 작업 공간는 관리 ID를 사용하여 해당 스토리지 계정에 아티팩트를 기록합니다. 이 구성을 설정하려면 관찰 가능성을 켜고, 스토리지 계정을 선택한 후 관리 ID를 선택하세요. 새 작업 공간을 만들거나 기존 작업 공간을 업데이트할 수 있습니다.
Azure 구독에 대한 자격 증명을 사용하여 Azure Portal에 로그인합니다.
포털 홈 페이지에서 Azure 앱 테스트를 검색하여 선택합니다.
Azure 앱 테스트 허브에서 극작가 작업 공간 아래의 생성을 선택합니다.
Playwright 작업 영역 만들기 페이지의 기본 사항 탭에서 다음 정보를 입력하세요:
Field Description 구독 이 Playwright 작업 영역에 사용할 Azure 구독을 선택합니다. 리소스 그룹 기존 리소스 그룹을 선택합니다. 또는 새로 만들기를 선택하고 새 리소스 그룹의 고유한 이름을 입력합니다. 이름 작업 영역의 고유한 이름을 입력합니다. 이름에는 영문자, 숫자, 하이픈(-)만 사용할 수 있으며, 길이는 3자 이상 24자 이하여야 합니다. 위치 작업 영역에 대한 지리적 위치를 선택합니다. 기능 탭을 선택한 후 다음 정보를 입력하세요:
Field Description Observability 보고서, 추적 및 세션 녹화를 캡처하려면 이 기능을 켜십시오. 스토리지 계정 기존 스토리지 계정을 선택하거나 새로 만들기 를 선택하여 계정을 생성하세요. 극작가 작업 공간는 세션 녹음 및 기타 산출물을 이 저장 계정에 저장합니다. 관리 ID 유형 극작가 작업 공간가 스토리지 계정에 접근할 때 사용하는 관리 신원을 선택하세요: 시스템 할당 또는 사용자 할당. 사용자 할당을 선택하면 사용자 할당된 관리 신원을 선택하세요. 신원 권한 Azure 포털이 스토리지 계정의 Storage Blob Data 기여자 역할을 관리 ID에 할당하도록 하려면 내 대신 관리 ID에 권한 할당을 선택합니다. 이 옵션은 스토리지 계정에 역할 할당 권한이 있는 경우에만 선택하세요. 그렇지 않다면 해당 기능을 지우고 수동으로 역할을 할당하세요. 선택적으로 태그 탭에 태그를 추가할 수 있습니다 . 태그는 여러 리소스와 리소스 그룹에 동일한 태그를 적용하여 자원을 분류하고 통합 청구서를 확인하는 데 사용하는 이름/값 쌍입니다.
Review + create를 선택합니다. 설정을 검토한 다음 만들기를 선택합니다.
작업 영역을 만드는 데 몇 분 정도 걸립니다. 포털에 배포가 완료되었다 고 표시될 때까지 기다렸다가 계속하세요.
Note
세션 기록, 리포팅, 브라우저 프로필과 같이 저장 계정이 필요한 모든 작업 공간 기능은 Capabilities 페이지에서 구성한 동일한 저장 계정과 관리 ID를 사용합니다.
Note
극작가 작업 공간 Observability는 세션 녹화 및 기타 산출물을 Azure Storage에 저장합니다. 스토리지 비용은 스토리지 계정의 데이터 보존 설정에 따라 달라집니다.
Note
아티팩트를 저장하려면, 스토리지 계정은 공용 엔드포인트를 통한 네트워크 액세스를 허용해야 합니다. 프라이빗 엔드포인트를 통해서만 접근을 허용하는 스토리지 계정은 현재 아티팩트 저장에 지원되지 않습니다.
관리 ID에 저장소 권한 할당
'내 대신 관리 신원에 권한 할당'을 해제했거나, 스토리지 계정에서 역할 할당 권한이 없다면 수동으로 역할을 할당하세요. 필요한 권한이 없다면, 스토리지 계정에서 Owner, User Access Administrator 또는 Role Based Access Control Administrator 역할을 가진 사람에게 이 단계를 완료하도록 요청하십시오.
Azure 포털에서 작업 공간과 연결된 스토리지 계정으로 이동하세요.
액세스 제어(IAM)>추가>역할 할당 추가를 선택합니다.
역할 탭에서 Storage Blob Data Contributor를 검색하여 선택한 다음 다음을 선택합니다.
구성원 탭에서 액세스 권한 할당을 위해관리 ID를 선택합니다.
구성원 선택을 선택한 다음, 작업 영역에 대해 선택한 관리 ID를 선택하세요:
- 시스템 할당 ID의 경우, 관리 ID 유형으로 Playwright Workspace를 선택한 후 작업 영역을 선택하세요.
- 사용자 할당 신원을 위해 사용자 할당 관리 식별자를 선택한 후 해당 신원을 선택하세요.
선택을 클릭한 다음 검토 및 할당을 클릭합니다.
Tip
역할 할당은 적용되기까지 몇 분이 걸릴 수 있습니다. 녹화가 바로 나타나지 않으면 몇 분간 기다린 후 세션을 다시 실행하세요.
MCP 클라이언트에서 세션 녹화를 켜기
원격 MCP 서버는 MCP 클라이언트가 요청할 때만 브라우저 세션을 기록합니다. 녹화를 켜려면 MCP 클라이언트의 원격 MCP 서버 구성에 다음 HTTP 헤더를 추가하세요:
| Header | 가치 |
|---|---|
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 포털에서 녹화를 보려면 연결된 스토리지 계정에 대한 읽기 권한이 필요하며, 해당 스토리지 계정이 Trace Viewer가 추적 파일을 로드할 수 있도록 허용해야 합니다.
녹화를 보는 사람에게 스토리지 역할 할당하기
Azure 포털에서 작업 공간과 연결된 스토리지 계정으로 이동하세요.
액세스 제어(IAM)>추가>역할 할당 추가를 선택합니다.
역할 탭에서 Storage Blob Data Reader를 검색하여 선택한 다음 다음을 선택합니다.
멤버 탭에서 세션 녹화를 볼 필요가 있는 모든 사람을 선택하고 추가합니다.
검토 + 할당을 선택합니다.
추적 뷰어가 스토리지 계정에서 읽을 수 있도록 허용하기
Azure 포털에서 연결된 스토리지 계정으로 이동하세요.
설정>리소스 공유(CORS)를 선택합니다.
Blob 서비스 탭에서 다음 값이 포함된 레코드를 추가하세요:
Field 가치 허용된 출처 https://trace.playwright.dev허용된 메서드 GET,OPTIONS최대 연령 2147483647와0사이의 값입니다.저장을 선택합니다.
녹화된 세션 검토
Azure 포털에서 Playwright 작업 공간으로 이동하세요.
브라우저 세션>브라우저 활동 로그를 선택하세요.
브라우저 활동 로그에는 작업 공간 내 브라우저 세션이 나열됩니다. 각 세션에는 세션 이름, 세션 ID, 생성자, 소스 유형, 시작 시간, 소스 ID, 청구 가능 시간, 브라우저 유형 및 상태가 표시됩니다. 세션을 찾으려면 시간 범위, 소스 유형, 상태 또는 소스 ID로 목록을 필터링하세요. MCP 클라이언트는 소스 유형이 Mcp인 세션을 생성합니다.
에이전트가 실행한 세션의 이름을 선택합니다.
세션 페이지에는 세션 세부 정보 와 세션 재생이 표시됩니다. 재생 과정에서 다음을 할 수 있습니다:
- 타임라인을 따라 이동하면 세션 중 어느 시점에서든 페이지를 볼 수 있습니다.
- 작업 목록에서 작업을 선택하여 작업 전 및 후 페이지를 확인하세요.
- 로케이터, 호출, 로그, 오류, 콘솔, 네트워크, 소스, 첨부 파일 탭을 사용하여 각 작업의 세부 정보를 확인하세요.
- 세션을 Trace Viewer 에서 열어 더 깊은 분석을 진행하세요.
목록으로 돌아가려면 '모든 세션 보기'를 선택하세요.
세션 기록 중지
새 세션 기록을 중지하려면 MCP 클라이언트 구성에서 x-ms-enable-sessionartifacts 헤더를 제거하세요. 기존 녹음은 삭제하거나 저장 계정의 데이터 보존 설정에서 삭제될 때까지 저장 계정에 남아 있습니다.
데이터 저장 위치
모든 세션 녹음 및 기타 아티팩트는 작업 공간에 연결된 Azure 스토리지 계정에 저장됩니다. 귀하는 이 저장소 계정과 해당 지역, 액세스, 네트워크 설정 및 데이터 보존을 소유하고 제어합니다.
극작가 작업 공간는 세션 이름과 ID, 생성자, 상태, 시작 및 종료 시간, 청구 가능 시간, 소스 유형, 브라우저 유형 등 세션을 나열하고 관리하는 데 필요한 메타데이터만 저장합니다. 극작가 작업 공간는 페이지 콘텐츠, 스크린샷, 동영상, 추적, 콘솔 메시지, 네트워크 트래픽과 같은 브라우저 세션에서 발생하는 클라이언트 측 데이터를 저장하지 않습니다.