Stagehand Act Extract Observe

Stagehand init with env=BROWSERBASE. Agent calls await stagehand.page.act('click the Sign in button').

act() resolves a single high-level action against the live DOM via the model. Verify the resulting action via a post-click anchor (URL change, observe() result, or DOM presence of a known signed-in element). Do not chain multiple imperative steps in one act() string.

Agent extracts product details: await stagehand.page.extract({instruction:'price and title', schema:z.object({price:z.string(), title:z.string()})}).

Pass a strict Zod schema so the model returns typed JSON. Validate the result at the boundary and route schema-violation back as a retry signal. Persist raw model output alongside the typed object for audit when downstream uses it for decisions.

Single-page app renders the login button asynchronously. Agent calls act('click login') before observe() has confirmed the button is present.

Use observe() to enumerate candidate actions/selectors and confirm the target exists before act(). Re-observe if act() fails so the model's plan is grounded in the current DOM, not the prior snapshot.