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

# Search

> Learn how to enable and configure Search so your AI Agent can retrieve accurate, up-to-date information from the web or a specific website.

Enabling **Search** allows your AI Agent to retrieve up-to-date information **directly** from the web or from a **specific website**. This keeps your AI Agent’s answers **accurate and current**, even when information changes frequently or **isn’t included** in your Sources or Instructions.

## What is Search?

**Search** lets your AI Agent:

* Search the **entire internet** or
* Search a **specific website** that you choose

The Agent then uses that search result to **generate a response.**

This is especially helpful when you want **dynamic or frequently changing** information to be available **without manually updating** your AI Agent’s knowledge.

## Enabling Search

By default, the Search action is not active on your agent.

To **activate** it:

<Steps>
  <Step title="Open the AI Agent">
    Select which Agent you would like to use Search.

    <Frame>
      <img src="https://mintcdn.com/watermelon/W370BP_s7XCIjtae/images/connect-shopify-1.png?fit=max&auto=format&n=W370BP_s7XCIjtae&q=85&s=f0ff08c15498d25ba7f824873c5af22f" alt="Search Menu" width="1440" height="778" data-path="images/connect-shopify-1.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Search">
    In the Agent menu, underneath Behavior, select **Actions.** Within Actions, click on the **plus** icon at the **Web Search** action.

    <Frame>
      <img src="https://mintcdn.com/watermelon/BnbaQNoERHdpPPyg/images/actions-search-1.png?fit=max&auto=format&n=BnbaQNoERHdpPPyg&q=85&s=e58afe7f64780d9dd6dd7e89eee4a13f" alt="Search Enable Feature" width="1439" height="778" data-path="images/actions-search-1.png" />
    </Frame>
  </Step>

  <Step title="Choose where to search">
    You can choose between:

    1. Searching a **selected URL**  (recommended for controlled and consistent results)
    2. Searching the **whole internet**

    <Frame>
      <img src="https://mintcdn.com/watermelon/BnbaQNoERHdpPPyg/images/actions-search-3-1.png?fit=max&auto=format&n=BnbaQNoERHdpPPyg&q=85&s=533c165d5d557911fcad5ed96ed2e299" alt="Search Selection" width="1439" height="778" data-path="images/actions-search-3-1.png" />
    </Frame>
  </Step>

  <Step title="Input Selected URLs">
    If you choose to have your AI Agent to only search **one** website:

    1. Choose **Selected URL**
    2. Enter the domain you want the Agent to search
       * If you enter a subpage, it automatically adjusts to the main domain
       * Search cannot target a single subpage
    3. Click **Add URL**

    Your AI Agent will now **only** use search results from that domain.
  </Step>

  <Step title="Activate your search action">
    Lastly, you need to **activate** your search actions. Otherwise your agent will only use Search within the Playground. Click on **Activate** in the top right corner.

    <Frame>
      <img src="https://mintcdn.com/watermelon/BnbaQNoERHdpPPyg/images/actions-search-4.png?fit=max&auto=format&n=BnbaQNoERHdpPPyg&q=85&s=a84ef2ce15f387547195496bf6668ccd" alt="Actions Search 4" width="1439" height="778" data-path="images/actions-search-4.png" />
    </Frame>
  </Step>
</Steps>

### Managing Allowed URLs

To **update or remove** the websites your Agent is allowed to search:

1. **View** the list of added URLs
2. **Select** a URL
3. **Click Delete** or use the **bin icon**

<Frame>
  <img src="https://mintcdn.com/watermelon/BnbaQNoERHdpPPyg/images/actions-search-5.png?fit=max&auto=format&n=BnbaQNoERHdpPPyg&q=85&s=b22e44b50fab05f098ce29d534085225" alt="Search Manage Urls" width="1439" height="778" data-path="images/actions-search-5.png" />
</Frame>

You can add or remove URLs at **any time** to keep your Agent’s search behavior aligned with your needs.

## Technical details

Search works **behind the scenes** as follows:

* Performs a **Google search** based on the customer’s question
* **Retrieves** the top search result
* **Scans** that webpage
* Uses the **extracted content** to generate the answer
  * Total search time is limited to **7,500 ms**

## Best practice

* Use **Selected URL** if your company has a reliable website for consistent and brand-safe results
* Use **Search the entire internet** *only* when your customers need broad, dynamic information
* Always **test** your AI Agent in the [**Playground**](/help-center/build-your-agent/test-your-agent) after enabling Search
