AGBCLOUD

Appearance

Browser automation ​

What you’ll do ​

Create a browser session in AGB, connect via CDP (Playwright/Puppeteer), and automate pages using either code-driven automation or AGB’s AI Agent (Act/Observe/Extract).

Prerequisites ​

  • AGB_API_KEY
  • A valid browser image_id (e.g. agb-browser-use-1)
  • Python 3.10+ (for the examples below)
  • Playwright installed locally (to connect over CDP):
    • pip install playwright && python -m playwright install chromium

Quickstart ​

Minimal runnable example: create a browser session, initialize browser, connect via CDP, open a page, then clean up.

python
import asyncio
from agb import AGB
from agb.session_params import CreateSessionParams
from agb.modules.browser import BrowserOption
from playwright.async_api import async_playwright

async def main() -> None:
    agb = AGB()
    create_result = agb.create(CreateSessionParams(image_id="agb-browser-use-1"))
    if not create_result.success:
        raise SystemExit(f"Session creation failed: {create_result.error_message}")

    session = create_result.session
    try:
        ok = await session.browser.initialize_async(BrowserOption())
        if not ok:
            raise SystemExit("Browser initialization failed")

        endpoint_url = session.browser.get_endpoint_url()
        async with async_playwright() as p:
            browser = await p.chromium.connect_over_cdp(endpoint_url)
            page = await browser.new_page()
            await page.goto("https://example.com")
            print("Title:", await page.title())
            await browser.close()
    finally:
        agb.delete(session)

asyncio.run(main())
typescript
import { AGB, CreateSessionParams } from "agbcloud-sdk";
import { chromium } from "playwright";

const agb = new AGB();
const createResult = await agb.create(
  new CreateSessionParams({ imageId: "agb-browser-use-1" })
);
if (!createResult.success || !createResult.session) {
  throw new Error(`Session creation failed: ${createResult.errorMessage}`);
}

const session = createResult.session;
try {
  const ok = await session.browser.initialize(); // Uses default options
  if (!ok) throw new Error("Browser initialization failed");

  const endpointUrl = session.browser.getEndpointUrl();
  const browser = await chromium.connectOverCDP(endpointUrl);
  const page = await browser.newPage();
  await page.goto("https://example.com");
  console.log("Title:", await page.title());
  await browser.close();
} finally {
  await agb.delete(session);
}

Common tasks ​

This topic is large. The detailed content has been split into smaller pages:

Best practices ​

See: docs/browser/best-practices.md

Troubleshooting ​

See: docs/browser/troubleshooting.md