Zum Inhalt
HALOWERK

Modellwerk

trace grade

Takes the steps of one agent run and returns a scored report. It counts identical tool calls (same tool, same arguments) as loops, finds the longest run of consecutive failures, marks calls whose result was empty or null as wasted, and attributes cost per step and per tool so the expensive part is visible. Cost is taken from your figures when supplied, otherwise computed from token counts against the model price table.

POST https://modell.halowerk.com/v1/trace-grade

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
stepsarrayJaThe steps of the run, in order.
modelstringNeinModel id used, to price token counts when cost_usd is absent.
loop_thresholdintegerNeinFrom how many identical calls on it counts as a loop.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "steps"
  ],
  "additionalProperties": false,
  "properties": {
    "steps": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "description": "The steps of the run, in order.",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "tool": {
            "type": "string",
            "description": "Name of the tool or step."
          },
          "arguments": {
            "description": "The arguments used. Identical arguments on the same tool count as a loop."
          },
          "ok": {
            "type": "boolean",
            "description": "Whether the step succeeded. Defaults to true unless error is set."
          },
          "error": {
            "type": "string",
            "description": "Error text, if it failed."
          },
          "result": {
            "description": "The result. Empty, null or an empty list counts as a wasted call."
          },
          "input_tokens": {
            "type": "integer",
            "minimum": 0
          },
          "output_tokens": {
            "type": "integer",
            "minimum": 0
          },
          "cost_usd": {
            "type": "number",
            "minimum": 0,
            "description": "Cost of this step, if you already know it."
          },
          "duration_ms": {
            "type": "integer",
            "minimum": 0
          }
        }
      }
    },
    "model": {
      "type": "string",
      "description": "Model id used, to price token counts when cost_usd is absent."
    },
    "loop_threshold": {
      "type": "integer",
      "minimum": 2,
      "default": 2,
      "description": "From how many identical calls on it counts as a loop."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "steps": [
    {}
  ],
  "loop_threshold": 2
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://modell.halowerk.com/v1/trace-grade/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →