Univer AI 에이전트 통합 출시 전 검수 체크리스트: 2026 맥 브라우저 회귀 테스트

에이전트 시연은 통과했지만, 실제 편집 상태나 맥 브라우저에서의 동작은 확인하지 못했나요?
출시 전에는 문서 상태, 에이전트 권한, 브라우저 상호작용, 예외 복구를 따로 검증하고 증거를 남기세요. 지원 대상으로 정한 환경에서만 회귀 결과를 판단해야 합니다.

Univer 통합 개발자는 편집기 안에서 에이전트가 할 수 있는 일과 할 수 없는 일을 확인할 수 있습니다.
QA 엔지니어는 맥 브라우저 회귀 시나리오와 실패 기록 방법을 정리할 수 있습니다.
제품 기술 책임자는 권한과 복구 조건, 출시 근거가 갖춰졌는지 점검할 수 있습니다.

검수 범위의 기준점

Univer의 공식 저장소와 문서는 제품 기능과 개발 정보를 확인하는 기준입니다. 다만 특정 AI 에이전트가 특정 명령을 수행한다는 사실이나 특정 맥 브라우저 조합에서 호환된다는 사실까지 자동으로 보증하지는 않습니다. Univer 공식 저장소와 시트 빠른 시작 문서를 기준으로 제품에서 사용하는 편집기와 기능 범위를 확인하고, 실제 통합 동작은 프로젝트 테스트로 입증해야 합니다.

먼저 실제 사용자 흐름을 하나씩 나눕니다. 사용자가 요청을 입력하는 시점, 에이전트가 편집 명령을 만드는 시점, 편집기가 이를 반영하는 시점, 저장 여부를 확인하는 시점을 구분하면 실패 위치를 찾기 쉬워집니다. 표에서는 셀 편집을, 문서에서는 내용 수정이나 서식 변경을 골라 제품에서 실제로 제공하는 작업만 검수 대상으로 정합니다. 발표 자료를 제품에서 사용하지 않는다면 억지로 테스트 범위에 넣을 필요가 없습니다.

• [ ] 사용자가 시작하는 동작과 에이전트가 실행하는 동작을 분리해 적습니다.
• [ ] 대상 문서 유형과 실제로 사용하는 편집 기능을 정합니다.
• [ ] 공식 문서에 설명된 기능과 프로젝트 자체 구현을 구분합니다.
• [ ] 정상 완료, 취소, 실패, 재요청 상황을 각각 테스트 대상으로 둡니다.

주의: 커스텀 명령으로 편집 동작을 확장한 경우에도, 명령이 있다는 사실만으로 권한 확인이나 안전한 실행이 보장되지는 않습니다. Univer의 사용자 지정 명령 안내와 제품의 실제 구현을 함께 확인하세요.

편집 상태와 결과 확인

에이전트가 “완료”라고 응답했는지만 확인하면 데이터 불일치를 놓칠 수 있습니다. 작업 전후 값을 비교하고, 변경을 허용한 범위 밖의 셀이나 콘텐츠가 그대로인지 살핍니다. 화면의 저장 표시와 제품이 제공하는 저장 확인 방법도 함께 기록합니다. 저장 상태를 확인할 수 없다면 검수 기록에 그 한계를 명시하고, 저장됐다고 추정해서는 안 됩니다.

Univer 문서에 정리된 시트 핵심 기능은 사용 중인 편집 기능을 찾아 테스트 대상을 좁히는 데 참고할 수 있습니다. 그러나 프로젝트가 연결한 에이전트의 프롬프트, 명령 변환, 저장 절차까지 해당 문서가 보증한다고 해석하면 안 됩니다.

• [ ] 실행 전 문서 상태를 캡처하거나 재현 가능한 초기 상태로 준비합니다.
• [ ] 작업 대상의 값, 내용, 서식 중 무엇이 바뀌어야 하는지 기록합니다.
• [ ] 대상 밖의 인접 셀이나 콘텐츠가 바뀌지 않았는지 확인합니다.
• [ ] 취소 뒤 상태가 기대한 대로 돌아오는지 확인합니다.
• [ ] 같은 요청을 다시 실행했을 때 추가 변경이 생기는지 확인합니다.
• [ ] 완료 응답, 화면 상태, 저장 확인 결과가 서로 맞는지 대조합니다.

권한과 멈춤 조건

에이전트가 작업할 수 있는 범위는 테스트로 확인해야 할 제품 요구사항입니다. 에이전트에 편집 권한을 줄지, 특정 문서나 선택 영역에만 허용할지, 삭제나 대량 수정처럼 영향이 큰 작업에 별도 확인을 요구할지는 구현과 정책에 따라 다릅니다. 이를 Univer의 기본 제공 동작처럼 표현하지 말고, 프로젝트가 실제로 구현한 권한 경계로 기록하세요.

