Cos'è il formato TOON?

TOON (Token-Oriented Object Notation) è un formato di serializzazione dati compatto e leggibile progettato specificamente per i Modelli di Linguaggio di Grandi Dimensioni (LLM). A differenza di JSON, che ripete i nomi dei campi per ogni oggetto in un array, TOON dichiara i nomi dei campi una volta e poi trasmette i dati in righe—simile a CSV ma con struttura esplicita. Questo design riduce tipicamente l'uso di token del 30-60% rispetto al JSON formattato, specialmente per array uniformi di oggetti. TOON combina la struttura basata sull'indentazione di YAML per oggetti annidati con l'efficienza tabellare di CSV, ottimizzata per contesti LLM dove i costi dei token sono importanti.

Descrizione dello strumento

Questo convertitore trasforma i dati tra formati JSON e TOON bidirezionalmente. Incolla semplicemente i tuoi dati JSON per generare output TOON compatto, o riconverti TOON in JSON standard. Lo strumento utilizza la libreria ufficiale @toon-format/toon per garantire una conversione accurata. TOON è particolarmente efficace per set di dati con strutture ripetute—come record utente, log di transazioni, risposte API o qualsiasi dato tabellare—dove ridurre il conteggio dei token migliora l'efficienza quando si lavora con LLM.

Esempi

Input JSON:

{
  "users": [
    { "id": 1, "name": "Alice", "role": "admin" },
    { "id": 2, "name": "Bob", "role": "user" }
  ]
}

Output TOON:

users[2]{id,name,role}:
  1,Alice,admin
  2,Bob,user

Esempio di struttura annidata:

JSON con oggetti annidati si converte in formato TOON indentato:

{
  "order": {
    "id": "ORD-456",
    "items": [
      { "sku": "A1", "qty": 2, "price": 19.99 },
      { "sku": "B2", "qty": 1, "price": 29.99 }
    ],
    "total": 69.97
  }
}

Diventa:

order:
  id: ORD-456
  items[2]{sku,qty,price}:
    A1,2,19.99
    B2,1,29.99
  total: 69.97

Funzionalità

  • Conversione bidirezionale tra formati JSON e TOON con fedeltà completa
  • Riduzione significativa dei token (30-60% meno token vs JSON per array uniformi)
  • Preserva la struttura dei dati inclusi oggetti annidati, array e valori primitivi

Dettagli sull'efficienza dei token

TOON ottiene risparmi significativi di token attraverso diverse ottimizzazioni:

  • Nessun nome di campo ripetuto - Dichiara i campi una volta nell'intestazione invece di ripetere per ogni oggetto
  • Punteggiatura minima - Rimuove parentesi, graffe e virgolette ridondanti dove sicuro
  • Formato tabellare - Usa righe tipo CSV per array uniformi di oggetti
  • Flessibilità dei delimitatori - Supporta virgola (predefinito), tabulazione o pipe per tokenizzazione ottimale

Esempio di confronto token (usando tokenizer GPT-5):

  • JSON (formattato): 100 record dipendenti ≈ 49.776 token
  • TOON: Stessi dati ≈ 17.635 token (riduzione del 64,6%)
  • CSV: ≈ 15.583 token (più compatto, ma senza struttura)

TOON fornisce il miglior equilibrio tra compattezza e integrità strutturale per applicazioni LLM.

Panoramica del formato

Oggetti: Semplici coppie chiave-valore con indentazione per annidamento

id: 123
name: Ada
active: true

Array: Lunghezza dichiarata tra parentesi quadre, array primitivi inline

tags[3]: reading,gaming,coding

Array tabellari: Oggetti uniformi formattati come tabelle con intestazioni di campo

items[2]{sku,qty,price}:
  A1,2,9.99
  B2,1,14.5

Regole per le virgolette: Le stringhe sono tra virgolette solo quando necessario (contengono delimitatori, due punti o assomigliano ad altri tipi)

Note sulla conversione

Durante la conversione da JSON a TOON:

  • Array uniformi di oggetti usano automaticamente formato tabellare
  • Strutture annidate mantengono indentazione appropriata
  • Tipi non-JSON (undefined, funzioni) vengono convertiti in null
  • Date vengono convertite in stringhe ISO
  • Numeri evitano notazione scientifica

Durante la conversione da TOON a JSON:

  • Mantiene formattazione JSON standard con indentazione di 2 spazi
  • Valida lunghezze array e coerenza dei campi
  • Escaping corretto dei caratteri speciali
  • Preserva informazioni sui tipi (numeri, booleani, null)