observe

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

Source: node-sdk/src/session.ts Observe the current page: the list of actions that can be taken, a screenshot and page metadata. The perception_type defaults to the session option (fast). A bare string argument is accepted as the perception type. Deprecated: perception_type: 'deep' and instructions are removed on December 1, 2026, and each warns once per session. Use perception_type: 'fast' (the default) instead of 'deep'. For instructions: <<ALTERNATIVE FOR instructions: session.act() — pending>>. See https://docs.notte.cc/features/sessions/observe-migration

Session.observe(options?: ObserveRequest | PerceptionType): Promise<Observation>;

Parameters

ObserveRequest | PerceptionType

Observation settings, including an optional URL, or a perception-mode string.Default:

{}

Returns

Promise<Observation>

Structured page analysis, available actions, and page metadata.

Raises

NotteAPIError if observation fails.

Example

const obs = await session.observe();
console.log(obs.space.description);
const firstActions = await session.observe({ max_nb_actions: 50 });

⌘I

Getting Started

APIs

Python SDK

Node SDK

Parameters

Returns

Raises

Example

​Parameters

​Returns

​Raises

​Example

​Related types

Parameters

Returns

Raises

Example

Related types