Skip to content
HALOWERK

Denkwerk

annotation guide draft

Takes example texts per label and derives, without a language model, the most distinguishing terms per label (TF-IDF contrast against the other labels), representative examples, cross-label example pairs with high similarity that need a written decision rule, and labels with too few examples. Returns a Markdown guideline skeleton with placeholders for the definitions an expert must write.

POST https://denk.halowerk.com/v1/annotation-guide-draft

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
labelsarrayYes
confusion_thresholdnumberNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "labels"
  ],
  "properties": {
    "labels": {
      "type": "array",
      "minItems": 2,
      "maxItems": 100,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "examples"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 100
          },
          "examples": {
            "type": "array",
            "minItems": 1,
            "maxItems": 200,
            "items": {
              "type": "string",
              "maxLength": 2000
            }
          }
        }
      }
    },
    "confusion_threshold": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 0.95,
      "default": 0.35
    }
  }
}

Open original schema

Published input example

{
  "labels": [
    {
      "name": "billing",
      "examples": [
        "invoice charged twice",
        "refund my payment"
      ]
    },
    {
      "name": "shipping",
      "examples": [
        "parcel not delivered",
        "delivery address change"
      ]
    }
  ]
}

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 โ†’