• [ ] 허용 목록에 없는 대상이나 명령을 요청했을 때 거부되는지 확인합니다.
• [ ] 제품 정책상 확인이 필요한 동작은 실행 전에 확인 단계가 나타나는지 살핍니다.
• [ ] 오류가 난 뒤 에이전트가 추가 작업을 이어 가지 않고 멈추는지 확인합니다.
• [ ] 사용자가 취소했을 때 진행 중인 후속 작업도 중단되는지 확인합니다.
• [ ] 권한 거부와 실행 실패가 로그 및 화면에서 구분되는지 확인합니다.

한 번의 거부 성공으로 모든 우회 경로가 막혔다고 결론 내릴 수는 없습니다. 직접 명령 요청, 선택 영역 변경 후 재요청, 화면 새로 고침 뒤 재시도처럼 제품에서 가능한 경로를 골라 점검하고 각각의 결과를 남깁니다.

맥 브라우저 상호작용과 중단 복구

맥 브라우저 테스트에서는 편집 결과뿐 아니라 사용자가 입력을 이어 갈 수 있는지도 확인합니다. 입력창과 편집 영역 사이의 포커스 이동, 키보드 단축키, 스크롤, 메뉴와 대화상자의 위치, 창 크기 변경에 따른 레이아웃을 살핍니다. W3C의 포커스 순서 안내는 키보드 이동 순서를 검토할 때 참고할 수 있습니다.

실제 대상 브라우저와 운영체제 버전, 배포 환경을 테스트 기록에 함께 적습니다. 브라우저 자동화 도구를 쓰는 경우에도 Playwright가 안내하는 브라우저 실행 환경과 테스트 대상이 동일하다고 가정하지 말고, 실제 사용자 환경에서 확인할 항목을 따로 둡니다. 사파리에서 요소와 이벤트를 살펴볼 때는 웹 검사 도구 안내를 참고할 수 있습니다.

페이지 전환이나 탭 숨김에 따라 작업 상태가 달라지는 제품이라면 브라우저의 페이지 가시성 이벤트도 확인 대상입니다. 페이지 가시성 인터페이스 문서는 visibilityState와 visibilitychange를 설명합니다. 이 값만으로 저장이나 복구가 보장되는 것은 아니므로, 실제 작업이 중단되거나 재개되는 동작은 제품에서 별도로 관찰해야 합니다.

• [ ] 대상 맥 브라우저와 운영체제 버전을 기록합니다.
• [ ] 키보드만으로 입력, 실행, 취소, 팝업 닫기가 가능한지 확인합니다.
• [ ] 스크롤 중 도구 모음이나 대화상자가 의도치 않게 사라지지 않는지 살핍니다.
• [ ] 창 크기 변경과 페이지 새로 고침 뒤 편집기 상태를 확인합니다.
• [ ] 연결 중단 뒤 재접속했을 때 작업이 이어지는지, 취소되는지 확인합니다.
• [ ] 반복 제출 뒤 중복 수정이나 일부만 반영된 상태가 생기는지 확인합니다.

경험: 자동화 테스트의 재시도는 실패한 테스트를 다시 실행하는 설정이지, 제품의 데이터 복구를 증명하는 기능이 아닙니다. Playwright의 테스트 재시도 안내를 참고하되, 재시도 전후 문서 상태와 로그를 따로 비교하세요. 브라우저 컨텍스트 문서에 설명된 격리 기능을 활용하더라도, 테스트 환경의 격리와 실제 사용자 세션의 권한 검증은 서로 다른 항목입니다.

증거 기록과 통과 판단

각 결과를 다른 담당자가 재현할 수 있도록 기록합니다. 판정 기준은 제품 위험과 팀의 출시 정책에 따라 프로젝트에서 정해야 합니다. 모든 제품에 적용되는 공통 통과율이나 호환 보장 범위를 임의로 만들지 않습니다.

검수 선택지	확인할 대상	판단 근거
사용자 흐름 중심	요청부터 편집, 저장 확인까지	실제 제품에서 지원하는 흐름인지
권한 경계 중심	허용, 거부, 확인, 중단	정책과 실제 동작이 일치하는지
맥 브라우저 중심	포커스, 단축키, 스크롤, 레이아웃	기록한 환경에서 재현되는지
장애 복구 중심	새로 고침, 연결 중단, 반복 제출	상태가 복구되거나 안전하게 멈추는지

기록 항목	남길 내용
테스트 식별자	팀이 정한 시나리오 이름 또는 번호
대상 환경	운영체제, 브라우저, 배포 환경과 확인 시점
사전 상태	문서 내용, 선택 영역, 로그인 및 권한 조건
실행 절차	사용자 동작과 에이전트 요청, 중단 조건
기대 결과	변경되어야 할 항목과 유지되어야 할 항목
실제 결과	화면, 로그, 문서 상태와 저장 확인 내용
증거 및 결함	캡처나 로그 위치, 재현 절차, 결함 추적 링크
판정과 재검수	프로젝트가 정한 기준, 수정 뒤 다시 확인할 항목

자주 묻는 질문

Univer에 AI 에이전트를 붙인 뒤 우선 확인할 기능은 무엇인가요?

