DocumentationAI Shopping Assistant

AI Shopping Assistant

4 minLast updated: 2026-03-31

How It Works

When a chat agent has a catalog_id set in its widget_config, it becomes an AI shopping assistant. The agent can search products, manage shopping carts, and process orders, all through natural conversation.

Available Tools

The AI shopping assistant uses 10 function-calling tools:

  • search_products: Search the catalog by keyword, category, or price range
  • get_product_details: Show full details for a specific product
  • add_to_cart: Add a product to the customer's cart
  • remove_from_cart: Remove an item from cart
  • update_cart_quantity: Change quantity of a cart item
  • view_cart: Show current cart contents and total
  • place_order: Convert cart to an order with delivery details
  • get_order_status: Check status of an existing order
  • get_recommendations: Suggest related or popular products
  • check_availability: Check stock for a product/variant

Activating Commerce in Chat

To enable the AI shopping assistant:

  1. Create a product catalog and add products
  2. Go to your General (chat) agent settings
  3. In the Integration tab, set catalog_id in the widget configuration
  4. The chat widget will now show a mini-cart panel and the AI will have commerce tools available

Example Conversation

Customer: "Do you have dog food for puppies?"
AI: [calls search_products("puppy dog food")]
AI: "Yes! We have 3 options:
     1. Puppy Growth Formula (2kg): 1,890 RSD
     2. Premium Puppy Mix (5kg): 3,450 RSD
     3. Organic Puppy Blend (2kg): 2,190 RSD
     Would you like to add any of these to your cart?"

Customer: "Add the Premium Puppy Mix"
AI: [calls add_to_cart(product_id, qty=1)]
AI: "Added! Your cart: Premium Puppy Mix (5kg) × 1 = 3,450 RSD.
     Anything else, or ready to checkout?"

Was this article helpful?