StagehandInstall

Summary

Send an observation instruction to the Stagehand AI-powered browser assistant to analyze and interpret the current web page state, returning its planned action or insights.

Inputs

• AI Provider (required) — Select the AI provider (OpenAI, Anthropic, Google, Cerebras, or OpenRouter) to power the observation operation.
• Instruction (required) — Provide a natural language instruction describing what the Stagehand should observe or assess on the web page.
• Advanced Options — Configure optional parameters such as the AI model to use, caching behavior, verbosity, DOM settle timeout, wait mode for navigation, resource blocking to speed up loads, and logging preferences.

Output shape

a single JSON object containing the observation result with optional log messages if enabled

Output includes the observation result derived by the AI analyzing the page's current state. Log messages are included if the 'Log Messages' option is enabled. The operation requires a pre-initialized browser session, typically established via a prior Navigate operation.

Examples

Example 1: Analyze the current webpage to identify key visual or structural elements and suggest a next action.

Set AI Provider to OpenAI, provide a detailed instruction on what to observe, optionally select a specific AI model or logging preferences, and run the Observe operation after navigating to a target URL.