빠른 소식

Cloudflare Agents SDK, 대화 사이 탭·로그인을 유지하는 브라우저 도구 추가

·설명 약 2분·작성: 해비·블로그 소개

이번 소식

Cloudflare가 AI 에이전트가 다음 대화에서도 돌아와 사용할 수 있는 브라우저 도구 browserTool을 소개했습니다. Browser Run 브라우저의 세션이 살아 있는 동안 탭, 쿠키, 로그인 상태를 유지합니다. 공식 발표일은 2026년 10월 13일이며, 한국시간으로 환산할 세부 발표 시각은 공개되지 않았습니다.

달라진 점

모델은 브라우저를 제어하는 통신 규약인 Chrome DevTools Protocol(CDP)을 이용하는 코드를 작성해 브라우저를 다룹니다. 화면 캡처는 이미지 형태로 반환되므로, 이미지를 처리할 수 있는 모델과 사용자 화면에서 이를 활용할 수 있습니다.

브라우저는 대화의 한 차례 응답이 끝난 뒤에도 유지되며, 실행 기반인 Durable Object가 잠시 쉬는 최대 절전 상태에서도 세션이 이어집니다. Pi의 각 대화에는 기본적으로 별도의 활성 탭이 배정되지만, 같은 브라우저 안의 쿠키와 로그인 상태는 공유됩니다.

어떤 점이 달라지나요?

매 대화마다 완전히 새 브라우저를 여는 대신, 에이전트가 이전 탭과 로그인 상태를 이어서 사용할 수 있는 기반이 생겼습니다. 다만 대화별 탭이 나뉜다는 것과 로그인 정보까지 대화별로 분리된다는 것은 다릅니다. 같은 브라우저를 쓰는 대화 사이에서는 로그인 공유 조건을 고려해야 합니다.

사용 전 확인할 점

Agents SDK 0.28.0 이상이 필요합니다. 개발자는 Browser를 만들고 객체 수명 주기에 등록한 뒤, PiDurable의 실행 환경을 열기 전에 확장 레지스트리에 도구를 추가해야 합니다. AI SDK·TanStack AI 어댑터나 공개 Browser/CDP API를 이용하는 다른 실행 환경에서도 사용할 수 있습니다.

로그인이 영구 보존되는 기능은 아닙니다. 기본 유휴 제한 시간은 10분입니다. 세션이 만료되거나 브라우저가 비정상 종료되면 새 브라우저가 만들어지고 restarted: true가 반환되며, 이전 탭과 로그인 상태는 사라집니다. 따라서 작업을 이어가기 전에 재시작 여부와 현재 로그인 상태를 확인하도록 구성해야 합니다.

원문 출처 보기 →

이 소식이 도움이 되었나요?

댓글 0

이 글을 쓴 해비

웹사이트를 제작·운영하고, 개인 서비스와 자동화·AI 도구를 만듭니다. 직접 만들며 배운 내용과 문제 해결 과정을 BlogFlow에 기록합니다.

새 글 받아보기

RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.

RSS 피드 구독하기

댓글 남기기