브라우저 자동화
모바일 앱과 daemon API 기준의 브라우저 제어, 쿠키, 스크린샷 흐름
앙스키의 브라우저 자동화는 daemon이 실제 브라우저 세션을 소유하고, 모바일 앱이 채팅 안에서 상태를 보여주는 구조입니다. 웹앱은 더 이상 에이전트 채팅이나 브라우저 PiP 화면을 제공하지 않으며, 인증/연결/API/BFF 표면만 유지합니다.
현재 구조
| 영역 | 역할 |
|---|---|
| Daemon | 브라우저 세션 실행, 스크린샷 생성, browser_action 처리 |
| 모바일 앱 | 채팅 내부 브라우저 오버레이, 스크린샷 확인, 도구 승인 |
| 웹앱 | daemon 연결 저장, bridge/API proxy, 문서와 landing |
웹 PiP 제거
기존 웹 채팅의 플로팅 PiP와 워크스페이스 브라우저 패널은 모바일 중심 개편에서 제거되었습니다. 브라우저 상태 확인과 수동 보조는 모바일 채팅 화면 안에서 진행합니다.
모바일 브라우저 오버레이
모바일 앱에서는 에이전트가 브라우저 도구를 사용하면 채팅 화면 안에 브라우저 오버레이가 표시됩니다.
- 에이전트의 현재 브라우저 화면을 스크린샷/프레임으로 확인
- 필요한 경우 채팅 흐름 안에서 도구 실행을 승인하거나 거절
- 브라우저 작업 결과를 메시지와 같은 맥락에서 검토
- 스크린샷은 daemon bridge API를 통해 모바일 UI에 전달
쿠키와 인증 상태
에이전트 브라우저에 인증 상태가 필요하면 쿠키 가져오기 흐름을 사용합니다. 쿠키에는 세션 토큰이 포함될 수 있으므로 신뢰할 수 있는 작업과 대상 도메인에만 사용해야 합니다.
일반 흐름:
- 모바일 앱에서 대상 에이전트 또는 작업 컨텍스트를 선택합니다.
- 대상 도메인의 쿠키를 가져옵니다.
- daemon이 에이전트 브라우저 세션에 쿠키를 주입합니다.
- 에이전트가 로그인된 상태로 웹사이트를 탐색합니다.
쿠키 보안
쿠키는 암호처럼 취급하세요. 공유 범위를 최소화하고, 필요하지 않은 도메인의 쿠키는 가져오지 않는 것이 좋습니다.
API 표면
웹 서버는 브라우저 화면 자체를 렌더링하지 않지만, 모바일/daemon 흐름을 위한 bridge API는 유지합니다.
/api/codex-bridge/browser-action/api/codex-bridge/browser-frames/api/codex-bridge/browser-screenshots/[agentId]/[ref]/api/codex-bridge/browser-status
이 API들은 daemon과 클라이언트 사이의 인증된 통신 경로이며, 사용자가 직접 조작하는 웹 화면을 대체하지 않습니다.