Data Types

Blueprints JSON Schema

Warum Data Types?

Data Types sind Blaupausen für deine Daten. Sie legen fest, wie ein Datensatz aussehen muss, damit Agents und Tools immer mit verlässlichen Strukturen arbeiten.

Denke an einen Typ als Vertrag:

„Immer wenn wir eine Invoice speichern, muss sie totalAmount und dueDate enthalten.“

Die Plattform setzt diesen Vertrag bei jedem Schreibvorgang durch.

Vorteile

Validierung – verhindert „Garbage in, Garbage out“. Fehlende Pflichtfelder oder ungültige Werte werden abgelehnt.
Konsistenz – jede Rechnung, egal von welchem Agent erzeugt, hat dieselbe Form.
Versionierung – Schemata können sich weiterentwickeln, ohne bestehende Datensätze zu brechen.

Definiert mit JSON Schema

Types nutzen JSON Schema, um Pflichtfelder, Enums, Formate und mehr zu beschreiben.

Beispiel: Ein Support‑Ticket‑Typ mit eingeschränkter Priorität.

{
  "type": "Ticket",
  "version": 1,
  "jsonSchema": {
    "type": "object",
    "required": ["ticketId", "status", "priority", "description"],
    "properties": {
      "ticketId": { "type": "string" },
      "description": { "type": "string" },
      "status": {
        "type": "string",
        "enum": ["open", "pending", "resolved"]
      },
      "priority": {
        "type": "string",
        "enum": ["low", "high", "critical"]
      }
    }
  }
}

Versionierung

Schemata ändern sich mit dem Business. Types sind versioniert, damit du Felder hinzufügen kannst, ohne bestehende Objekte zu brechen:

Version 1 anlegen.
Bei neuen Anforderungen Version 2 definieren.
Bestehende Objekte bleiben auf Version 1, neue nutzen Version 2.

Gruppen

Types werden nach ihrer Rolle getaggt:

Gruppe	Zweck
`PARAMETER`	Eingaben, die ein Tool oder Agent benötigt.
`RETURN`	Strukturierte Ausgaben eines Agents.
`KNOWLEDGE`	Referenzdokumente für Retrieval.

Ein Typ kann mehreren Gruppen angehören (z. B. KNOWLEDGE und RETURN).