> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roe-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Interactive Web Insights

> Performs interactive web browsing and extracts information from dynamic web pages.

## Interactive Web Insights Engine Overview

The Interactive Web Insights Engine enables AI-powered interactive web browsing. Unlike static web scraping, this engine can navigate dynamic websites, interact with page elements, and extract information from JavaScript-rendered content.

## Engine Inputs

The Interactive Web Insights Engine Configuration has the following parameters:

* **url**: *required.* The URL to navigate to and interact with.
* **action**: *required.* Instructions describing what actions to perform on the page and what information to extract.
* **output\_schema**: *required.* JSON schema defining the structure of data to extract. Follows the standard [JSON schema specification](https://json-schema.org/).

See [Template Strings](/agents/input-definition#template-strings) for dynamic parameter configuration.

## Engine Output

The output will be a JSON value matching the structure specified in the **output\_schema**. The output may also include a `roe_references` field containing screenshot references captured during browsing.

## Example Usage

<Steps>
  <Step title="Create an Agent">
    Click on the "Add Agent" button in the top right corner of the Agents page.

    <Frame>
      <img src="https://mintcdn.com/roeai/qeWYCF2quzHQHhsD/images/add-agent.png?fit=max&auto=format&n=qeWYCF2quzHQHhsD&q=85&s=b3e1ec9b816ed1e57cb1ecfa53ff4288" width="1920" height="1045" data-path="images/add-agent.png" />
    </Frame>

    Enter a name and an optional description of your Agent.
  </Step>

  <Step title="Select the Interactive Web Insights Engine" />

  <Step title="Configure the engine">
    <Info>\$ starts a template string</Info>

    * **url**: \$url
    * **action**: \$action
    * **output\_schema**: Copy and paste the JSON schema below:

    ```json theme={null}
    {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "Main title or heading"
        },
        "summary": {
          "type": "string",
          "description": "Brief summary of the content"
        },
        "key_points": {
          "type": "array",
          "items": { "type": "string" },
          "description": "List of key points extracted"
        }
      },
      "required": ["title", "summary"]
    }
    ```
  </Step>

  <Step title="Create the Agent">
    Hit the **Create** button.
  </Step>

  <Step title="Run a job">
    Create a new job and provide:

    * **url**: A webpage URL to interact with
    * **action**: Instructions like "Extract the main sections and key information from this webpage"
  </Step>
</Steps>

## Use Cases

* **Dynamic content extraction**: Extract data from pages that require JavaScript execution
* **Form interaction**: Navigate through multi-step forms or wizards
* **Authenticated scraping**: Access content behind login pages
* **Single-page applications**: Extract data from React, Vue, or Angular applications
* **Interactive data gathering**: Click through pagination, expand sections, or trigger data loads