Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Aktivace režimu JSON

Lekce 4 z 12 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Jak funguje režim JSON
  2. Aktivace v Pythonu
  3. Aktivace v TypeScriptu
  4. Explicitní instrukce nejsou volitelné
  5. Přesun instrukcí pro formát do systémového promptu
  6. Parsování odpovědi
  7. Klíčové poznatky

Aktualizováno 3. listopadu 2026: Příklad v TypeScriptu dříve importoval Mistral jako výchozí export (import Mistral from …), ale SDK poskytuje pouze pojmenovaný export: import { Mistral } from "@mistralai/mistralai". Také předával obsah typovaný jako string | ContentChunk[] přímo funkci JSON.parse a natvrdo kódoval API klíč ve zdrojovém kódu. Ověřeno kompilací s SDK 3.5.0 a TypeScript 7.0.2. Zdroj: Mistral TypeScript SDK.

Jak funguje režim JSON

Režim JSON je nejjednodušší mechanismus pro získání strukturovaného výstupu od Mistralu. Pouhým nastavením jediného parametru zajistíš, že odpověď modelu bude platný JSON. Žádné definování schématu, žádné psaní datových modelů – při každém volání získáš pouze syntakticky správný JSON.

Aktivace v Pythonu

Tento režim aktivuješ pomocí parametru response_format v metodě client.chat.complete(). Všimni si, že samotný prompt musí popisovat očekávanou strukturu – proč to není volitelné, vysvětlíme vzápětí.

from mistralai.client import Mistral

client = Mistral(api_key="your-api-key")

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "user",
            "content": "Popiš 3 hlavní výhody cloud computingu. Vrát výsledek jako JSON s klíčem 'advantages' obsahujícím seznam objektů s 'title' a 'description'."
        }
    ],
    response_format={"type": "json_object"}
)

print(response.choices[0].message.content)

Výstup bude platný JSON, připravený k okamžitému použití:

{
  "advantages": [
    {
      "title": "Škálovatelnost",
      "description": "Dynamické přizpůsobení zdrojů na základě poptávky."
    },
    {
      "title": "Snížení nákladů",
      "description": "Není vyžadována investice do fyzické infrastruktury."
    },
    {
      "title": "Dostupnost",
      "description": "Přístup ke službám odkudkoli."
    }
  ]
}

Aktivace v TypeScriptu

SDK pro TypeScript sleduje přesně stejnou logiku, pouze s pojmenováním v camelCase: parametr se jmenuje responseFormat a parsování probíhá pomocí JSON.parse(). Platí jedno dodatečné opatření: SDK typuje content jako string | ContentChunk[], takže JSON.parse přijme hodnotu až poté, co ověříš, že je skutečně řetězcem.

import { Mistral } from "@mistralai/mistralai";

const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });

const response = await client.chat.complete({
  model: "mistral-large-latest",
  messages: [
    {
      role: "user",
      content: "Vypiš 3 populární JavaScriptové frameworky v JSON s 'name' a 'useCase'."
    }
  ],
  responseFormat: { type: "json_object" },
});

const contenu = response.choices[0]?.message?.content;
if (typeof contenu !== "string") {
  throw new Error("Response does not contain JSON text.");
}
const data = JSON.parse(contenu);
console.log(data);

Explicitní instrukce nejsou volitelné

Zde je bod, který mnozí vývojáři přehlédnou a který stojí za většinou zklamání z režimu JSON: pouhé nastavení parametru nestačí. Režim garantuje syntaxi, nikoliv obsah. Musíš modelu explicitně sdělit přímo v promptu, jaký formát očekáváš.

Porovnej následující dvě volání. V prvním není uvedeno žádné strukturální vodítko: model sice vyprodukuje JSON, ale klíče, jejich názvy a vnoření se budou při každém volání lišit, což tvému následnému kódu neposkytne žádné stabilní ukotvení.

# Špatná praxe — žádná instrukce pro JSON v promptu
response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "user", "content": "Jaké jsou výhody cloudu?"}
    ],
    response_format={"type": "json_object"}
)
# Model vyprodukuje JSON, ale struktura bude nepředvídatelná

Ve druhém případě je do promptu vložena strukturální kostra. Model nyní má cíl, který má napodobit, což činí výstup při opakovaných voláních předvídatelným.

# Dobrá praxe — jasná instrukce v promptu
response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "user",
            "content": """Jaké jsou výhody cloud computingu?

Vrať svou odpověď v JSON s následující strukturou:
{
  "topic": "string",
  "advantages": [
    {"title": "string", "description": "string"}
  ]
}"""
        }
    ],
    response_format={"type": "json_object"}
)

Zahrnutí příkladu struktury do tvého promptu nasměruje model k požadovanému formátu. Není to absolutní záruka jako u vlastních strukturovaných výstupů (Custom Structured Outputs), ale pro většinu případů použití je to více než dostatečné.

Přesun instrukcí pro formát do systémového promptu

Jakmile se stejné zpracování opakuje stokrát nad různými vstupy, ponechání instrukcí pro formát v uživatelské zprávě se stává neudržitelným: kopíruješ je při každém volání a mísí se s obsahem, který má být zpracován. Místo toho je přesuň do systémového promptu.

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "system",
            "content": "Jsi asistent pro extrakci dat. SVÉ ODPOVĚDI VŽDY vracíš v JSON s klíči 'entities', 'confidence' a 'source'."
        },
        {
            "role": "user",
            "content": "Extrahuj informace z tohoto textu: 'Acme Corp, založena v roce 2019 v Lyonu, zaměstnává 250 lidí.'"
        }
    ],
    response_format={"type": "json_object"}
)

Toto oddělení – instrukce pro formát nesené rolí system a obsah ke zpracování nesený rolí user – činí tvůj kód výrazně udržovatelnějším: změna formátu se provádí pouze na jednom místě.

Parsování odpovědi

Poslední návyk, který si musíš osvojit: odpověď v režimu JSON je vždy JSON řetězec uvnitř message.content, nikdy objekt. Parsování je tvou odpovědností v obou jazycích.

import json

raw = response.choices[0].message.content
data = json.loads(raw)

# Přístup k datům
for advantage in data["advantages"]:
    print(f"- {advantage['title']}: {advantage['description']}")
const contenu = response.choices[0]?.message?.content;
if (typeof contenu !== "string") {
  throw new Error("Response does not contain JSON text.");
}
const data = JSON.parse(contenu);

data.advantages.forEach((adv: any) => {
  console.log(`- ${adv.title}: ${adv.description}`);
});

Klíčové poznatky

  • Aktivuj režim JSON pomocí response_format: {"type": "json_object"}
  • Používej client.chat.complete() (nikoliv parse())
  • Vždy instruuj model v promptu ohledně očekávané struktury JSON
  • Odpověď je JSON řetězec – parsuj ji pomocí json.loads() nebo JSON.parse()
  • Pro opakující se pipeline umísti instrukce pro formát do systémového promptu