docs: add Anthropic Managed Agents browser guide

[ziruihao]

Summary

Adds a cookbook guide showing how to equip Anthropic Managed Agents with the browse CLI for browser, search, and fetch tooling to navigate the web.

The guide walks through:

1. Creating an Environment with browse as a default npm package
2. Setting up a Credential vault for the Browserbase API key
3. Designing the agent system prompt
4. Example browser-agent use cases (E2E testing, research, web automation)

Contents

New folder guides/anthropic-managed-agents/:

• README.md — the guide
• 5 accompanying screenshots (co-located, referenced with relative paths)

🤖 Generated with Claude Code

[changeset-bot]

⚠️ No Changeset found

Latest commit: c7f907e

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[cubic-dev-ai]

No issues found across 6 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Architecture diagram

sequenceDiagram
    participant User as User (Developer)
    participant CLI as ant CLI
    participant AMA as Anthropic Managed Agents
    participant Env as Environment
    participant Browse as browse CLI
    participant BB as Browserbase Cloud
    participant Web as External Websites
    
    Note over User,Web: Managed Agent Browser Flow
    
    User->>CLI: ant beta:sessions create --agent --environment-id
    CLI->>AMA: Create session with environment config
    AMA->>Env: Load environment (npm packages, networking rules)
    
    Note over Env,Browse: Environment includes browse as default npm package
    
    AMA->>AMA: Execute agent system prompt
    Note over AMA: System prompt instructs agent to use browse CLI
    
    AMA->>Env: Run browse --help (progressive disclosure)
    Env->>Browse: Execute browse shell command
    Browse-->>Env: Return command interface docs
    Env-->>AMA: CLI help output
    
    AMA->>Env: browse launch --browser remote
    Env->>Browse: Start browser session
    
    alt Local Chromium
        Browse->>Browse: Launch headless Chromium
    else CDP Connection
        Browse->>Web: Connect via CDP endpoint
    else Browserbase Cloud (default for cloud agents)
        Env->>Env: Read BROWSERBASE_API_KEY from credential vault
        alt Credential vault configured
            Browse->>BB: Connect to remote browser session
            BB-->>Browse: Session URL / debug panel
            BB->>Web: Navigate to target URL
            Web-->>BB: Page content
            BB-->>Browse: Page state
        else No API key
            Browse-->>Env: Error: missing BROWSERBASE_API_KEY
            Env-->>AMA: Connection failed
        end
    end
    
    Browse-->>Env: Browser session ready
    Env-->>AMA: Session established
    
    Note over AMA,Browse: Agent uses browse commands (click, network, etc.)
    
    AMA->>Browse: browse click --selector ".button"
    Browse->>BB: Execute click
    BB-->>Browse: Click result
    Browse-->>AMA: Success
    
    AMA->>Browse: browse network --wait complete
    Browse->>BB: Monitor network
    BB-->>Browse: Page loaded
    Browse-->>AMA: Page state
    
    AMA->>Browse: browse screenshot
    Browse->>BB: Capture screenshot
    BB-->>Browse: Screenshot data
    Browse-->>AMA: Visual result
    
    Note over User,BB: Optional: User debugs live session
    
    User->>BB: View session in browserbase.com/sessions
    BB-->>User: Live browser view
    
    Note over AMA,Web: Networking rules apply
    
    alt Unrestricted networking
        Browse->>Web: Full internet access
    else Limited networking
        Browse->>Web: Only allowed hosts (e.g., *.browserbase.com)
    end
    
    alt E2E Testing
        AMA->>Browse: browse evaluate --script "checkA11y()"
        Browse-->>AMA: Accessibility violations
    else Research
        AMA->>Browse: browse search "query"
        Browse-->>AMA: Search results
    else Web Automation
        AMA->>Browse: browse fill form + submit
        Browse-->>AMA: Form submitted
    end

Loading

_{Re-trigger cubic}