Tool tree
gradeNot graded
search_productsAnswer
Search the store's product catalogue with a free-text query (product name, brand, category or keywords). Returns matching products with price, stock status, URL and the productNumber to pass to get_product_details for variants and the priceLookUpNumber needed by add_to_cart.
View tool JSON
{
"name": "search_products",
"kind": "answer",
"impl": "imperative",
"description": "Search the store's product catalogue with a free-text query (product name, brand, category or keywords). Returns matching products with price, stock status, URL and the productNumber to pass to get_product_details for variants and the priceLookUpNumber needed by add_to_cart.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 100,
"description": "Free-text search phrase."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "1-based result page, 10 products per page."
}
},
"required": [
"query"
]
}
}get_product_detailsAnswer
Get the details of one product by its productNumber: description, variants (sizes/colors) with prices, stock status and the priceLookUpNumber needed by add_to_cart.
View tool JSON
{
"name": "get_product_details",
"kind": "answer",
"impl": "imperative",
"description": "Get the details of one product by its productNumber: description, variants (sizes/colors) with prices, stock status and the priceLookUpNumber needed by add_to_cart.",
"inputSchema": {
"type": "object",
"properties": {
"productNumber": {
"type": "string",
"description": "The product's productNumber, as returned by search_products."
}
},
"required": [
"productNumber"
]
}
}get_cartAnswer
Get the current shopping cart: rows with quantities and prices, totals, fees, discounts and any applied offer code.
View tool JSON
{
"name": "get_cart",
"kind": "answer",
"impl": "imperative",
"description": "Get the current shopping cart: rows with quantities and prices, totals, fees, discounts and any applied offer code.",
"inputSchema": {
"type": "object",
"properties": {}
}
}add_to_cartAction
Add a product variant to the cart by its priceLookUpNumber (from search_products or get_product_details). Returns the updated cart.
View tool JSON
{
"name": "add_to_cart",
"kind": "act",
"impl": "imperative",
"description": "Add a product variant to the cart by its priceLookUpNumber (from search_products or get_product_details). Returns the updated cart.",
"inputSchema": {
"type": "object",
"properties": {
"priceLookUpNumber": {
"type": "string",
"description": "The variant's priceLookUpNumber."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many to add. Defaults to 1."
}
},
"required": [
"priceLookUpNumber"
]
}
}update_cart_itemAction
Set the quantity of a cart row (rowId from get_cart). A quantity of 0 removes the row. Returns the updated cart.
View tool JSON
{
"name": "update_cart_item",
"kind": "act",
"impl": "imperative",
"description": "Set the quantity of a cart row (rowId from get_cart). A quantity of 0 removes the row. Returns the updated cart.",
"inputSchema": {
"type": "object",
"properties": {
"rowId": {
"type": "integer",
"description": "The cart row to update, as returned by get_cart."
},
"quantity": {
"type": "integer",
"minimum": 0,
"description": "The new quantity for the row. 0 removes the row."
}
},
"required": [
"rowId",
"quantity"
]
}
}apply_offer_codeAction
Apply a discount/offer code to the cart, or remove the current one by omitting offerCode. Returns the updated cart.
View tool JSON
{
"name": "apply_offer_code",
"kind": "act",
"impl": "imperative",
"description": "Apply a discount/offer code to the cart, or remove the current one by omitting offerCode. Returns the updated cart.",
"inputSchema": {
"type": "object",
"properties": {
"offerCode": {
"type": "string",
"description": "The offer code to apply. Omit to remove the applied code."
}
}
}
}