Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Konversazzjonijiet Persistenti

Lezzjoni 5 / 18 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Stat li Jippersisti Matul l-Iskambji
  2. Tibda Konversazzjoni
  3. Tkomplija ta’ Konversazzjoni
  4. Il-Mekkaniżmu tal-Immutabbiltà
  5. Qari tal-Istorja tal-Konversazzjoni
  6. Ġestjoni tal-Ħażna
  7. Mudell ta’ Konversazzjoni Multi-Dawra
  8. Punti Ewlenin

Lezzjoni aġġornata fit-3 ta’ Novembru 2026 ibbażata fuq l-SDK mistralai 3.7.0: irkupra l-istorja ta’ konversazzjoni (l-entries tagħha) bl-użu ta’ client.beta.conversations.get_history; retrieve ma jeżistix, u get jirritorna biss il-metadejta tal-konversazzjoni. Sors: client-python.

Stat li Jippersisti Matul l-Iskambji

Wieħed mill-vantaġġi ewlenin tal-API tal-Aġenti meta mqabbel mal-Chat Completions huwa l-persistenza tal-konversazzjoni. M’għadekx għandek bżonn timmaniġġja manwalment l-istorja tal-messaġġi—Mistral jittrattaha fuq is-server. Speċifikament, il-lista ta’ dizzjunarji li kont tiġbor f’varjabbli, taqta’ meta l-kuntest jimtela, u tibni mill-ġdid f’kull riavvju tal-proċess, tisparixxi mill-kodiċi tiegħek. Għandek bżonn biss traċċa affari waħda: identifikatur. U dak l-identifikatur isegwi regola li tqarraq lil kulħadd fl-ewwel proġett tiegħu.

Tibda Konversazzjoni

Il-metodu conversations.start() joħloq konversazzjoni ġdida u jibgħat l-ewwel messaġġ. L-eżempju li ġej joħloq ukoll l-aġent li se jmexxiha, imbagħad jagħtih kuntest tal-proġett li tista’ tikkonsulta fuq diversi dawriet.

from mistralai.client import Mistral
import os

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

# Oħloq aġent
agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Assistent tal-Proġett",
    description="Assistent għall-ġestjoni tal-proġetti.",
    instructions="Inti tgħin torganizza u ssegwi l-proġetti. Kun strutturat."
)

# Ibda l-konversazzjoni
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Qed niedaq proġett ġdid biex nerġgħu niddisinjaw is-sit web tagħna. Baġit: €50K, skadenza: Settembru 2026."
)

print(f"ID tal-Konversazzjoni: {response.conversation_id}")

L-conversation_id irritornat hija ċ-ċavetta tiegħek biex tkompli din il-konversazzjoni aktar tard. Aħżinha fejn l-applikazzjoni tiegħek tista’ terġa’ ssibha: f’sessjoni tal-utent, f’database, jew fit-ticket ta’ appoġġ li tirrigwarda.

Tkomplija ta’ Konversazzjoni

Biex iżżid messaġġ f’konversazzjoni eżistenti, għaddi l-conversation_id lil conversations.append(). Segwi l-fil f’dan l-eżempju: it-tieni mistoqsija ma tirrepetix il-baġit jew l-iskadenza, u t-tielet titlob skeda mingħajr ma tfakkar lill-aġent li huwa ridisinn ta’ sit web. Madankollu, l-aġent għandu dak il-kuntest kollu.

# L-ewwel skambju
response1 = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Qed niedaq proġett ta' ridisinn ta' sit web. Baġit €50K."
)

# It-tieni skambju — l-aġent jiftakar il-kuntest
response2 = client.beta.conversations.append(
    conversation_id=response1.conversation_id,
    inputs="X'inhuma l-passi prijoritarji?"
)

# It-tielet skambju — għadu fl-istess kuntest
response3 = client.beta.conversations.append(
    conversation_id=response2.conversation_id,
    inputs="Abbozza skeda għall-ewwel 3 xhur."
)

Ara sew liema identifikatur jingħata f’kull sejħa: response2 tibda mill-ID ta’ response1, u response3 minn dik ta’ response2. Din mhix kapriċċ; dan huwa l-mekkaniżmu ewlieni tal-API.

Il-Mekkaniżmu tal-Immutabbiltà

