Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Pokalbiai, kurie išlieka

Paskaita 5 iš 18 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Būsena, išliekanti per visus mainus
  2. Pokalbio pradžia
  3. Pokalbio tęsimas
  4. Nekintamumo mechanizmas
  5. Pokalbio istorijos skaitymas
  6. Saugyklos valdymas
  7. Daugiaetapių pokalbių šablonas
  8. Svarbiausi punktai

Pamoka atnaujinta 2026 m. lapkričio 3 d. pagal mistralai SDK 3.7.0 versiją: pokalbio istorijai (jos entries) gauti naudok client.beta.conversations.get_history; metodo retrieve nėra, o get grąž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 žinute
  • conversations.append() priduria žinutę į esamą pokalbį
  • Kiekvienas append grąžina naują conversation_id – visada naudok naujausią
  • store=False išjungia išsaugojimą „Mistral“ pusėje konfidencialiems duomenims
  • Agentas išlaiko visą pokalbio kontekstą, tau nereikia iš naujo siųsti istorijos