사용자와 에이전트의 역할부터 분리하고, 실제로 사용하는 문서 작업을 대상으로 편집 전후 상태를 비교합니다. 정상 실행뿐 아니라 취소, 반복 요청, 권한 밖 작업, 저장 확인도 함께 살펴야 합니다. 문서에 있는 편집 기능 설명과 프로젝트가 직접 구현한 연결 동작을 구분하면 지원 범위에 대한 오해를 줄일 수 있습니다.

에이전트가 온라인 표를 제대로 바꿨는지는 어떻게 판단하나요?

요청한 대상의 값과 서식이 의도대로 바뀌었는지, 대상 밖의 셀은 유지됐는지, 저장 상태가 확인되는지 각각 대조합니다. 완료 응답만으로 판정하지 말고 작업 전후 증거를 남기세요. 취소와 반복 실행도 별도 시나리오로 돌려야 되돌리기 실패나 중복 변경을 찾을 수 있습니다.

맥 브라우저 회귀에서 빠뜨리기 쉬운 항목은 무엇인가요?

브라우저와 운영체제 버전을 기록하고 포커스 이동, 단축키, 스크롤, 대화상자 위치, 창 크기 변화를 확인합니다. 자동화 도구에서 통과한 결과는 실제 대상 브라우저의 확인을 대신하지 않습니다. 테스트하지 않은 버전이나 브라우저 조합까지 호환된다고 표현하지 말고, 검증한 환경만 결과에 포함하세요.

예외가 난 뒤 작업 복구는 어떤 순서로 확인하나요?

작업 중 연결을 끊거나 페이지를 새로 고친 뒤 문서와 로그의 상태를 확인합니다. 다시 연결하거나 요청을 재전송했을 때 중복 수정이나 부분 반영이 생기는지도 기록합니다. 재시도 동작과 제품의 저장 복구는 별개이므로, 팀에서 정한 복구 기준에 따라 실제 문서 상태를 판정해야 합니다.

공유된 자동화 환경만으로 검수하면 실제 맥 브라우저의 입력과 포커스 동작을 확인하기 어렵고, 개인 기기만 사용하면 환경 차이로 결과 재현이 흔들릴 수 있습니다. 반대로 장기간 반복되는 고정 부하나 물리 기기 연결이 필요한 테스트라면 전용 기기를 두는 편이 적합할 수 있습니다. 일시적인 출시 전 회귀 검증이라면 nuvcloud의 클라우드 맥 환경을 테스트 대상으로 활용해 실제 대상 브라우저에서 확인하고, 검수 환경과 증거를 함께 남길 수 있습니다. 테스트 위치에 맞는 한국 경로와 일본 경로를 확인한 뒤, 기록한 브라우저 조합과 시나리오로 검증을 진행하세요.

자주 묻는 질문

Univer에 AI 에이전트를 연결한 뒤 어떤 기능을 먼저 검수해야 하나요?

실제 제품에서 사용자가 시작하는 작업과 에이전트에 맡기는 작업을 먼저 구분합니다. 이어서 편집 전후의 셀 값이나 문서 내용, 서식, 저장 상태를 확인하고, 취소와 재실행, 권한 밖 요청의 차단 여부를 각각 기록합니다. Univer 문서에 명시된 편집기 기능과 프로젝트가 별도로 구현한 연결 동작도 구분해야 검수 범위를 과장하지 않습니다.

AI 에이전트가 온라인 표를 올바르게 수정했는지 어떻게 확인하나요?

화면에 표시된 결과만 보지 말고 작업 전 상태와 작업 후 상태를 같은 문서에서 비교합니다. 대상 셀의 값과 서식, 변경되지 않아야 할 인접 영역, 저장 표시를 확인하고 실행 로그나 재현 절차를 함께 남깁니다. 취소 후 원상태가 되는지, 동일 요청을 다시 보냈을 때 의도하지 않은 추가 변경이 생기는지도 별도 시나리오로 검사합니다.

맥 브라우저 회귀 테스트에서 놓치기 쉬운 항목은 무엇인가요?

대상 브라우저와 운영체제 버전을 먼저 기록한 뒤, 키보드 포커스 이동, 단축키, 스크롤, 팝업 위치, 창 크기 변경을 확인합니다. 포커스 순서는 시각적 배치만으로 판정하지 말고 키보드로 이동하며 점검합니다. 한 가지 환경에서 통과한 결과를 다른 브라우저나 버전까지 호환된다는 근거로 확대하지 않습니다.

Univer 통합 출시 전에 네트워크 중단과 작업 복구를 어떻게 확인하나요?

작업 도중 연결을 끊거나 페이지 상태를 바꾼 뒤, 화면과 서버 기록이 어떤 상태로 남는지 관찰합니다. 복구 후 같은 요청이 자동 또는 수동으로 다시 전달되는지도 확인하고, 중복 수정이나 일부만 반영된 상태가 생기는지 기록합니다. 재시도 횟수나 복구 정책은 구현마다 다르므로 실제 설정과 로그를 기준으로 통과 조건을 정해야 합니다.