> ## 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.

# Create an Agent that generates unique comparison deeplink URLs

> Let your AI Agent send users directly to pre-filtered comparison pages based on their preferences.

With the right setup, your AI Agent can build custom deeplink URLs that lead users straight to a relevant, pre-filtered comparison page. This removes unnecessary clicks and creates a smoother, more personalised experience.

## **What is a unique comparison deeplink URL?**

A **unique comparison deeplink** is a custom URL that sends users **directly to a filtered comparison page** on your website.

Instead of a generic overview, the page already reflects their preferences because these are included in the URL parameters.

A deeplink can include filters such as:

* **Specific categories** (e.g. energy, mobile, insurance)
* **Pre-selected filters** (e.g. price, duration, brand, provider)
* **User preferences** (e.g. green energy, 5G only, family bundles)

## Why is this relevant?

Using deeplinks helps users find the right results **faster and with fewer steps**.

It’s especially valuable for large assortments or pages with many filter options.

With dynamic deeplink generation, your AI Agent can:

* **Skip manual filtering** and send users straight to the right view
* **Personalise the experience** based on the conversation
* **Reduce friction** and lower the chance of drop-offs
* **Improve navigation** on complex or multi-filter comparison pages

## When does this work (and when not)?

### Your AI Agent can only generate valid deeplinks if

* Your comparison or filter page uses a clear URL structure
* You know all available parameters and their allowed values

### This does not work if

* filters are applied via JavaScript without updating the URL
* filtering relies on sessions, cookies, or POST requests
* the URL has no consistent structure

In these cases, the AI Agent simply has no way to build the right link.

## **Example use case: comparing internet plans**

Imagine you run a website where users can compare **internet plans**. Your AI Agent helps visitors find the right plan based on:

* Type of connection (e.g. Fibre, DSL, Cable)
* Speed (e.g. 100 Mbps, 500 Mbps, 1 Gbps)
* Contract length (e.g. 1 month, 12 months, 24 months)

Your comparison page might use a structure like: [https://compare-connect.com/internet/](https://compare-connect.com/internet/)

If a user says: *I’m looking for a fibre internet plan, at least 500 Mbps, with a 2-year contract.* your AI Agent should generate a link like: [https://compare-connect.com/internet/?type=FIBRE\&speed=500\&contract=24](https://compare-connect.com/internet/?type=FIBRE\&speed=500\&contract=24)

This sends the visitor straight to the **correct, pre-filtered results**.

## How to set this up in your AI Agent

<Steps>
  <Step title="Add a clear instruction to the Agent’s knowledge">
    Include a short but structured explanation that outlines:

    * the base URL (see step 2)
    * the parameters and allowed values (see step 3)
    * how the Agent should combine them into a full URL
    * that missing parameters should be skipped

    **Example instruction to add**

    > When a user wants to compare internet plans, generate a unique comparison URL based on their preferences.
    >
    > Base URL: [https://compare-connect.com/internet/](https://compare-connect.com/internet/)
    >
    > Parameters:
    >
    > * Connection type
    >   * Fibre → ?type=FIBRE
    >   * DSL → ?type=DSL
    >   * Cable → ?type=CABLE
    > * Speed
    >   * 100 Mbps → \&speed=100
    >   * 500 Mbps → \&speed=500
    >   * 1 Gbps → \&speed=1000
    > * Contract length
    >   * 1 month → \&contract=1
    >   * 12 months → \&contract=12
    >   * 24 months → \&contract=24
    >
    > If the user does not specify a value for a parameter, do not include it. Always return the final, complete URL.
  </Step>

  <Step title="Define the base URL">
    This is the comparison page without filters: [https://compare-connect.com/internet/](https://compare-connect.com/internet/)
  </Step>

  <Step title="Define the URL parameters">
    For each filter, specify:

    * what the user might say
    * the exact parameter value the Agent should use
    * whether the parameter is optional

    This gives your Agent everything it needs to generate dynamic comparison links.
  </Step>
</Steps>

### Example of a generated URL

**User request:** *I’m looking for a fibre internet plan, at least 500 Mbps, with a 2-year contract.*

**AI Agent output:** *You can compare plans that match your preferences here:*

[*https://compare-connect.com/internet/?type=FIBRE\&speed=500\&contract=24*](https://compare-connect.com/internet/?type=FIBRE\&speed=500\&contract=24)

This URL leads directly to a filtered view showing fibre plans, 500 Mbps and 24-month contracts. **No extra clicks needed.**