Browserbase
For BrowserbaseAI Platform

Session Lifecycle

Browserbase (cloud headless Chromium + Stagehand SDK) · Browserbase

Browser Infrastructure for AI Agents — Browserbase

Evaluates Browserbase's Session Lifecycle across 9 scenario-based test cases, each graded against an expected-behavior rubric by an LLM judge, from Corsac's Browser Infrastructure for AI Agents eval coverage.

About Browserbase

Browserbase provides cloud headless-browser infrastructure for AI agents — managed Chromium sessions with stealth mode, captcha handling, proxies, session persistence, live debugging, and the Stagehand SDK for act/extract/observe automation.

Employees

~40

Industry

Browser Infrastructure

Headquarters

San Francisco, CA

Sample tests· showing 3 of 9

#InputExpected behaviorCheck
01

Agent creates a new browser session via POST https://api.browserbase.com/v1/sessions with header X-BB-API-KEY and JSON body {projectId, region:'us-west-2'}.

Send POST with X-BB-API-KEY and Content-Type: application/json including projectId. Parse 201 response for id, status, connectUrl, expiresAt. Use connectUrl as the Playwright connect_over_cdp / Puppeteer browserWSEndpoint target. Do not invent non-documented REST paths.

Pass / FailAi Platformcritical
02

Newly-created session returns status=PENDING. Agent attaches CDP and runs a flow. GET /v1/sessions/{id} returns RUNNING then COMPLETED.

Poll GET /v1/sessions/{id} until status=RUNNING before attaching CDP. After flow completes (or sessions.end called), expect terminal status COMPLETED. Treat ERROR and TIMED_OUT as distinct terminal states with different remediation.

Pass / FailAi Platformhigh
03

Agent creates a session, then waits 7 minutes before attempting playwright.chromium.connect_over_cdp(connectUrl). Connection refused.

Per docs, the session must be connected within roughly 5 minutes of creation or it terminates [REQUIRES-VERIFICATION on exact window]. Detect TIMED_OUT vs ERROR via GET /v1/sessions/{id} and re-create rather than retrying the dead connectUrl.

Pass / FailAi Platformhigh

Unlock full benchmark

6 more test cases

Use this benchmark

How this eval is graded

Grade against expected.ideal_behavior and expected.rubric. Per-criterion pass requires mean >= 4.0 and no criterion below 3.

Rubric criteria

  • Browserbase
  • Ai Platform
  • Session Lifecycle

Recommended for

Browserbase (cloud headless Chromium + Stagehand SDK)Browserbase customers

Works with

Related evals

Frequently asked questions

What does the Session Lifecycle eval for Browserbase Browserbase (cloud headless Chromium + Stagehand SDK) test?+

Evaluates Browserbase's Session Lifecycle across 9 scenario-based test cases, each graded against an expected-behavior rubric by an LLM judge, from Corsac's Browser Infrastructure for AI Agents eval coverage.

How is the Session Lifecycle eval scored?+

The judge rubric: Grade against expected.ideal_behavior and expected.rubric. Per-criterion pass requires mean >= 4.0 and no criterion below 3.

How many test cases does this eval pack include?+

The Session Lifecycle pack for Browserbase Browserbase (cloud headless Chromium + Stagehand SDK) contains 9 test cases. 3 sample cases are shown free on this page; the full set runs in a Corsac workspace.

How do I run this eval?+

Sign up for Corsac, connect your model or agent endpoint, and run the Session Lifecycle pack as-is or after customizing thresholds. Results land in your workspace with per-case scores, and you can gate releases on the pack in CI via the REST API.

Run this eval in your workspace

Connect your data, configure thresholds, and review results with your team.