Vedvarende samtaler
På denne side
Lektion opdateret 3. november 2026 baseret på
mistralaiSDK 3.7.0: Hent en samtales historik (densentries) ved hjælp afclient.beta.conversations.get_history;retrieveeksisterer ikke, oggetreturnerer kun samtale-metadata. Kilde: client-python.
Tilstand, der består på tværs af udvekslinger
En af de største fordele ved Agents API frem for Chat Completions er vedvarende samtaler. Du behøver ikke længere manuelt at administrere meddelelseshistorikken – Mistral håndterer det server-side. Specifikt forsvinder listen over ordbøger, som du tidligere akkumulerede i en variabel, afkortede ved kontekstoverløb og genopbyggede ved hver procesgenstart, fra din kode. Du behøver kun at holde styr på én ting: en identifikator. Og den identifikator følger en regel, som alle snubler over i deres første projekt.
Start af en samtale
Metoden conversations.start() opretter en ny samtale og sender den første besked. Følgende eksempel opretter også den agent, der skal køre den, og giver den en projektkontekst, som du kan spørge ind til over flere omgange.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Opret en agent
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Projektassistent",
description="Assistent til projektledelse.",
instructions="Du hjælper med at organisere og spore projekter. Vær struktureret."
)
# Start samtalen
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Jeg lancerer et nyt projekt for at redesigne vores hjemmeside. Budget: €50K, deadline: september 2026."
)
print(f"Samtale-ID: {response.conversation_id}")
Det returnerede conversation_id er din nøgle til at fortsætte denne samtale senere. Gem det et sted, hvor din applikation kan hente det: i en brugersession, en database eller den supportbillet, det relaterer sig til.
Fortsættelse af en samtale
For at tilføje en besked til en eksisterende samtale skal du sende conversation_id til conversations.append(). Følg tråden i dette eksempel: det andet spørgsmål gentager ikke budgettet eller deadline, og det tredje beder om en tidsplan uden at minde agenten om, at det er et hjemmesideredesign. Alligevel har agenten al den kontekst.
# Første udveksling
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="Jeg lancerer et projekt til redesign af hjemmeside. Budget €50K."
)
# Anden udveksling — agenten husker konteksten
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="Hvad er prioriterede trin?"
)
# Tredje udveksling — stadig i samme kontekst
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Udkast en tidsplan for de første 3 måneder."
)
Se nøje på, hvilken identifikator der fodrer hvert kald: response2 starter fra ID’et for response1, response3 fra det for response2. Dette er ikke en ejendommelighed; det er API’ets kernemekanisme.
Immunitetsmekanismen
Hvert kald til conversations.append() returnerer et nyt conversation_id. Det gamle forbliver læsbart, men du skal bruge det seneste ID til næste append.
# Hver append returnerer et nyt ID
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# Brug altid det SENESTE id til at fortsætte
response4 = client.beta.conversations.append(
conversation_id=id_3, # Ikke id_1 eller id_2
inputs="Tilføj milepæle for klientvalidering."
)
Den klassiske fejl er at gemme den oprindelige identifikator i din database, når brugeren åbner tråden, og derefter genbruge den uændret til hver besked. Intet crasher: API’et svarer normalt, men hvert spørgsmål starter forfra fra konteksten af den første udveksling, og din agent virker til at have hukommelsestab uden nogen fejl, der advarer dig. Overskriv altid den gemte identifikator med den, der returneres i svaret.
Læsning af samtalehistorik
Du kan læse historikken når som helst, hvilket hjælper både med fejlfinding og med at vise en tråd i din grænseflade.
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]}...")
Administrering af lagring
Som standard gemmes samtaler i Mistral-clouden. Parameteren store=False deaktiverer denne adfærd for udvekslinger, som din interne politik forbyder at efterlade på en tredjepartsserver.
# Ephemeral samtale — intet gemmes
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Fortrolige data til analyse...",
store=False
)
Afvæjningen matcher målet: samtalen kan ikke gendannes efter sessionen, og data opbevares ikke på Mistral-servere. Du mister afspilningen af historikken beskrevet ovenfor, og din applikation skal selv håndtere sporing af udvekslinger, hvis det er nødvendigt. Træf denne beslutning på forhånd, ikke som et sidste øjebliks afkrydsningsfelt.
Mønster for samtaler over flere omgange
Skelettet nedenfor anvender alt ovenstående i en interaktiv løkke. Nøglepunktet er variablen conversation_id, initialiseret til None: den afgør, hvilket kald der skal foretages – start() ved første omgang, append() derefter – og den tildeles igen efter hvert svar i overensstemmelse med immunitetsreglen.
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="Teknisk Coach",
description="Coach til tekniske beslutninger.",
instructions="Du er en senior teknisk coach. Stil spørgsmål for at forstå konteksten før rådgivning."
)
# Samtaleløkke
conversation_id = None
while True:
user_input = input("Du: ")
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"Agent: {entry.content}")
Tilpas det til din kontekst ved at erstatte input() med din faktiske meddelelseskilde – HTTP-anmodning, købesked, webhook-begivenhed – og ved at persistere conversation_id et sted, hvor din applikation kan finde det ved næste omgang.
Vigtige pointer
conversations.start()opretter en ny samtale med en første beskedconversations.append()tilføjer en besked til en eksisterende samtale- Hver append returnerer et nyt
conversation_id– brug altid det seneste store=Falsedeaktiverer persistens på Mistral-side for følsomme data- Agenten beholder den fulde samtalekontekst, uden at du behøver at gensende historikken