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.

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 deep = await session.observe({ perception_type: 'deep', max_nb_actions: 50 });

Observation
ObserveRequest
PerceptionType

⌘I

Getting Started

APIs

Python SDK

Node SDK

Parameters

Returns

Raises

Example

​Parameters

​Returns

​Raises

​Example

​Related types

Parameters

Returns

Raises

Example

Related types