doorax.nl

find_cylinder_size

## Use when A customer wants to know which cylinder size to order for a configurable cylinder. Always use this tool for size advice — never calculate a size yourself. Call it **directly** with the measured millimetres per side (outside named first; centre of the fixing bolt to the end on that side). Do not ask follow-up questions before calling — whether and what to ask the customer is defined by the client's agent instructions, not by this tool. `outside_fit`/`inside_fit` are **optional** refinements (default `flush`). Pass them, with the offset in mm, only when the customer already mentioned that the current cylinder protrudes or is recessed relative to the door hardware. ## What it does Per side it computes the real depth to the door face (flush = measured, protruding = measured − offset, recessed = measured + offset), then picks from this product's size series the size that protrudes at most 3 mm, or else recesses at most 3 mm. Sides are computed independently and combined (e.g. `32/47`). ## Returns Structured data only — how to phrase the advice is up to the client (chatbot prompt / agent instructions). - `status`: `ok`, `below_minimum`, `above_maximum`, `outside_3mm_rule` or `not_applicable` (product has no adjustable sizes). - `recommended_size`: the size to order (e.g. "32/47") with `price`, or null when a side falls outside the range. - `sides`: per-side detail — `effective_mm` (real depth), `recommended`, `overshoot_mm`, `within_rule`, `below_minimum`, `above_maximum`. - `half_cylinder_possible`: true when this product also offers a half cylinder (short 10 mm side); relevant when a side is below the smallest standard size. - `specialist`: name + phone of the cylinder specialist, for referral when no size fits. Sizes are symmetric data: 32/47 is the same catalog row as 47/32; order only matters when a knob is chosen (knob belongs on the inside). ## Example `{"product_id":3,"outside_mm":30,"outside_fit":"flush","inside_mm":45,"inside_fit":"flush"}`

Input schema

{
  "properties": {
    "product_id": {
      "description": "Product id (from search_products).",
      "type": [
        "integer",
        "null"
      ]
    },
    "slug": {
      "description": "Product slug; alternative to product_id.",
      "type": [
        "string",
        "null"
      ]
    },
    "outside_mm": {
      "description": "Measured outside dimension in mm (named first).",
      "type": "integer"
    },
    "inside_mm": {
      "description": "Measured inside dimension in mm.",
      "type": "integer"
    },
    "outside_fit": {
      "description": "How the current cylinder sits on the outside: flush (default), protruding, or recessed.",
      "type": [
        "string",
        "null"
      ]
    },
    "inside_fit": {
      "description": "How the current cylinder sits on the inside: flush (default), protruding, or recessed.",
      "type": [
        "string",
        "null"
      ]
    },
    "outside_offset_mm": {
      "description": "mm the cylinder protrudes/recesses on the outside (required when not flush).",
      "type": [
        "integer",
        "null"
      ]
    },
    "inside_offset_mm": {
      "description": "mm the cylinder protrudes/recesses on the inside (required when not flush).",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "type": "object"
}