Pokalbiai, kurie išlieka
Šiame puslapyje
Pamoka atnaujinta 2026 m. lapkričio 3 d. pagal
mistralaiSDK 3.7.0 versiją: pokalbio istorijai (josentries) gauti naudokclient.beta.conversations.get_history; metodoretrievenėra, ogetgrąžina tik pokalbio metaduomenis. Šaltinis: client-python.
Būsena, išliekanti per visus mainus
Vienas didžiausių „Agents API“ privalumų, lyginant su „Chat Completions“, yra pokalbių išsaugojimas. Tau nebereikia rankiniu būdu valdyti žinučių istorijos – tai serverio pusėje atlieka „Mistral“. Konkrečiai kalbant, žodynų sąrašas, kurį anksčiau kaupdavai kintamajame, trumpindavai perpildžius kontekstą ir iš naujo kurdavai paleidus procesą, dabar iš tavo kodo dingsta. Tau reikia sekti tik vieną dalyką: identifikatorių. Ir šis identifikatorius paklūsta taisyklei, kurią visi suklysta pirmajame projekte.
Pokalbio pradžia
Metodas conversations.start() sukuria naują pokalbį ir išsiunčia pirmąją žinutę. Šiame pavyzdyje taip pat sukuriamas agentas, kuris jį vykdys, ir jam suteikiamas projekto kontekstas, kurį galėsi užklausti per kelis etapus.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Sukurti agentą
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Project Assistant",
description="Project management assistant.",
instructions="You help organize and track projects. Be structured."
)
# Pradėti pokalbį
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="I'm launching a new project to redesign our website. Budget: €50K, deadline: September 2026."
)
print(f"Conversation ID: {response.conversation_id}")
Grąžintas conversation_id yra tavo raktas norint tęsti šį pokalbį vėliau. Išsaugok jį ten, kur tavo programa galės jį pasiekti: naudotojo sesijoje, duomenų bazėje arba susijusiame pagalbos biliete.
Pokalbio tęsimas
Norėdamas pridėti žinutę į esamą pokalbį, perduok conversation_id metodui conversations.append(). Sek šio pavyzdžio eigą: antrajame klausime nekartojamas biudžetas ar terminas, o trečiajame prašoma sudaryti grafiką neprimenant agentui, kad tai svetainės pertvarkymas. Vis dėlto agentas turi visą tą kontekstą.
# Pirmasis mainai
response1 = client.beta.conversations.start(
agent_id=agent.id,
inputs="I'm launching a website redesign project. Budget €50K."
)
# Antrieji mainai – agentas prisimena kontekstą
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="What are the priority steps?"
)
# Tretieji mainai – vis tame pačiame kontekste
response3 = client.beta.conversations.append(
conversation_id=response2.conversation_id,
inputs="Draft a schedule for the first 3 months."
)
Atidžiai pažiūrėk, kuris identifikatorius naudojamas kiekvienam kvietimui: response2 prasideda nuo response1 ID, o response3 – nuo response2. Tai ne keistenybė; tai pagrindinis API veikimo mechanizmas.
Nekintamumo mechanizmas
Kiekvienas conversations.append() kvietimas grąžina naują conversation_id. Senasis lieka skaitomas, tačiau kitam papildymui turi naudoti naujausią ID.
# Kiekvienas append grąžina naują ID
id_1 = response1.conversation_id # "conv-aaa"
id_2 = response2.conversation_id # "conv-bbb"
id_3 = response3.conversation_id # "conv-ccc"
# Tęsdamas visada naudok NAUJAUSIĄ id
response4 = client.beta.conversations.append(
conversation_id=id_3, # Ne id_1 ar id_2
inputs="Add client validation milestones."
)
Klasikinė klaida – išsaugoti pradinį identifikatorių duomenų bazėje, kai naudotojas atveria giją, ir tada jį naudoti tokį patį kiekvienai žinutei. Niekas nesugriūva: API atsako normaliai, tačiau kiekvienas klausimas prasideda nuo pirmųjų mainų konteksto, ir tavo agentas elgiasi taip, lyg turėtų amneziją, nors jokia klaida tavęs neįspėja. Visada perrašyk saugomą identifikatorių tuo, kuris grąžinamas atsakyme.
Pokalbio istorijos skaitymas
Istoriją gali skaityti bet kada; tai padeda tiek derinant klaidas, tiek rodant giją savo sąsajoje.
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]}...")
Saugyklos valdymas
Pagal numatytuosius nustatymus pokalbiai saugomi „Mistral“ debesyje. Parametras store=False išjungia šį elgesį tiems mainams, kuriuos tavo vidinė politika draudžia palikti trečiosios šalies serveryje.
# Laikinas pokalbis – niekas neišsaugoma
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Confidential data to analyze...",
store=False
)
Kompromisas atitinka tikslą: pokalbio nebegalima atkurti pasibaigus sesijai, o duomenys nesaugomi „Mistral“ serveriuose. Prarandi aukščiau aprašytą istorijos atkūrimo galimybę, ir tavo programa pati turi valdyti mainų sekimą, jei to reikia. Priimk šį sprendimą iš anksto, o ne kaip paskutinės minutės varnelę.
Daugiaetapių pokalbių šablonas
Žemiau pateikta struktūra sujungia visa tai, kas išdėstyta pirmiau, į interaktyvią kilpą. Svarbiausias momentas – kintamasis conversation_id, inicializuojamas kaip None: jis nusprendžia, kurį kvietimą atlikti – start() pirmajame etape, vėliau – append() – ir po kiekvieno atsakymo jam priskiriama nauja reikšmė, laikantis nekintamumo taisyklės.
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="Technical Coach",
description="Coach for technical decisions.",
instructions="You are a senior technical coach. Ask questions to understand the context before advising."
)
# Pokalbio kilpa
conversation_id = None
while True:
user_input = input("You: ")
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}")
Pritaikyk tai savo kontekstui pakeisdamas input() savo tikruoju žinučių šaltiniu – HTTP užklausa, eilės žinute ar „webhook“ įvykiu – ir išsaugodamas conversation_id ten, kur tavo programa galės jį rasti kitame etape.
Svarbiausi punktai
conversations.start()sukuria naują pokalbį su pirmąja žinuteconversations.append()priduria žinutę į esamą pokalbį- Kiekvienas
appendgrąžina naująconversation_id– visada naudok naujausią store=Falseišjungia išsaugojimą „Mistral“ pusėje konfidencialiems duomenims- Agentas išlaiko visą pokalbio kontekstą, tau nereikia iš naujo siųsti istorijos