Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Sarunas ar pastāvīgu atmiņu

Nodarbība 5 no 18 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Stāvoklis, kas saglabājas starp mijiedarbībām
  2. Sarunas uzsākšana
  3. Sarunas turpināšana
  4. Nemainīguma mehānisms
  5. Sarunas vēstures lasīšana
  6. Krātuves pārvaldība
  7. Daudzu gājienu sarunas paraugs
  8. Galvenās atziņas

Nodarbība atjaunināta 2026. gada 3. novembrī, balstoties uz mistralai SDK 3.7.0: lai iegūtu sarunas vēsturi (tās entries), izmanto client.beta.conversations.get_history; metode retrieve nepastāv, bet get atgriež tikai sarunas metadatus. Avots: client-python.

Stāvoklis, kas saglabājas starp mijiedarbībām

Viena no galvenajām Aģentu API priekšrocībām salīdzinājumā ar Chat Completions ir sarunu pastāvīgums. Tev vairs nav manuāli jāpārvalda ziņojumu vēsture — Mistral to apstrādā servera pusē. Konkrēti, vārdnīcu saraksts, ko iepriekš uzkrāji mainīgajā, saīsināji, pārsniedzot konteksta limitu, un atjaunoji katrā procesa restartēšanā, tagad pazūd no tava koda. Tev jāizseko tikai vienai lietai: identifikatoram. Un šis identifikators ievēro likumu, kas pirmajā projektā apmulsina ikvienu.

Sarunas uzsākšana

Metode conversations.start() izveido jaunu sarunu un nosūta pirmo ziņojumu. Tālāk redzamais piemērs arī izveido aģentu, kas to vadīs, un piešķir tam projekta kontekstu, ko vari izmantot vairākās mijiedarbībās.

from mistralai.client import Mistral
import os

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

# Izveido aģentu
agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Projekta asistents",
    description="Projektu vadības asistents.",
    instructions="Tu palīdzi organizēt un izsekot projektus. Esi strukturēts."
)

# Uzsāk sarunu
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Es uzsāku jaunu projektu mūsu tīmekļvietnes pārprojektēšanai. Budžets: 50 000 €, termiņš: 2026. gada septembris."
)

print(f"Sarunas ID: {response.conversation_id}")

Atgrieztais conversation_id ir tava atslēga, lai turpinātu šo sarunu vēlāk. Saglabā to vietā, kur tava lietotne to var atrast: lietotāja sesijā, datubāzē vai atbalsta biļetē, pie kuras tas attiecas.

Sarunas turpināšana

Lai pievienotu ziņojumu esošai sarunai, nodev conversation_id metodei conversations.append(). Seko šī piemēra pavedienam: otrais jautājums neatkārto budžetu vai termiņu, bet trešais prasa grafiku, neatgādinot aģentam, ka runa ir par tīmekļvietnes pārprojektēšanu. Tomēr aģentam ir viss šis konteksts.

# Pirmā mijiedarbība
response1 = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Es uzsāku tīmekļvietnes pārprojektēšanas projektu. Budžets 50 000 €."
)

# Otrā mijiedarbība — aģents atceras kontekstu
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="Kādi ir prioritārie soļi?"
)

# Trešā mijiedarbība — joprojām tajā pašā kontekstā
response3 = client.beta.conversations.append(
    conversation_id=response2.conversation_id,
    inputs="Izstrādā grafiku pirmajiem 3 mēnešiem."
)
)

Pievērs uzmanību tam, kurš identifikators tiek nodots katram izsaukumam: response2 sākas no response1 ID, bet response3 — no response2 ID. Tā nav dīvaina īpatnība; tas ir API darbības pamatmehānisms.

Nemainīguma mehānisms

Katrs conversations.append() izsaukums atgriež jaunu conversation_id. Vecais paliek lasāms, taču nākamajam papildinājumam ir jāizmanto jaunākais ID.

# Katrs papildinājums atgriež jaunu ID
id_1 = response1.conversation_id  # "conv-aaa"
id_2 = response2.conversation_id  # "conv-bbb"
id_3 = response3.conversation_id  # "conv-ccc"

# Vienmēr izmanto JAUNĀKO id turpinājumam
response4 = client.beta.conversations.append(
    conversation_id=id_3,  # Nevis id_1 vai id_2
    inputs="Pievieno klienta apstiprināšanas atskaites punktus."
)

Klasiskā kļūda ir saglabāt sākotnējo identifikatoru datubāzē, kad lietotājs atver pavedienu, un pēc tam to bez izmaiņām izmantot katram ziņojumam. Nekas neavārijas: API atbild normāli, taču katrs jautājums sākas no pirmās mijiedarbības konteksta, un tavs aģents izskatās pēc amnēzijas upura, nerādot nekādu kļūdas brīdinājumu. Vienmēr pārraksti saglabāto identifikatoru ar to, kas atgriezts atbildē.

Sarunas vēstures lasīšana

Vēsturi vari nolasīt jebkurā brīdī, kas noder gan atkļūdošanai, gan pavediena attēlošanai tavā saskarnē.

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]}...")

Krātuves pārvaldība

Pēc noklusējuma sarunas tiek glabātas Mistral mākonī. Parametrs store=False atspējo šo darbību mijiedarbībām, kuras tava iekšējā politika aizliedz atstāt trešās puses serverī.

# Īslaicīga saruna — nekas netiek saglabāts
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Konfidenciāli dati analīzei...",
    store=False
)

Kompromiss atbilst mērķim: sarunu nevar atjaunot pēc sesijas beigām, un dati netiek glabāti Mistral serveros. Tu zaudē iepriekš aprakstīto vēstures atskaņošanu, un tavai lietotnei pašai jānodrošina mijiedarbību izsekošana, ja tas ir nepieciešams. Pieņem šo lēmumu uzreiz, nevis kā pēdējā brīža izvēles rūtiņu.

Daudzu gājienu sarunas paraugs

Zemāk redzamais skelets apvieno visu iepriekš minēto interaktīvā ciklā. Galvenais punkts ir mainīgais conversation_id, kas inicializēts kā None: tas nosaka, kurš izsaukums jāveic — start() pirmajā gājienā, append() turpmākajos — un tas tiek pārdēvēts pēc katras atbildes, ievērojot nemainīguma likumu.

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="Tehniskais treneris",
    description="Treneris tehniskajiem lēmumiem.",
    instructions="Tu esi vecākais tehniskais treneris. Uzdot jautājumus, lai saprastu kontekstu pirms konsultēšanas."
)

# Sarunas cikls
conversation_id = None

while True:
    user_input = input("Tu: ")
    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"Aģents: {entry.content}")

Pielāgo to savam kontekstam, aizstājot input() ar savu faktisko ziņojumu avotu — HTTP pieprasījumu, rindas ziņojumu, tīmekļa āķa notikumu — un saglabājot conversation_id vietā, kur tava lietotne to var atrast nākamajā gājienā.

Galvenās atziņas

  • conversations.start() izveido jaunu sarunu ar pirmo ziņojumu
  • conversations.append() pievieno ziņojumu esošai sarunai
  • Katrs papildinājums atgriež jaunu conversation_id — vienmēr izmanto jaunāko
  • store=False atspējo pastāvīgumu Mistral pusē sensitīviem datiem
  • Aģents saglabā pilnu sarunas kontekstu, tev neatkārtoti nosūtot vēsturi