TOON formatı nedir?

TOON (Token-Oriented Object Notation), Büyük Dil Modelleri (LLM'ler) için özel olarak tasarlanmış, kompakt ve insan tarafından okunabilir bir veri serileştirme formatıdır. JSON'un aksine, bir dizi içindeki her nesne için alan adlarını tekrarlamaz; TOON alan adlarını bir kez bildirir ve ardından verileri satırlar halinde akıtır—CSV'ye benzer ancak açık bir yapıya sahiptir. Bu tasarım, özellikle nesne dizileri aynı yapıyı paylaştığında, biçimlendirilmiş JSON'a kıyasla token kullanımını %30‑60 azaltır. TOON, iç içe nesneler için YAML'ın girintileme tabanlı yapısını CSV'nin tablo verimliliğiyle birleştirir ve token maliyetlerinin önemli olduğu LLM bağlamları için optimize edilmiştir.

XML nedir?

XML (eXtensible Markup Language), hem insan hem de makine tarafından okunabilir bir formatta belgeleri kodlamak için yaygın olarak kullanılan bir işaretleme dilidir. XML, öğeleri ve öznitelikleri tanımlamak için etiketler kullanır ve hiyerarşik bir ağaç yapısı oluşturur. Genellikle yapılandırma dosyaları, sistemler arası veri alışverişi, web servisleri (SOAP), belge formatları (Office Open XML) ve RSS beslemeleri için kullanılır. XML ayrıntılı ve açık olmasına rağmen, güçlü doğrulama yetenekleri sunar ve karmaşık iç içe yapıları destekler.

Araç Açıklaması

Bu dönüştürücü, veri akışını TOON ve XML formatları arasında çift yönlü olarak JSON'u ara format olarak kullanarak gerçekleştirir. Dönüştürme süreci: TOON ↔ JSON ↔ XML. Bu yaklaşım, her dönüşüm adımı için iyi bilinen kütüphanelerden yararlanarak güvenilir bir dönüşüm sağlar. Token‑verimli TOON verisini, XML girişi gerektiren sistemler için standart XML işaretlemesine dönüştürün veya XML verisini, LLM uygulamalarında token kullanımını azaltmak amacıyla kompakt TOON formatına dönüştürün.

Örnekler

TOON’dan XML’e Dönüştürme:

Girdi (TOON):

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

Çıktı (XML):

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <users>
    <id>1</id>
    <name>Alice</name>
    <role>admin</role>
  </users>
  <users>
    <id>2</id>
    <name>Bob</name>
    <role>user</role>
  </users>
</root>

XML’den TOON’a Dönüştürme:

Girdi (XML):

<?xml version="1.0" encoding="UTF-8"?>
<order>
  <id>ORD-456</id>
  <customer>John Doe</customer>
  <total>99.99</total>
</order>

Çıktı (TOON):

order:
  id: ORD-456
  customer: John Doe
  total: 99.99

Özellikler

  • TOON ve XML arasında çift yönlü dönüşüm – tam veri koruması
  • JSON ara formatı – kanıtlanmış kütüphanelerle güvenilir dönüşüm
  • Karmaşık yapıları – iç içe öğeler, öznitelikler ve dizileri destekler
  • Otomatik format algılama ve optimal dönüşüm stratejisi
  • Veri hiyerarşisini koruma – ebeveyn‑çocuk ilişkilerini sürdürür
  • Tür‑bilinçli dönüşüm – sayılar, boolean ve metinler bozulmadan kalır
  • Gerçek zamanlı dönüşüm – anlık sonuçlar
  • Sözdizimi vurgulama – hem TOON hem de XML formatları için

Kullanım Alanları

  1. Eski Sistem Entegrasyonu – Modern TOON verisini, XML girişi gerektiren eski kurumsal sistemlerle uyumlu hale getirin
  2. API Veri Dönüştürme – XML API yanıtlarını, LLM'lere gönderilmeden önce token‑verimli TOON formatına dönüştürün
  3. Yapılandırma Dosyası Dönüştürme – XML yapılandırma dosyalarını, altyapı yönetiminde LLM kullanırken token kullanımını azaltmak için TOON formatına çevirin
  4. Belge İşleme – XML belgelerini (RSS beslemeleri, SOAP yanıtları, Office belgeleri) LLM‑tabanlı analiz için TOON’a dönüştürün
  5. Veri Göçü – Farklı formatlar kullanan sistemler arasında veri aktarımı yapın; TOON, token‑verimli bir ara temsilci olarak hizmet verir

Dönüştürme Süreci

TOON’dan XML’e:

  1. TOON formatını JavaScript nesnesine ayrıştır ( @toon-format/toon decode kullanarak )
  2. JavaScript nesnesini XML işaretlemesine dönüştür (xml2js builder kullanarak)
  3. Biçimlendirilmiş XML’i uygun girintileme ile çıktıla

XML’den TOON’a:

  1. XML işaretlemesini JavaScript nesnesine ayrıştır (xml2js parser kullanarak)
  2. JavaScript nesnesini TOON formatına dönüştür (@toon-format/toon encode kullanarak)
  3. Kompakt TOON temsili olarak çıktıyı üret

XML Yapı Notları

TOON’dan XML’e dönüştürürken:

  • Kök nesne anahtarları XML öğeleri olur
  • Diziler aynı etiket adıyla birden çok öğe oluşturur
  • Tablo‑tipi TOON dizileri bireysel XML öğelerine genişletilir
  • Nesne özellikleri alt öğeler haline gelir
  • Değerler metin içeriğine dönüştürülür

XML’den TOON’a dönüştürürken:

  • XML öğeleri nesne anahtarlarına dönüşür
  • Tekrarlanan öğeler dizilere dönüşür
  • Öznitelikler öğe içeriğiyle birleştirilir
  • Metin içeriği dize değerlerine dönüşür
  • Boş öğeler boş dize ya da null olur

Format Düşünceleri

XML Ayrıntılılığı:

  • XML, açılış/kapama etiketleri nedeniyle doğası gereği ayrıntılıdır
  • Her öğe hem başlangıç hem de bitiş etiketi gerektirir
  • Öznitelikler ek karakterler ekler
  • Belge işaretlemesi ve doğrulama için uygundur

TOON Verimliliği:

  • Yapılandırılmış veri için çok daha kompakt
  • Tekrarlanan yapılarla tablo verileri için idealdir
  • JSON’a kıyasla token kullanımını %30‑60 azaltır
  • LLM tüketimi için optimize edilmiştir

Ticari Denge:

  • XML, öznitelikleri ve karışık içeriği (metin + öğeler) destekler
  • TOON, tekdüze veri yapılarında üstün verim sağlar
  • XML, daha güçlü doğrulama yeteneklerine sahiptir
  • TOON, LLM'ler için daha iyi token verimliliği sunar

Dönüştürme Kalitesi

Ara JSON formatı şunları garanti eder:

  • Veri bütünlüğü – dönüşüm sırasında veri kaybı olmaz
  • Tür koruması – sayılar, boolean ve null değerler korunur
  • Yapı tutarlılığı – iç içe ilişkiler korunur
  • Güvenilir dönüşüm – kanıtlanmış kütüphaneler (xml2js ve @toon-format/toon) kullanılır
  • Hata yönetimi – geçersiz girişler için net hata mesajları sağlar