Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Keskustelujen pysyvyys

Oppitunti 5 / 18 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Tila, joka säilyy viestien välillä
  2. Keskustelun aloittaminen
  3. Keskustelun jatkaminen
  4. Muuttumattomuusmekanismi
  5. Keskusteluhistorian lukeminen
  6. Tallennustilan hallinta
  7. Monivaiheisen keskustelun malli
  8. Keskeiset asiat

Oppitunti päivitetty 3. marraskuuta 2026 perustuen mistralai SDK:n versioon 3.7.0: hae keskustelun historia (sen entries) käyttämällä client.beta.conversations.get_history; metodia retrieve ei ole olemassa, ja get palauttaa vain keskustelun metatiedot. Lähde: client-python.

Tila, joka säilyy viestien välillä

Yksi Agents API:n suurimmista eduista verrattuna Chat Completionsiin on keskustelujen pysyvyys. Sinun ei enää tarvitse hallita viestihistoriaa manuaalisesti – Mistral hoitaa sen palvelinpuolella. Erityisesti se sanakirjalista, jonka jouduit aiemmin kerryttämään muuttujaan, typistämään kontekstin täyttyessä ja rakentamaan uudelleen jokaisen prosessin käynnistyksen yhteydessä, katoaa koodistasi. Sinun tarvitsee seurata vain yhtä asiaa: tunnista. Ja tämä tunniste noudattaa sääntöä, joka kompastuttaa kaikki ensimmäisessä projektissaan.

Keskustelun aloittaminen

Metodi conversations.start() luo uuden keskustelun ja lähettää ensimmäisen viestin. Seuraava esimerkki luo myös agentin, joka suorittaa keskustelun, ja antaa sille projektikontekstin, jota voit kysyä useamman vuoron aikana.

from mistralai.client import Mistral
import os

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

# Luo agentti
agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Projektin avustaja",
    description="Projektinhallinnan avustaja.",
    instructions="Autat organisoimaan ja seuraamaan projekteja. Ole jäsennellyt."
)

# Aloita keskustelu
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Käynnistän uuden projektin verkkosivustomme uudelleensuunnittelua varten. Budjetti: 50 000 €, takaraja: syyskuu 2026."
)

print(f"Keskustelun tunnus: {response.conversation_id}")

Palautettu conversation_id on avaimesi tämän keskustelun jatkamiseen myöhemmin. Tallenna se paikkaan, josta sovelluksesi voi hakea sen: käyttäjäistuntoon, tietokantaan tai siihen liittyvään tukipyyntöön.

Keskustelun jatkaminen

Lisätäksesi viestin olemassa olevaan keskusteluun, välitä conversation_id metodille conversations.append(). Seuraa tämän esimerkin lankaa: toinen kysymys ei toista budjettia tai takarajaa, ja kolmas pyytää aikataulua muistuttamatta agenttia siitä, että kyseessä on verkkosivuston uudelleensuunnittelu. Silti agentilla on koko tämä konteksti hallussa.

# Ensimmäinen vuorovaikutus
response1 = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Käynnistän verkkosivuston uudelleensuunnitteluprojektin. Budjetti 50 000 €."
)

# Toinen vuorovaikutus – agentti muistaa kontekstin
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Mitkä ovat ensisijaiset vaiheet?"
)

# Kolmas vuorovaikutus – edelleen samassa kontekstissa
response3 = client.beta.conversations.append(
    conversation_id=response2.conversation_id,
    inputs="Laadi aikataulu ensimmäisille kolmelle kuukaudelle."
)

Kiinnitä tarkkaa huomiota siihen, mitä tunnista kullakin kutsulla käytetään: response2 alkaa response1:n tunnisteesta, response3 puolestaan response2:n tunnisteesta. Tämä ei ole omituisuus, vaan API:n ydinmekanismi.

Muuttumattomuusmekanismi

Jokainen conversations.append()-kutsu palauttaa uuden conversation_id:n. Vanha tunniste pysyy luettavana, mutta sinun on käytettävä uusinta tunnista seuraavaa lisäystä varten.