Kull sejħa għal conversations.append() tirritorna ID ġdida ta’ conversation_id. Dik antika tibqa’ tista’ tiġi qari, iżda trid tuża l-aħħar ID għall-appenn li jmiss.

# Kull appenn jirritorna ID ġdida
id_1 = response1.conversation_id  # "conv-aaa"
id_2 = response2.conversation_id  # "conv-bbb"
id_3 = response3.conversation_id  # "conv-ccc"

# Dejjem uża l-aħħar id biex tkompli
response4 = client.beta.conversations.append(
    conversation_id=id_3,  # Mhux id_1 jew id_2
    inputs="Żid milestones ta' validazzjoni tal-klijent."
)

L-iżball klassiku huwa li taħżen l-identifikatur inizjali fid-database tiegħek meta l-utent jiftaħ il-fil, imbagħad terġa’ tużah bħala tali għal kull messaġġ. Xejn ma jaqbeż: l-API tirrispondi normalment, iżda kull mistoqsija terġa’ tibda mill-kuntest tal-ewwel skambju, u l-aġent tiegħek jidher li għandu amneżija mingħajr l-ebda żball li jallertak. Dejjem ikteb fuq l-identifikatur maħżun b’dak irritornat fir-rispons.

Qari tal-Istorja tal-Konversazzjoni

Tista’ taqra l-istorja fi kwalunkwe ħin, li tgħin kemm fid-debugging kif ukoll biex turi fil f’interfaċċa tiegħek.

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

Ġestjoni tal-Ħażna

B’mod predefinit, il-konversazzjonijiet jinħażnu fis-sħaba ta’ Mistral. Il-parametru store=False jiddiżattiva dan l-imġiba għal skambji li l-politika interna tiegħek tipprojbixxi li jitħallew fuq server ta’ parti terza.

# Konversazzjoni effimera — xejn ma jinħażen
response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Data kunfidenzjali biex tiġi analizzata...",
    store=False
)

Il-kumpens jaqbel mal-għan: il-konversazzjoni ma tistax tiġi rkuprata wara s-sessjoni, u d-data ma tinżammx fuq is-servers ta’ Mistral. Titlef ir-riproduzzjoni tal-istorja deskritta hawn fuq, u l-applikazzjoni tiegħek trid tittratta t-traċċar tal-iskambji hi stess jekk ikun meħtieġ. Ħu din id-deċiżjoni minn qabel, mhux bħala kaxxa li tiċċekkja fl-aħħar mument.

Mudell ta’ Konversazzjoni Multi-Dawra

L-istruttura hawn taħt tapplika kollox imsemmi hawn fuq f’loop interattiv. Il-punt ewlieni huwa l-varjabbli conversation_id, inizjalizzata għal None: tiddeċiedi liema sejħa ssir—start() fl-ewwel dawra, append() wara—u terġa’ tiġi assenjata wara kull rispons, li ssegwi r-regola tal-immutabbiltà.

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="Kowċ Tekniku",
    description="Kowċ għal deċiżjonijiet tekniċi.",
    instructions="Inti kowċ tekniku senior. Agħmel mistoqsijiet biex tifhem il-kuntest qabel ma tagħti parir."
)

# Loop tal-konversazzjoni
conversation_id = None

while True:
    user_input = input("Inti: ")
    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ġent: {entry.content}")

Adattaha għall-kuntest tiegħek billi tibdel input() mas-sors reali tal-messaġġi tiegħek—talba HTTP, messaġġ ta’ queue, avveniment ta’ webhook—u tippersistixxi conversation_id fejn l-applikazzjoni tiegħek tista’ ssibha fid-dawra li jmiss.

Punti Ewlenin

  • conversations.start() toħloq konversazzjoni ġdida b’ewwel messaġġ
  • conversations.append() iżżid messaġġ f’konversazzjoni eżistenti
  • Kull appenn jirritorna ID ġdida ta’ conversation_id—dejjem uża l-aħħar waħda
  • store=False jiddiżattiva l-persistenza fuq in-naħa ta’ Mistral għal data sensittiva
  • L-aġent iżomm il-kuntest sħiħ tal-konversazzjoni mingħajr ma jkollok bżonn terġa’ tibgħat l-istorja