{
  "query": "laptop",
  "category": "electronics",
  "maxPrice": 1500
}

Result:

{
  "products": [
    {
      "id": "prod-001",
      "name": "ProBook Laptop 15",
      "price": 999.99,
      "category": "electronics",
      "inStock": true
    }
  ],
  "totalResults": 1
}

Example 2: Add Item to Cart

Use {{manage_cart}} with action "add":

{
  "action": "add",
  "productId": "prod-001",
  "quantity": 1
}

Result:

{
  "cart": {
    "items": [
      {
        "productId": "prod-001",
        "name": "ProBook Laptop 15",
        "quantity": 1,
        "price": 999.99
      }
    ],
    "total": 999.99
  },
  "message": "Item added to cart"
}

Example 3: View Cart

Use {{manage_cart}} with action "list":

{
  "action": "list"
}

Example 4: Complete Checkout

Use {{checkout}} with shipping and payment details:

{
  "shippingAddress": {
    "street": "123 Main St",
    "city": "Seattle",
    "state": "WA",
    "zipCode": "98101",
    "country": "USA"
  },
  "paymentMethod": "credit_card"
}

Result:

{
  "orderId": "order-abc123",
  "status": "confirmed",
  "estimatedDelivery": "2026-02-03T12:00:00.000Z"
}

Tool Reference

Search for products in the catalog.

Input:

query (string, optional): Search query
category (string, optional): Product category filter
minPrice (number, optional): Minimum price filter
maxPrice (number, optional): Maximum price filter

Output:

products (array): List of matching products
totalResults (number): Total count of results

Manage the shopping cart.

Input:

action (string, required): One of "add", "remove", "list", "clear"
productId (string, optional): Product ID (required for add/remove)
quantity (number, optional): Quantity (for add action)

Output:

cart (object): Current cart state
message (string): Action result message

Complete the checkout process.

Input:

shippingAddress (object, required): Shipping address details
paymentMethod (string, required): Payment method

Output:

orderId (string): Generated order ID
status (string): Order status
estimatedDelivery (string): Estimated delivery date

Example 2: Add Item to Cart

Example 3: View Cart

Example 4: Complete Checkout

Tool Reference

{{search_products}}

{{manage_cart}}

{{checkout}}

Shopping Flow

Shopping Flow Skill

Overview

Usage Examples

Example 1: Search for Products