# Jokainen append palauttaa uuden tunnisteen
id_1 = response1.conversation_id  # "conv-aaa"
id_2 = response2.conversation_id  # "conv-bbb"
id_3 = response3.conversation_id  # "conv-ccc"

# Käytä aina UUSINTA tunnista jatkaaksesi
response4 = client.beta.conversations.append(
    conversation_id=id_3,  # Ei id_1 tai id_2
    inputs="Lisää asiakkaan hyväksyntävaiheet."
)

Tyypillinen virhe on tallentaa alkuperäinen tunniste tietokantaasi, kun käyttäjä avaa ketjun, ja käyttää sitä sellaisenaan jokaiselle viestille. Mikään ei kaadu: API vastaa normaalisti, mutta jokainen kysymys aloittaa alusta ensimmäisen vuorovaikutuksen kontekstista, ja agenttisi vaikuttaa kärsivän muistinmenetyksestä ilman virheilmoitusta. Ylikirjoita aina tallennettu tunniste vastauksessa palautetulla tunnisteella.

Keskusteluhistorian lukeminen

Voit lukea historian milloin tahansa, mikä auttaa sekä vianetsinnässä että ketjun näyttämisessä käyttöliittymässäsi.

conversation = client.beta.conversations.get_history(
    conversation_id=response.conversation_id
)

for entry in conversation.entries:
    print(f"[{entry.role}] {entry.type}: {entry.content[:100]}...")

Tallennustilan hallinta

Oletusarvoisesti keskustelut tallennetaan Mistralin pilveen. Parametri store=False poistaa tämän käytön niille viesteille, joita sisäinen policiesi kieltää jättämästä kolmannen osapuolen palvelimelle.

# Ohimenevä keskustelu – mitään ei tallenneta
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Luottamuksellisia tietoja analysoitavaksi...",
    store=False
)

Kompromissi vastaa tavoitetta: keskustelua ei voi palauttaa istunnon jälkeen, eikä dataa säilytetä Mistralin palvelimilla. Menetät yllä kuvatun historiantoiston, ja sovelluksesi joutuu tarvittaessa hallitsemaan viestien seuraamista itse. Tee tämä päätös etukäteen, äläkä viime hetken valintaruutuna.

Monivaiheisen keskustelun malli

Alla oleva runko soveltaa kaikkea edellä mainittua interaktiivisessa silmukassa. Avainkohta on muuttuja conversation_id, joka alustetaan arvoon None: se päättää, kumpaa kutsua tehdään – start() ensimmäisellä vuorolla, append() sen jälkeen – ja se määritetään uudelleen jokaisen vastauksen jälkeen muuttumattomuussäännön mukaisesti.

from mistralai.client import Mistral
import os

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

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Tekninen valmentaja",
    description="Valmentaja teknisiin päätöksiin.",
    instructions="Olet kokenut tekninen valmentaja. Esitä kysymyksiä ymmärtääksesi kontekstin ennen neuvomista."
)

# Keskustelusilmukka
conversation_id = None

while True:
    user_input = input("Sinä: ")
    if user_input.lower() in ["quit", "exit"]:
        break

    if conversation_id is None:
        response = client.beta.conversations.start(
            agent_id=agent.id,
            inputs=user_input
        )
    else:
        response = client.beta.conversations.append(
            conversation_id=conversation_id,
            inputs=user_input
        )

    conversation_id = response.conversation_id

    for entry in response.outputs:
        if hasattr(entry, "content"):
            print(f"Agentti: {entry.content}")

Sovella sitä omaan kontekstiisi korvaamalla input() todellisella viestilähteelläsi – HTTP-pyyntö, jonoviesti, webhook-tapahtuma – ja pysyvöimällä conversation_id paikkaan, josta sovelluksesi löytää sen seuraavalla vuorolla.

Keskeiset asiat

  • conversations.start() luo uuden keskustelun ensimmäisen viestin kera
  • conversations.append() lisää viestin olemassa olevaan keskusteluun
  • Jokainen lisäys palauttaa uuden conversation_id:n – käytä aina uusinta
  • store=False poistaa pysyvyyden Mistralin puolella arkaluonteisen datan osalta
  • Agentti säilyttää koko keskustelukontekstin ilman, että sinun tarvitsee lähettää historiaa uudelleen