Built-in Tools

Built-in tools give the AI the ability to interact with the page the same way a user would — clicking buttons, filling forms, navigating routes, and reading content.

How the AI targets elements

When the AI receives the page content, every interactive element is annotated with selector information. The annotations let the AI reference specific elements by their location on the page.

You can help the AI identify important elements by adding data attributes:

Adding these attributes is optional but makes targeting more reliable.

You can style highlighted elements with CSS:

[data-ai-highlight] {
  outline: 3px solid #3b82f6;
  outline-offset: 2px;
  border-radius: 4px;
  transition: outline-color 0.2s;
}

The attribute is present for three seconds while the flash animation plays, then removed automatically.

Tool reference

navigate

Navigates the user to a different route.

{ "target": "/dashboard/reports" }

Works with client-side routers (Next.js, React Router) and falls back to standard browser navigation. External URLs, javascript: links, and data: URIs are rejected for security.

click

Clicks an interactive element.

{ "label": "Submit" }

Matches by data-ai-action, aria-label, placeholder, or visible text. Triggers the element's native click handler.

type

Types a value into a text field.

{ "field": "Email", "value": "user@example.com" }

Supports all input types, textareas, and contenteditable elements. Works with framework-controlled inputs by triggering the appropriate change events.

highlight

Briefly flashes an element to draw the user's attention.

{ "region": "Error summary" }

The element is highlighted for three seconds. No approval needed — purely visual feedback.

scroll

Scrolls an element into the viewport.

{ "target": "Pricing section" }

Smooth scrolls to the element and centers it on screen.

extract

Reads the current value or text content of an element.

{ "field": "Search input" }

Returns the element's value (for inputs), text content (for general elements), or inner text (for contenteditable regions).

Controlling availability

See Permissions to learn how to restrict which built-in tools the AI can use.