Keskustelujen pysyvyys
Tällä sivulla
Oppitunti päivitetty 3. marraskuuta 2026 perustuen
mistralaiSDK:n versioon 3.7.0: hae keskustelun historia (senentries) käyttämälläclient.beta.conversations.get_history; metodiaretrieveei ole olemassa, jagetpalauttaa 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 keraconversations.append()lisää viestin olemassa olevaan keskusteluun- Jokainen lisäys palauttaa uuden
conversation_id:n – käytä aina uusinta store=Falsepoistaa pysyvyyden Mistralin puolella arkaluonteisen datan osalta- Agentti säilyttää koko keskustelukontekstin ilman, että sinun tarvitsee lähettää historiaa uudelleen