playwright-screenshot
열려 있는 브라우저 세션의 현재 화면을 PNG 로 파일 스토어에 저장하고 URL 을 반환합니다.
download_url 은 인라인으로 제공되므로 답변에  형태로 이미지를 첨부할 수 있습니다. 화면 내용을 판독해야 할 때는 sonar_url 을 sonar-ai-ask-image 에 넘깁니다.
저장된 파일은 호출한 사용자 소유이며 설정된 보존 기간이 지나면 만료됩니다.
playwright-screenshot session-id=값 [label=값] [full-page=값]
- session-id=값
- 필수. 캡처할 브라우저 세션. 예: playwright-open 이 반환한 session_id
- label=값
- 선택. 저장 파일 이름에 포함됩니다. 예: policy-list
- full-page=값
- 선택. 미지정 시 f 이며 보이는 영역만 캡처합니다. 긴 목록 화면은 전체 캡처가 수 메가바이트에 이를 수 있기 때문입니다. 스크롤 전체를 캡처하려면 t 를 지정합니다.
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| session_id | 문자열 | 세션 식별자 | 예: 6f1c2a08-6c1e-4a1b-9a5e-9b2f0d3c7e11 |
| url | 문자열 | URL | 캡처한 페이지. 예: https://fw.example.com/policy/list |
| title | 문자열 | 페이지 제목 | 예: 정책 - 방화벽 콘솔 |
| file_guid | 문자열 | 파일 식별자 | 예: 3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| file_name | 문자열 | 파일 이름 | 예: policy-list-20260905-101530-412.png |
| file_size | 64비트 정수 | 파일 크기 | 바이트 단위. 예: 24680 |
| download_url | 문자열 | 다운로드 URL | 인라인으로 제공됩니다. 예: /files/3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| sonar_url | 문자열 | 파일 스토어 URL | 예: sonar://3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| error | 문자열 | 오류 | 캡처가 거부된 경우 설정됩니다. 예: page is not ready |