Image Search Tool: Let Customers Search Your Catalog by Photo

The Image Search Tool lets your AI agent look up products by image. When a customer sends a photo and asks "do you have this?" or "what is this?", the agent matches it against a catalog of product images you provide and responds with what it found.

Setting Up the Tool

In your TailorTalk dashboard, go to Agent Setup, click Add Tool, and select Image Search from the Select Tool modal.

Uploading Your Product CSV

Prepare a CSV with one row per product image:

Column	Required	Description
product_id	✅	Your own identifier for the product — use the same value on multiple rows to attach several images of the same product. If your CSV has no product_id column, a sku column is accepted in its place.
image_url	✅	Publicly accessible URL of the product image
(others)	❌	Any additional columns — product name, color, etc. — are allowed and carried through as metadata

* One of product_id or sku is required. Rows that share the same identifier are grouped into a single product with all of its image URLs — so a product with multiple images is several rows with the same product_id (or sku) and a different image_url each.

Upload the CSV in the tool's setup panel. Once it uploads successfully, you'll see the file listed as attached — you can replace it with a new CSV at any time from the same panel.

Adding Images via API

Once the tool is live, you don't need to re-upload the whole CSV to add a new product — add individual images to the index directly with the Add Image Search API. This only applies to CSV-based tools like this one — Shopify-backed tools sync automatically instead.

API Endpoint

https://api.tailortalk.ai/api/v1/add_product

Headers

Key	Value
Authorization	Agent <token>
Content-Type	application/json

You can find agent_token on the Developer page, under the API Keys tab. Click the eye icon to reveal it, or the copy icon to copy it.

Request Body

Parameter	Required	Description
product_id	✅	Your own identifier for the product — call this endpoint again with the same productid and a different imageurl to add another image of the same product
image_url	✅	Publicly accessible product image URL
metadata	❌	Additional product information (e.g. name, color) stored alongside the image and returned when a match is found

Example Request

{
    "product_id": "SKU123",
    "image_url": "https://example.com/products/red-shirt.jpg",
    "metadata": {
        "product_name": "Red Shirt",
        "color": "red"
    }
}

Response Format

The API returns a JSON object confirming the image was added. The response payload is wrapped automatically under a data field with success: true:

{
    "data": {
        "message": "Image added to the image-search index.",
        "image_url": "https://example.com/products/red-shirt.jpg"
    },
    "success": true
}

Notes

• Ensure that the agent access token is included in the request headers.
• The agent token determines which agent's Image Search tool the image is added to — agent_id is derived from the token and does not need to be included in the request body.
• image_url must be publicly accessible; TailorTalk fetches it directly to index the image.
• The target agent must already have an Image Search tool set up with a CSV uploaded.

Syncing from Shopify Instead

If this agent already has a Shopify tool connected, switch to the Shopify tab in the setup panel — no CSV needed, product images sync directly from your connected store.

If Shopify isn't connected yet, the panel shows a Set Up Shopify Tool button instead. Clicking it closes this dialog and opens the Shopify tool's setup so you can connect your store first; once that's done, add Image Search again and the Shopify tab will be ready to use.

How It Works

• A customer sends a photo in chat and asks something like "do you have this?" or "what is this?"
• The agent searches your uploaded image index for the closest match.
• If a confident match is found, the agent responds with the matching product (and any metadata you included, like name or price).
• If nothing matches confidently, the agent can ask the customer for another angle or say it isn't available.

Tips

• Use clear, well-lit product photos — whether uploaded via CSV in tool or added via the API — the closer they look to what a customer might photograph, the better the match quality.
• Add metadata (SKU, price, name) — as CSV columns or API fields — so the agent can respond with useful details, not just confirm a match.
• Use the API to keep the index current as you add new products, instead of re-uploading the full CSV each time.