Skip to content
HALOWERK

Textwerk

intent classify

The message is split into sentences (Unicode segmentation plus CLDR abbreviations); greetings and closings are recognised by rules and skipped. Every remaining sentence is embedded with intfloat/multilingual-e5-small (MIT, "query: " prefix, mean pooling, pinned int8 ONNX, SHA-256 checked) and compared with each intent prototype (description and examples; best match counts). A sentence gets the best intent if it beats the second-best by at least min_margin, otherwise it is marked unclear. The.

POST https://text.halowerk.com/v1/intent-classify

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYes
intentsarrayNoOwn intents; default: eight customer-service intents.
min_marginnumberNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 8000
    },
    "intents": {
      "type": "array",
      "minItems": 2,
      "maxItems": 30,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "description"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "description": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "examples": {
            "type": "array",
            "maxItems": 10,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500
            }
          }
        }
      },
      "description": "Own intents; default: eight customer-service intents."
    },
    "min_margin": {
      "type": "number",
      "minimum": 0,
      "maximum": 0.2,
      "default": 0.005
    }
  }
}

Open original schema

Published input example

{
  "text": "Ich möchte meinen Vertrag kündigen. Außerdem ist die letzte Rechnung zu hoch, das ärgert mich."
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →