Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Procesas iš 5 žingsnių

Paskaita 2 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. Aiškus protokolas tarp tavęs ir modelio
  2. Eiga išsamiai
  3. Eigos šablonai
  4. Svarbiausi punktai

Aiškus protokolas tarp tavęs ir modelio

„Mistral“ funkcijų kvietimas laikosi gerai apibrėžto penkių žingsnių proceso. Šį protokolą lengva suprasti todėl, kad kiekvienas žingsnis turi tik vieną atsakingąją šalį: arba tu (kūrėjas), arba modelis, arba naudotojas. Joks žingsnis nėra bendras ir joks nėra dviprasmiškas. Skirk laiko įsiminti šį darbų pasiskirstymą prieš rašydamas bent vieną kodo eilutę: dauguma funkcijų kvietimo klaidų kyla tada, kai kūrėjas tikisi, jog modelis atliks žingsnį, kuris iš tikrųjų yra jo paties atsakomybė.

1

Apibrėžk funkcijas (Kūrėjas)

Tu aprašai kiekvieną prieinamą funkciją naudodamas JSON schemą: pavadinimą, aprašymą, parametrus, tipus ir privalomus laukus. Modelis mato tik šią specifikaciją, o ne tavo kodą.

2

Naudotojas užduoda klausimą (Naudotojas)

Naudotojas užduoda savo klausimą natūralia kalba. Tu siunči šį užklausimą „Mistral“ modeliui kartu su prieinamų įrankių sąrašu.

3

Sugeneruok argumentus (Modelis)

Modelis išanalizuoja užklausą, pasirenka tinkamą funkciją ir sugeneruoja argumentus JSON formatu. Jis nevykdo funkcijos – jis tiesiog tau pasako, ką reikia iškviesti ir su kuriais parametrais.

4

Įvykdyk funkciją (Kūrėjas)

Tavo kodas iš modelio atsakymo ištraukia funkcijos pavadinimą ir argumentus, paleidžia atitinkamą funkciją ir gauna rezultatą.

5

Sugeneruok galutinį atsakymą (Modelis)

Tu siunči funkcijos rezultatą atgal modeliui. Jis integruoja rezultatą į pokalbio kontekstą ir suformuluoja natūralų atsakymą naudotojui.

Eiga išsamiai

Šie penki žingsniai tiesiogiai atitinka kodą. Panagrinėkime juos naudodami vieną, tyčia minimalų pavyzdį: naudotojas nori sužinoti mokėjimo T1001 būseną. Naudosime šį patį pavyzdį kaip raudoną siūlą iki pat skyriaus „Python implementacija“ pabaigos, todėl jau dabar įsimink jo identifikatorius.

1 žingsnis: Tu apibrėži įrankius

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"]
            }
        }
    }
]

Čia nėra jokio vykdomojo kodo: tai tik aprašymas. Modelis sužino, kad egzistuoja funkcija pavadinimu get_payment_status, ką ji daro ir kad jai reikia transaction_id (eilutės tipo) argumento. Jis niekada nesužino, kaip funkcija yra implementuota.

2 žingsnis: Naudotojas užduoda savo klausimą

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

3 žingsnis: Modelis sugeneruoja argumentus

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"}'

Modelis ištraukė „T1001“ iš sakinio ir įdėjo jį į tinkamą lauką. Atkreipk dėmesį, kad arguments atkeliauja kaip eilutė, o ne kaip žodynas: šią detalę tvarkysi kitame žingsnyje.

4 žingsnis: Tu įvykdai funkciją

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"}

5 žingsnis: Modelis suformuluoja atsakymą

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."

Į istoriją įtraukiami du pranešimai, niekada tik vienas: asistento pranešimas, kuriame yra kvietimo užklausa, ir po jo einantis pranešimas su rezultatu. Juos susieja tool_call_id. Praleisk bent vieną iš jų ir API atmes užklausą, arba modelis atsakys ne į temą.

Eigos šablonai

Priklausomai nuo užklausos sudėtingumo, ši eiga gali įgyti skirtingas formas. Paprasčiausias atvejis – kai funkcijos nenaudojamos: naudotojas užduoda bendrą klausimą („Ką tu moki?“) ir modelis atsako tiesiogiai, nė karto nepasinaudodamas įrankiais. Kitas atvejis – tai paprastas kvietimas, kurį ką tik nagrinėjome: viena funkcija, vienas rezultatas, vienas atsakymas.

Kitos dvi formos yra įdomesnės. Nuoseklioje grandinėje modelis iškviečia pirmąją funkciją, perskaito rezultatą ir panaudoja jį nuspręsdamas dėl antrojo kvietimo – pavyzdžiui, pirmiausia gauna kliento ID, o tada užklausia jo sąskaitas. Lygiagrečiojo kvietimo atveju jis vienu metu prašo įvykdyti kelias funkcijas, nes nė viena iš jų nepriklauso nuo kitos. Šiems dviem šablonams skirsime atskiras pamokas; kol kas tiesiog įsimink, kad abu jie remiasi tais pačiais penkiais aukščiau aprašytais žingsniais, kurie tiesiog kartojami.

Svarbiausi punktai

  • Funkcijų kvietimas laikosi 5 žingsnių proceso su aiškiomis atsakomybėmis
  • Modelis niekada negali tiesiogiai įvykdyti funkcijos – jis tik sugeneruoja argumentus
  • Tavo kodas yra vartininkas: jis sprendžia, ar vykdyti funkciją, ar ne
  • Funkcijos rezultatas siunčiamas atgal modeliui, kad jis galėtų suformuluoti natūralų atsakymą
  • Eiga gali būti paprasta (vienas kvietimas) arba sudėtinga (nuosekli, lygiagreti)