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

Role a zprávy

Lekce 2 z 16 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Jádro konverzačního protokolu
  2. Čtyři role
  3. Kompletní struktura vícekolové výměny
  4. Strukturovaný obsah
  5. Příznak prefixu
  6. Klíčové poznatky

Jádro konverzačního protokolu

API Chat Completions nepřijímá holý text. Očekává pole strukturovaných zpráv, z nichž každá má přiřazenu konkrétní roli. Tento systém rolí umožňuje modelu rozlišit, kdo mluví, jaký je kontext a jak má odpovědět. Stejný text – „Vždy odpovídej v JSONu“ – má jinou váhu podle toho, zda přichází jako instrukce pro vývojáře, nebo jako vstup od uživatele. Právě ovládnutí této struktury odděluje soudržného chatbota od systému, který se po třech výměnách odchýlí od tématu.

Čtyři role

API společnosti Mistral rozpoznává čtyři odlišné role, z nichž každá plní v konverzaci přesnou funkci.

Role system

Zpráva systému definuje celkové chování modelu. Umisťuje se jako první a čte se před jakoukoli výměnou. Zde nastavujete tón, omezení a kontext pro svou aplikaci. Představte si asistenta navrženého pro advokátní kancelář; zpráva systému odpovídá instruktážnímu materiálu, který byste předali novému spolupracovníkovi před jeho prvním případem.

messages = [
    {
        "role": "system",
        "content": "You are a legal assistant specializing in French law. "
                   "Respond precisely and cite relevant legal articles. "
                   "If you are unsure, state it explicitly."
    }
]

Tuto zprávu spravuje vývojář, nikdy koncový uživatel, a v rozhraní vaší aplikace se nikdy nezobrazuje.

Role user

Následuje zpráva lidského uživatele: otázka, instrukce nebo text ke zpracování. Toto je jediná část konverzace, kterou uživatelé přímo ovládají.

messages.append({
    "role": "user",
    "content": "What are the statutes of limitations in civil law?"
})

Role assistant

Tato role obsahuje předchozí odpovědi modelu. Stává se nezbytnou, jakmile konverzace přesáhne jeden tah. Bez ní by uživatel, který se zeptá „Co dluhy v obchodním styku?“, dostal neodpovídající odpověď, protože by model nevěděl, o čem se diskutuje.

messages.append({
    "role": "assistant",
    "content": "In French civil law, the standard statute of limitations is 5 years..."
})

Role tool

Poslední role vstupuje do hry při volání funkcí. Když model požádá o provedení externí funkce – například dotaz na API počasí – tuto funkci spustíte na své straně a výsledek vrátíte pod touto rolí s odkazem na ID konkrétního volání:

messages.append({
    "role": "tool",
    "content": '{"temperature": 22, "city": "Paris"}',
    "tool_call_id": "call_abc123"
})

Kompletní struktura vícekolové výměny

Podívejme se na tyto role v akci během skutečné konverzace, kde uživatel po počáteční odpovědi upřesní svůj požadavek:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

conversation = [
    {
        "role": "system",
        "content": "You are a French chef. Propose simple and tasty recipes."
    },
    {
        "role": "user",
        "content": "I want to make a dessert with apples."
    }
]

# First turn
response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

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

# Add response to history
conversation.append({"role": "assistant", "content": assistant_reply})

# Second turn
conversation.append({
    "role": "user",
    "content": "Can you adapt this recipe for 8 people?"
})

response = client.chat.complete(
    model="mistral-large-latest",
    messages=conversation
)

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

Všimni si, co tento kód ve skutečnosti dělá: v každém kole odešle zpět celou historii. Model nemá mezi požadavky žádnou trvalou paměť. „Tento recept“ dává smysl pouze proto, že je předchozí odpověď stále v poli. Za správu stavu konverzace jsi plně zodpovědný ty.

Strukturovaný obsah

Pole content přijímá dvě formy. Nejčastější je prostý řetězec. Jakmile však přenášíš něco jiného než text – například obrázek k popisu – přepneš se na seznam typovaných bloků:

# Simple content (text)
{"role": "user", "content": "Describe this image."}

# Structured content (multimodal)
{"role": "user", "content": [
    {"type": "text", "text": "Describe this image."},
    {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
]}

Příznak prefixu

Mistral nabízí jedinečnou funkci: příznak prefixu. Sám napíšeš začátek odpovědi asistenta a model je nucen od tohoto místa pokračovat. To je neuvěřitelně efektivní, když potřebuješ parsovat výstup s nulovou tolerancí chyb.

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "system", "content": "You always respond in JSON."},
        {"role": "user", "content": "List 3 European capitals."},
        {"role": "assistant", "content": '{"capitals": [', "prefix": True}
    ]
)

Model obnoví generování po řetězci {"capitals": [, čímž okamžitě eliminuje riziko, že se před otevírací závorkou objeví text „Jistě, zde je váš JSON:“. V produkčním prostředí je tato záruka formátu často cennější než instrukce třikrát opakovaná ve zprávě systému.

Osvoj si hned dva návyky. Udržuj zprávu systému stručnou: jeden dobře napsaný odstavec přináší lepší výsledky než dvě stránky pravidel, z nichž část model nakonec ignoruje. A nikdy nevymýšlej falešné odpovědi asistenta, abys model nasměroval, s jednou výjimkou – učení s několika příklady (few-shot learning), kterým se budeme zabývat v lekci 10. U dlouhých konverzací odesílej celou historii, ale sleduj kontextové okno a před jeho překročením odstraň nejstarší kola.

Klíčové poznatky

  • Čtyři role: system (chování), user (požadavek), assistant (odpověď), tool (výsledek funkce)
  • Zpráva systému jde jako první a definuje rámec aplikace
  • Model nemá paměť: s každým požadavkem odešli celou historii
  • Příznak prefixu vynutí začátek odpovědi pro kontrolu formátu výstupu