execute

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.

This method allows you to interact with web elements by performing various actions like clicking, filling forms, navigating, scrolling, and more. You can provide actions either as structured action objects or by specifying action parameters directly.

from notte_sdk import actions

# Execute an action from observe() results
obs = session.observe()
action = obs.space.first()  # Get first available action
result = session.execute(action)

# Execute a click action by element ID.
# Pseudo observe output: [B1] button "Submit"
# Only use IDs that appear in your live observe() output.
result = session.execute(type="click", id="B1")

# Execute a fill action by element ID.
# Pseudo observe output: [I1] input "Email"
# Only use IDs that appear in your live observe() output.
result = session.execute(type="fill", id="I1", value="user@example.com")

# Execute browser navigation
result = session.execute(type="goto", url="https://example.com")

Action Types: Browser Actions (always available):

goto: Navigate to a URL
go_back: Go back to previous page
go_forward: Go forward to next page
reload: Reload current page
scroll_up/scroll_down: Scroll the page
wait: Wait for specified milliseconds
press_key: Press keyboard keys

Interaction Actions (require element ID from observe):

click: Click on an element
fill: Fill input fields with text
upload_file: upload files to file inputs
etc.

Do not write interaction code with guessed element IDs, selectors, or field names. Element IDs must come from a live observe() call, and selectors/field names should be validated against the actual page before they are used in automation. Using Playwright Selectors: Instead of element IDs, you can use Playwright selectors to target elements:

session.execute(type="fill", selector="internal:text="Email"", value="test@example.com")

This syntax also supports Xpath (e.g. xpath=/html/body/div[3]/div/button[1]) or CSS selectors (e.g. css=button.submit).

Note that we strongly advice to use selectors over IDs for workflows automation because IDs are dependent on the page structure and can change over time.

Parameters

UnionType[BaseAction, None]

default:"None"

UnionType[bool, None]

default:"None"

If true, will raise if we could not execute the action

Any

required

Returns

ExecutionResult: Result containing execution details, any errors, and the updated session state.

Raises

Exception: If raise_on_failure is True and the action execution fails.

Getting Started

APIs

Python SDK

Node SDK

Parameters

Returns

Raises

​Parameters

​Returns

​Raises

Parameters

Returns

Raises