Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Proces v 5 krokoch

Lekcia 2 z 14 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Jasný protokol medzi tebou a modelom
  2. Tok v detailoch
  3. Vzorce toku
  4. Kľúčové poznatky

Jasný protokol medzi tebou a modelom

Volanie funkcií v Mistrale sa riadi presne definovaným procesom piatich krokov. Čo robí tento protokol čitateľným, je fakt, že každý krok má jediného vlastníka: buď ty (vývojár), model, alebo používateľ. Žiadny krok nie je zdieľaný a žiadny nie je nejednoznačný. Venuj čas zapamätaniu si tohto rozdelenia práce ešte pred napísaním prvého riadku kódu: väčšina chýb pri volaní funkcií vzniká vtedy, keď vývojár očakáva, že krok vybaví model, hoci v skutočnosti patrí do jeho zodpovednosti.

1

Definuj funkcie (Vývojár)

Každú dostupnú funkciu popíšeš pomocou schémy JSON: názov, popis, parametre, typy a povinné polia. Model vidí iba túto špecifikáciu, nie tvoj kód.

2

Používateľ položí otázku (Používateľ)

Používateľ položí svoju otázku v prirodzenom jazyku. Túto požiadavku spolu so zoznamom dostupných nástrojov odošleš modelu Mistral.

3

Generuj argumenty (Model)

Model analyzuje požiadavku, vyberie vhodnú funkciu a vygeneruje argumenty vo formáte JSON. Funkciu nevykonáva – iba ti povie, čo máš zavolať a s akými parametrami.

4

Vykonaj funkciu (Vývojár)

Tvoj kód extrahuje názov funkcie a argumenty z odpovede modelu, spustí zodpovedajúcu funkciu a získa výsledok.

5

Vygeneruj konečnú odpoveď (Model)

Výsledok funkcie odošleš späť modelu. Ten ho integruje do kontextu konverzácie a sformuluje prirodzenú odpoveď pre používateľa.

Tok v detailoch

Týchto päť krokov sa priamo mapuje do kódu. Prejdime si ich na jednom zámerne minimálnom príklade: používateľ chce zistiť stav platby T1001. Tento istý príklad použijeme ako červenú niť až do konca bloku „Implementácia v Pythone“, takže si teraz zapamätaj jeho identifikátory.

Krok 1: Definuješ nástroje

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_payment_status",
            "description": "Retrieves the status of a payment given its transaction ID",
            "parameters": {
                "type": "object",
                "properties": {
                    "transaction_id": {
                        "type": "string",
                        "description": "The unique transaction identifier (e.g., T1001)"
                    }
                },
                "required": ["transaction_id"]
            }
        }
    }
]

Nič z toho nie je vykonateľný kód: je to iba opis. Model sa dozvie, že existuje funkcia s názvom get_payment_status, čo robí a že vyžaduje transaction_id typu reťazec. Nikdy sa nedozvie, ako je funkcia implementovaná.

Krok 2: Používateľ položí svoju otázku

messages = [
    {"role": "user", "content": "What is the status of payment T1001?"}
]

Krok 3: Model vygeneruje argumenty

from mistralai.client import Mistral

client = Mistral(api_key="your-api-key")
response = client.chat.complete(
    model="mistral-large-latest",
    messages=messages,
    tools=tools
)

# The model returns a tool_call:
# function.name = "get_payment_status"
# function.arguments = '{"transaction_id": "T1001"}'

Model extrahoval „T1001“ z vety a umiestnil ho do správneho poľa. Všimni si, že arguments prichádzajú ako reťazec, nie ako slovník: tento detail vybavíš v ďalšom kroku.

Krok 4: Vykonáš funkciu

import json

tool_call = response.choices[0].message.tool_calls[0]
args = json.loads(tool_call.function.arguments)
result = get_payment_status(**args)
# → {"status": "paid", "date": "2026-03-15"}

Krok 5: Model sformuluje odpoveď

messages.append(response.choices[0].message)
messages.append({
    "role": "tool",
    "name": "get_payment_status",
    "content": json.dumps(result),
    "tool_call_id": tool_call.id
})

final = client.chat.complete(
    model="mistral-large-latest",
    messages=messages,
    tools=tools
)
print(final.choices[0].message.content)
# → "Payment T1001 was made on March 15, 2026."

Do histórie sa pridávajú dve správy, nikdy nie len jedna: správa asistenta nesúca požiadavku na volanie, po ktorej nasleduje správa nesúca výsledok. tool_call_id tieto dve správy spája. Ak vynecháš ktorúkoľvek z nich, API požiadavku odmietne alebo model odpovie mimo tému.

Vzorce toku

V závislosti od zložitosti požiadavky môže tento tok nadobúdať rôzne formy. Najjednoduchší prípad nastáva, keď nie je zapojená žiadna funkcia: používateľ položí všeobecnú otázku – „Čo vieš robiť?“ – a model odpovie priamo, bez toho, aby sa vôbec dotkol nástrojov. Ďalej nasleduje jednoduché volanie, ktoré sme práve prešli: jedna funkcia, jeden výsledok, jedna odpoveď.

Ďalšie dve formy sú zaujímavejšie. Pri sekvenčnom reťazci model zavolá prvú funkciu, prečíta si výsledok a použije ho na rozhodnutie o druhom volaní – typicky získava ID zákazníka pred dotazom na jeho faktúry. Pri paralelnom volaní požaduje vykonanie viacerých funkcií naraz, pretože žiadna z nich nie je závislá od druhej. Týmto dvom vzorcom venujeme celé lekcie; zatiaľ si zapamätaj, že obe sa spoliehajú presne na vyššie uvedených päť krokov, ktoré sa jednoducho opakujú.

Kľúčové poznatky

  • Volanie funkcií sa riadi procesom v 5 krokoch s jasne definovanými zodpovednosťami
  • Model nikdy nemôže priamo vykonať funkciu – iba generuje argumenty
  • Tvoj kód je strážcom brány: rozhoduje, či sa funkcia vykoná, alebo nie
  • Výsledok funkcie sa odošle späť modelu, aby mohol sformulovať prirodzenú odpoveď
  • Tok môže byť jednoduchý (jedno volanie) alebo zložitý (sekvenčný, paralelný)