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
  • Rilevamento automatico del formato e strategia di codifica ottimale
  • Output leggibile con struttura tabellare chiara per dati uniformi
  • Conversione type-safe mantenendo correttamente numeri, booleani, null e stringhe
  • Gestisce casi limite inclusi array vuoti, strutture annidate e tipi misti
  • Conversione in tempo reale con risultati istantanei durante la digitazione

Casi d'uso

  1. Ottimizzazione API LLM - Ridurre i costi dei token quando si inviano dati strutturati a GPT, Claude o altri LLM convertendo payload JSON in formato TOON prima delle chiamate API
  2. Prompt di analisi dati - Preparare set di dati per l'analisi LLM con codifica più efficiente, consentendo set di dati più grandi entro i limiti di contesto
  3. Generazione di dati strutturati - Usare TOON nei prompt per richiedere agli LLM di generare dati tabellari più efficientemente di JSON
  4. Elaborazione log - Convertire log applicativi o dati analitici in formato compatto per analisi e sintesi basate su LLM
  5. Gestione configurazione - Trasformare file di configurazione in formato efficiente per token quando si usano LLM per gestione infrastruttura o attività DevOps

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)