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
image_url ✅ Publicly accessible URL of the product image
(others) ❌ Any additional columns — SKU, product name, color, price, etc. — are allowed and carried through as metadata

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.

text

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.

text

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.

Adding Images via API (for Custom only)

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.

Note: This API is for Custom only. Shopify syncs automatically.

API Endpoint

https://service.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.

text

Request Body

Parameter Required Description
image_url ✅ Publicly accessible product image URL
metadata ❌ Additional product information (e.g. SKU, name, color, price) stored alongside the image and returned when a match is found

Example Request

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

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.

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