BroadRouter
Mulai

JSON Schema (skema JSON)

Diperbarui

JSON Schema adalah kosakata yang ditulis dalam JSON untuk mendeskripsikan dan memvalidasi struktur data JSON: tipe, field wajib, nilai yang diizinkan, dan susunan bertingkat. Versi terbarunya 2020-12. API LLM memakainya untuk mendefinisikan parameter tool dan bentuk persis yang harus diikuti output terstruktur.

Disebut juga: skema JSON, validasi JSON Schema, json_schema, JSON Schema draft 2020-12

Prompt yang berbunyi “balas dalam JSON” menyerahkan bentuknya pada kebetulan. JSON Schema menuliskan bentuk itu agar bisa diperiksa mesin.

Cara kerjanya

Spesifikasinya punya dua bagian utama: Core, yang “defines the basic foundation of JSON Schema” (terjemahan: mendefinisikan fondasi dasar JSON Schema), dan Validation, yang “defines the validation keywords” (terjemahan: mendefinisikan keyword validasi). Versi terbarunya 2020-12; versi sebelumnya 2019-09.

{
  "type": "object",
  "properties": {
    "name":    {"type": "string"},
    "amount":  {"type": "number", "minimum": 0},
    "currency": {"type": "string", "enum": ["SAR", "AED", "USD"]},
    "note":    {"type": ["string", "null"]}
  },
  "required": ["name", "amount", "currency", "note"],
  "additionalProperties": false
}

API LLM memakai skema di dua tempat. Definisi tool menaruh satu skema di parameters untuk mendeskripsikan argumen. Output terstruktur mengirim satu skema di response_format sebagai {"type": "json_schema", "json_schema": {...}}, yang menurut OpenAI “ensures the model will match your supplied JSON schema” (terjemahan: memastikan model akan cocok dengan JSON schema yang Anda berikan).

Mode strict OpenAI hanya menerima sebagian. Dari bagian skema yang didukung:

  • Tipe: string, number, boolean, integer, object, array, enum, dan anyOf.
  • Root harus berupa objek dan tidak boleh memakai anyOf.
  • additionalProperties: false dan setiap field tercantum di required; buat field menjadi opsional dengan mengizinkan null, seperti note di atas.
  • Hingga 5000 properti objek dan 10 tingkat nesting, serta total hingga 1000 nilai enum.
  • Tidak didukung: allOf, not, dependentRequired, dependentSchemas, if, then, else.

Kenapa ini penting

  • Validasi. Skema yang sama yang memandu model juga memeriksa balasannya di kode Anda. Pemeriksaan yang gagal memberi error yang persis untuk dikirim balik.
  • Portabilitas. Skema yang ditulis dengan subset strict bekerja di lebih banyak penyedia daripada skema yang memakai semua keyword.
  • Token. Skema dalam definisi tool dikirim sebagai input di setiap permintaan. Deskripsi panjang memakan token di setiap giliran.

Di BroadNet Inference

Referensi API BroadNet mendokumentasikan tool calling dan output terstruktur untuk GLM 5.3 dan Qwen3.8 27B, tetapi tidak menyebut keyword skema mana yang ditegakkan. Batasi skema pada subset sederhana di atas dan validasi setiap balasan. Buat skema dengan generator JSON Schema, periksa balasan dengan validator output JSON LLM, dan lihat artikel output terstruktur untuk contoh lengkap. Di model lain, minta JSON di prompt dan validasi balasannya; JSON mode tidak didokumentasikan oleh BroadNet, jadi uji sebelum mengandalkannya.

Kesalahan umum

  • Memakai allOf atau keyword kondisional dan mengira server menegakkannya.
  • Membuat field opsional dengan mengeluarkannya dari required di mode strict, alih-alih mengizinkan null.

Pertanyaan umum

Apakah API LLM mendukung seluruh JSON Schema?

Tidak. OpenAI mendukung sebagian saja: misalnya root harus berupa objek, setiap field harus wajib, additionalProperties harus false, dan keyword seperti allOf, not, dan if/then/else tidak didukung.

Apa bedanya JSON Schema dan JSON mode?

JSON mode hanya menjanjikan JSON yang valid. JSON Schema memberi tahu model, dan validator Anda, field dan tipe apa yang harus dimiliki JSON itu.

Bisakah saya memakai JSON Schema dengan BroadNet Inference?

Parameter tool dan output terstruktur, yang sama-sama memakai skema, didokumentasikan untuk GLM 5.3 dan Qwen3.8 27B. BroadNet tidak mendokumentasikan keyword skema mana yang ditegakkan, jadi validasi setiap balasan.

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity