Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Vestlused ilma agendita

Õppetund 7 / 18 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Otsene mudelirežiim
  2. Vestluse alustamine mudeliga
  3. Tööriistade lisamine otseses režiimis
  4. Dünaamiliste juhiste edastamine
  5. Vestluse jätkamine otseses režiimis
  6. Agent versus otsene režiim: kuidas otsustada
  7. Näide: küsimus sunnitud kontekstis
  8. Peamised punktid

Otsene mudelirežiim

Sa ei pea alati looma agendi objekti, et kasutada vestluste API-t. Mistral võimaldab sul alustada vestlust otse mudeliga, pakkudes püsivust ilma agendi konfiguratsioonikihita. See võime tuleneb otseselt varem käsitletud arhitektuurist: vestlus on agendist sõltumatu, seega saab see suurepäraselt eksisteerida iseseisvalt.

On mitu stsenaariumi, kus see on eelistatud registreeritud agendi kasutamisele. Võib-olla soovid püsivust ilma korduskasutatavat agenti defineerimata, näiteks seetõttu, et iga niit sinu rakenduses on kordumatu. Võib-olla testid kiiresti käitumist sisseehitatud tööriistadega ja agendi loomine ning kustutamine iga katse jaoks aeglustab sind. Sinu kasutusjuhtum võib olla ühekordne: miski ei õigusta konfiguratsiooni salvestamist, mida kasutad vaid korra. Või võivad sinu juhised olla dünaamilised, arvutatud käitusajal kasutaja profiili või praeguse dokumendi põhjal – sel juhul oleks staatiline agent vale vahend.

Vestluse alustamine mudeliga

agent_id edastamise asemel edastad otse model:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.beta.conversations.start(
    model="mistral-medium-latest",
    inputs=[
        {"role": "user", "content": "Who is Albert Einstein?"}
    ]
)

print(response.outputs[-1].content)

Kõik sõltub selle parameetri valikust. agent_id korral pärib väljakutse agendi registreeritud konfiguratsiooni: selle juhised, tööriistad ja kaitsemeetmed. model korral oled otseses režiimis ja konfigureerid kõike päringus endas – midagi ei jää meelde väljaspool seda väljakutset.

Tööriistade lisamine otseses režiimis

Sisseehitatud tööriistad ei ole reserveeritud ainult agentidele. Sa deklareerid need päringus täpselt nii, nagu teeksid agendi loomisel.

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[
        {"role": "user", "content": "What are the latest Ligue 1 results?"}
    ],
    tools=[{"type": "web_search"}]
)

See on funktsionaalselt samaväärne agendiga, millel on web_search, kuid ilma konfiguratsiooni püsivuseta. Erinevus tuleb esile kümnendal väljakutsel: agendi puhul oleksid temperatuuri üks kord ja igaveseks muutnud; siin pead seda kordama igas päringus ja miski ei garanteeri, et kusagil koodis ununenud väljakutse kasutab samu seadeid.

Dünaamiliste juhiste edastamine

Otseses režiimis võtab süsteemiviis kuju system sõnumist, mis asetatakse sisendite etteotsa.

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[
        {"role": "system", "content": "You are an expert in French cuisine. Answer in 3 sentences maximum."},
        {"role": "user", "content": "How do I make a perfect béarnaise sauce?"}
    ]
)

See annab sulle sama paindlikkuse kui agendi juhised, kuid need on mööduvad – ja mis kõige tähtsam, seda stringi saab ehitada käitusajal, mida registreeritud agendi juhis ei võimalda.

Vestluse jätkamine otseses režiimis

Püsivusmehhanism toimib täpselt nii nagu agendi puhul: esimene väljakutse tagastab conversation_id, järgnevad väljakutsed seotakse sellega ja iga lisamine tagastab omakorda uue identifikaatori.

# Esimene vahetus
response1 = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[{"role": "user", "content": "Tell me about the French Revolution."}]
)

# Teine vahetus – kontekst säilib
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Who were the main figures?"
)

# Mudel teab, et räägime Prantsuse revolutsioonist

Teine küsimus ei nimeta oma teemat ega pea seda tegema: püsivus ei sõltu agendi olemasolust, vaid ainult vestlusest.

Agent versus otsene režiim: kuidas otsustada

Loo agent niipea, kui sama konfiguratsioon teenindab mitut vestlust, sest siis saad ühe muutmispunkti: juhise parandamine uuendab kõiki tulevasi niite. See on ka ainus tee, kui sinu juhised on sessiooniti stabiilsed, kui plaanid mitme agendi üleandmist – mida sellele teemale pühendatud õppetund detailselt kirjeldab – või kui sinu organisatsioon nõuab tsentraliseeritud ja auditeeritavat konfiguratsiooni, kus saad vastata küsimusele: „Milliste juhistega seda assistenti käivitati?“

Jää otseses režiimi sümmeetrilistel juhtudel: prototüüpimine või ühekordne kasutus, juhised, mis muutuvad iga vestlusega, üleandmise vajaduse puudumine või soov vähendada API väljakutseid, kõrvaldades agendi loomise ja kustutamise. Arenduses on see viimane põhjus sageli iseenesest piisav.

Näide: küsimus sunnitud kontekstis

Allpool olev funktsioon illustreerib suurepäraselt otsest režiimi. Kontekst on argument, seega erineb see iga väljakutsega, ja süsteemiviis ehitatakse selle ümber, et takistada mudelil tugineda välisele teadmistele. Ükski registreeritud agent ei saaks seda piirangut kanda, kuna see muutub iga kutsega.

def ask_question(context: str, question: str):
    """Ask a question within a given context, without creating an agent."""
    response = client.beta.conversations.start(
        model="mistral-large-latest",
        inputs=[
            {"role": "system", "content": f"Context: {context}. Answer using only this context."},
            {"role": "user", "content": question}
        ]
    )
    return response.outputs[-1].content

# Kasutus
answer = ask_question(
    context="Corsen AI is a French startup specializing in sovereign AI, founded in 2025.",
    question="When was Corsen AI founded?"
)

Kasuta seda mustrit oma vajaduste jaoks, asendades kodeeritud konteksti tegelikult asjakohase tekstiga – vaadatud tooteleht, valitud dokumendi lõik – ja saad raamistatud küsimuste-vastuste ehitusploki ilma igasuguse hallatava konfiguratsioonita.

Peamised punktid

  • Vestlusi saab alustada parameetriga model= asemel agent_id=
  • Otsene režiim pakub püsivust ilma agendi konfiguratsioonikihita
  • Saad edastada tööriistu ja juhiseid otse päringus
  • Otsene režiim on ideaalne prototüüpimiseks ja ühekordseks kasutuseks
  • Üleandmise ja korduskasutatavate konfiguratsioonide jaoks eelista agendi loomist