mini-zshop.nl

{
  "type": "object",
  "properties": {
    "browse": {
      "type": "boolean",
      "description": "Enabled by default in Dex. Keep enabled for product discovery and requests for a product type or range, even without the word browse. Returns up to 100 matching identities and a browse.id: use that ID as browse_search_id in the final answer. Set false only for focused identification or a fixed comparison that needs no collection. It does not claim compatibility. Prefer the narrow relevant published category and explicit required_terms to keep accessories and wrong specifications out; refine an irrelevant first search before choosing the collection."
    },
    "required_terms": {
      "type": "array",
      "maxItems": 4,
      "items": {
        "type": "array",
        "minItems": 1,
        "maxItems": 6,
        "uniqueItems": true,
        "items": {
          "type": "string",
          "minLength": 1,
          "maxLength": 60
        }
      },
      "description": "Hard filters from explicit customer requirements: every group must match the current product name or public attribute; alternatives inside each group are OR. Choose literal variants from catalog names, e.g. a requested hardness might appear as 20°, 20deg or 20 degree. Select appropriate language/synonym variants semantically; no automatic translation. Use the narrow product category for the requested kind. Omitted/undocumented values do not pass this strict filter; context_terms alone only ranks. Never claim a literal match guarantees compatibility."
    },
    "context_terms": {
      "type": "array",
      "maxItems": 6,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 60
      },
      "description": "Separate the product noun/query from relevant public constraints resolved from the whole conversation and selected vehicle: chassis, dimensions, drive, scale or product type. Choose short catalog-language terms, e.g. MR-04, 98 mm, RWD. These rerank up to 100 current candidates using title, visible attributes, categories and Showcase metadata without removing undocumented candidates. Do not include private customer data, a transcript, negative constraints or an unverified event-eligibility claim. context_match lists actual metadata matches and still-unverified terms; it never guarantees compatibility."
    },
    "exclude_ids": {
      "type": "array",
      "maxItems": 20,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 2147483647
      },
      "description": "Previously returned product IDs the shopper explicitly rejected. They remain excluded across alternative queries and contextual ranking."
    },
    "price_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Currency of max_price_minor. Pass the shopper’s stated currency; a mismatch with the shop currency returns a clarification instead of treating CHF as EUR."
    },
    "query": {
      "type": "string",
      "minLength": 0,
      "maxLength": 200,
      "description": "Short catalog keywords. Omit or leave empty to browse the selected category."
    },
    "sku": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "queries": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 200
      },
      "description": "Optional alternative short searches for the same customer goal, chosen from the conversation and observed results. Searches the whole public catalog unless you explicitly set a category. Use instead of query/sku to combine spelling, language or part-name variants in one bounded read. Results are deduplicated; each query retains its matched IDs and pagination. Follow with exact product reads and manual/manufacturer research for unresolved evidence, not more identical searches."
    },
    "category_slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Published catalog category. For browsing cars use autos (Mini-Z cars/chassis) or voertuigen-kits (Traxxas vehicles/kits), without a generic query. For Mini-Z setup/measuring tools use gereedschap. Categories include descendants. Read category_scope.path: similar category names can belong to different brands or vehicle families. If the path does not match the known vehicle, retry without that category; do not keep querying the wrong family. Check whether each result is the requested product type."
    },
    "in_stock": {
      "type": "boolean",
      "default": false,
      "description": "Set true only when the shopper explicitly requires immediate stock. This excludes ALL backorder/preorder products, even when purchasable. Omit for model information, identification and ordinary product discovery."
    },
    "max_price_minor": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000
    }
  },
  "required": [],
  "additionalProperties": false
}