Cloudflare 에이전트, 탭을 나눠도 로그인은 공유한다

브라우저 세션이 살아 있는 동안 상태를 유지한다

Cloudflare가 10월 13일 공개한 Agents SDK의 persistent browser는 에이전트가 이전에 열어 둔 웹페이지로 돌아가 작업을 이어가게 한다. SDK v0.28.0 이상에서 제공하며, 모델은 Chrome DevTools Protocol을 사용하는 코드를 통해 브라우저를 조작한다.

원격 브라우저는 에이전트의 Durable Object 밖에서 실행된다. 객체가 유휴 상태에 들어가도 세션 식별자로 다시 연결할 수 있지만, 원격 브라우저 자체가 살아 있어야 한다. 이 도구의 기본 유휴 제한은 10분이다.

세션이 만료되거나 브라우저가 닫히면 다음 호출은 새 브라우저를 사용한다. 같은 대화에서 다시 호출했을 때 결과에 표시되는 restarted: true는 이전 탭과 로그인 상태를 잃었다는 뜻이다. 이전 계정으로 자동 복구됐다는 의미가 아니다.

대화마다 탭이 달라도 로그인은 공유된다

Agents의 Browser 문서에 따르면 Pi 대화는 기본적으로 각자의 활성 탭을 갖는다. 그러나 같은 Browser 안의 쿠키와 로그인은 공유한다. 탭을 나누는 것만으로 사용자 계정이 분리되지는 않는다.

이는 탭과 브라우저 컨텍스트의 차이이기도 하다. Browser Run의 일반 세션 재사용 예제는 쿠키와 저장소를 격리하려고 요청마다 별도 브라우저 컨텍스트를 만든다. Agents의 대화별 탭이 이 컨텍스트를 자동으로 만드는 것은 아니다.

Agents 문서는 사용자별로 독립된 로그인이 필요하면 별도 브라우저를 쓰도록 안내한다. 여러 대화가 같은 계정으로 작업해야 하는지, 사용자마다 계정이 달라야 하는지를 먼저 정해야 한다.

Quick Actions에는 기존 로그인이 따라가지 않는다

Browser Run은 단발성 캡처·PDF·수집을 위한 Quick Actions와 직접 브라우저를 조작하는 Browser Sessions를 구분한다. 이미 연 페이지를 다시 조작하는 작업에는 상태를 유지하는 세션이 필요하다.

Quick Action 도구 문서는 browserTool로 로그인한 사이트라도 Quick Action에 그 로그인이 공유되지 않는다고 명시한다. 보호된 페이지를 읽으려면 해당 호출에 쿠키 등 인증 옵션을 따로 전달해야 한다.

중단된 호출은 완료 여부부터 살펴야 한다

브라우저는 유휴 시간 외에도 연결 오류나 브라우저 오류, 인프라 교체 때문에 끝날 수 있다. Browser Run의 종료 원인은 대시보드의 Runs 탭에서 확인할 수 있다.

Pi는 실행 인스턴스가 내려가면서 중단된 브라우저 호출을 자동 재실행하지 않는다. 같은 호출을 다시 실행하면 폼 제출이나 버튼 클릭이 두 번 일어날 수 있기 때문이다. 중단 처리 문서에 따르면 모델은 중단 결과를 받고 후속 동작을 정한다.

대화를 중지해도 이미 실행 중인 브라우저 호출이 취소되지는 않는다. 호출은 완료되거나 자체 시간 제한에 도달한다. 따라서 중단 뒤에는 작업 결과와 로그인 상태를 살핀 다음 후속 요청을 정해야 한다. 대화의 기록, 원격 브라우저의 수명, 사이트에서 이미 끝난 동작은 각각 따로 확인할 대상이다.

자주 묻는 질문