mine_hui_itemsets
Identify which product combinations drive the most profit by mining high-utility itemsets from order data. Returns top-K itemsets ranked by aggregate utility for profit-focused bundle analysis.
Instructions
Run high-utility itemset (HUI) mining on a caller-supplied payload of orders + per-line unit_profit. Returns top-K itemsets ranked by aggregate utility (sum of profit across all occurrences). Use this when an agent needs to evaluate which item combinations drive the most profit (not just frequency) for a specific time window or product subset. Plus or Enterprise tier required on the merchant account.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"orders": "<orders>"
},
"name": "mine_hui_itemsets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top_k | No | How many top-utility itemsets to return. Default 20, max 100. | |
| orders | Yes | Order payload: each order has order_id + items[]. Each item has sku, quantity, unit_profit. | |
| min_utility | No | Minimum utility threshold; itemsets below this are dropped. |