Lewati ke konten utama

Interoperabilitas

QZX Result Contract v1: hasil yang dapat divalidasi software

Agen tidak seharusnya menebak apakah sebuah kalimat berarti sukses, gagal sebagian, atau data. Result Contract v1 menentukan struktur JSON kecil dan dapat diprediksi untuk hasil QZX dan implementasi kompatibel.

Batas output yang hanya dirancang untuk manusia

Output terminal nyaman untuk manusia, tetapi ketika data, penjelasan, dan error bercampur, otomatisasi harus melakukan parsing teks lagi. Kontrak terstruktur memisahkan tanggung jawab tersebut.

  • Status sukses eksplisit.
  • Pesan manusia terpisah dari keputusan mesin.
  • Data yang dapat dikonsumsi program.
  • Error dan metadata dalam bentuk yang dapat diprediksi.

Dapat diverifikasi dari awal

Spesifikasi publik menyertakan JSON Schema dan materi conformance. Profil MCP menunjukkan bagaimana structuredContent dan outputSchema dapat terkait dengan tujuan yang sama tanpa mengklaim QZX sudah menjadi standar industri.

Adopsi kontraknya tanpa harus mengadopsi seluruh CLI

Nilai interoperabilitas justru meningkat jika implementasi independen dapat menerapkan dan memvalidasi kontraknya. Jalankan schema dan validator, lalu laporkan perbedaan yang dapat direproduksi.