Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Comhrá Il-Chasadh

Ceacht 7 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Thar glaonna aonair
  2. An Prionsabal: Stair a Choinneáil
  3. Lúb Iomlán Comhrá
  4. Sampla de Chomhrá Il-Chasadh
  5. Glaonna Seicheamhacha a Shlabhrú
  6. Méid na Staire a Bhainistiú
  7. Príomhphointí

Thar glaonna aonair

I bhfeidhmchlár fíorshaol, ní chuireann úsáideoirí ceist amháin agus imeacht. Déanann siad slabhrú d’iarratais, filleann siad ar ábhair roimhe seo, agus tugann siad leideanna cosúil le “cad faoin gceann seo?” nach féidir leis an abairt amháin a réiteach. Caithfidh glaonna feidhme oibriú laistigh den chomhthéacs comhrá il-chasadh seo, áit ar féidir leis an tsamhail feidhmeanna a ghlaonna ag gach céim den dialóg gan rian a chailleadh ar an méid a tháinig roimhe.

An Prionsabal: Stair a Choinneáil

Tagann an eochair síos d’aon abairt amháin: coinnigh gach teachtaireacht i liosta a fhásann le gach malartú. Níl aon chuimhne ag an tsamhail aici féin idir glaonna API; is é an t-aon chomhthéacs atá aici ná an méid a sheolann tú ar ais. Is é an stair iomlán seo a ligeann di tagairtí intuigthe a thuiscint.

import os
import json
from mistralai.client import Mistral
from functools import partial

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
model = "mistral-large-latest"

# Conversation history
messages = [
    {
        "role": "system",
        "content": "You are a payment tracking assistant. "
                   "Respond in concise English."
    }
]

Lúb Iomlán Comhrá

Oibríonn an cód thíos i dhá chéim. Déanann process_tool_calls gach glao a d’iarr an tsamhail a fhorghníomhú agus tosaíonn sé an comhrá arís leis na torthaí; déileálann chat le casadh iomlán, ó ionchur an úsáideora go dtí an téacs deiridh.

def process_tool_calls(response, messages, available_functions, tools):
    """Processes tool_calls and returns the final response."""
    message = response.choices[0].message
    messages.append(message)

    # Execute each tool_call
    for tool_call in message.tool_calls:
        function_name = tool_call.function.name
        function_params = json.loads(tool_call.function.arguments)

        if function_name in available_functions:
            result = available_functions[function_name](**function_params)
        else:
            result = json.dumps({"error": f"Unknown function {function_name}"})

        messages.append({
            "role": "tool",
            "name": function_name,
            "content": result,
            "tool_call_id": tool_call.id
        })

    # Call the model again with the results
    return client.chat.complete(
        model=model, messages=messages, tools=tools
    )


def chat(user_input: str, messages: list, tools: list,
         available_functions: dict) -> str:
    """Handles a complete conversation turn."""
    messages.append({"role": "user", "content": user_input})

    response = client.chat.complete(
        model=model, messages=messages, tools=tools
    )

    message = response.choices[0].message

    # Loop as long as the model wants to call functions
    while message.tool_calls and len(message.tool_calls) > 0:
        response = process_tool_calls(
            response, messages, available_functions, tools
        )
        message = response.choices[0].message

    # The model is done—it responds with text
    messages.append(message)
    return message.content

Is é an lúb while an píosa ríthábhachtach. Tar éis toradh feidhme a fháil, d’fhéadfadh an tsamhail ceann eile a iarraidh go deimhin: leanann an lúb ar aghaidh fad is a tháirgeann sí tool_calls agus ní stopann sí ach nuair a thugann sí téacs ar ais sa deireadh. D’fhéadfadh if simplí an chéad ghlao a láimhseáil agus ansin freagra folamh a thabhairt i ngach cás ina mbeadh dhá ghlao ag teastáil.

Sampla de Chomhrá Il-Chasadh

Feicimis conas a oibríonn an lúb seo ar fud ceithre chasadh slabhraithe.

# Turn 1
reponse = chat("What is the status of payment T1001?",
               messages, tools, available_functions)
print(f"Assistant : {reponse}")
# → "Payment T1001 status: paid."

# Turn 2 — follow-up question
reponse = chat("When was it made?",
               messages, tools, available_functions)
print(f"Assistant : {reponse}")
# → "Payment T1001 was made on March 15, 2026."

# Turn 3 — new transaction
reponse = chat("Compare with payment T1003.",
               messages, tools, available_functions)
print(f"Assistant : {reponse}")
# → "Payment T1003 is pending, unlike T1001 which is paid."

# Turn 4 — question without function
reponse = chat("Thanks, that's all for today.",
               messages, tools, available_functions)
print(f"Assistant : {reponse}")
# → "You're welcome! Feel free to ask if you have other questions."

Is é Casadh 2 an ceann ar chóir duit breathnú go géar air. Níl aon aitheantóir sa cheist “Cathain a rinneadh é?”; is í an stair a ligeann don tsamhail a thuiscint go mbaineann sé seo fós le T1001 agus retrieve_payment_date a ghlaonna leis an argóint cheart. Bain na teachtaireachtaí ó Chasadh 1 agus éiríonn an abairt seo doshámhlaithe. I gCasadh 3, féadfaidh an tsamhail cinneadh a dhéanamh glaonna iolracha a dhéanamh—stádas agus dáta do T1003—chun an chur i gcomparáid a thógáil le torthaí a fuarthas cheana féin do T1001. N spreagann Casadh 4 aon ghlao ar chor ar bith: tá a fhios ag an tsamhail cathain a choinneoidh sí siar freisin.

Glaonna Seicheamhacha a Shlabhrú

Éilíonn roinnt iarratas go bhfanfadh an tsamhail ar toradh amháin sula mbeadh a fhios aici cad a iarrfaidh sí ina dhiaidh sin. Láimhseálann an lúb while i chat() an cás seo gan aon líne bhreise cóid.

# User asks for something requiring 2 sequential calls
reponse = chat(
    "Show me the status and date of payment T1002.",
    messages, tools, available_functions
)
# The model may:
# 1. Call retrieve_payment_status(T1002)
# 2. Receive the result
# 3. Call retrieve_payment_date(T1002)
# 4. Receive the result
# 5. Formulate the final response with both pieces of information

Ó thaobh na staire teachtaireachta de, dealraíonn an sreabhadh seicheamhach mar seo:

user → assistant(tool_call_1) → tool(result_1) → assistant(tool_call_2) → tool(result_2) → assistant(response)

Comhair na casanna cúntóra: trí cinn, rud a chiallaíonn trí iarratas a bhilleáil chuig an API. Sin costas an fhorghníomhaithe sheicheamhaigh, agus is é sin an fáth go bhfuil an chéad cheacht dírithe ar ghlaonna comhthreomhara.

Méid na Staire a Bhainistiú

Sa táirgeadh, éiríonn comhrá fadtréimhseach costach: seolann gach casadh an tacar iomlán de theachtaireachtaí roimhe seo ar ais, agus fásann an bille tocain go cearnach. Is straitéis shimplí í gan ach an teachtaireacht chórais agus na malartuithe is déanaí a choinneáil.

def trim_messages(messages: list, max_messages: int = 20) -> list:
    """Keeps the system message and the last N messages."""
    system_messages = [m for m in messages if hasattr(m, "role")
                       and m.get("role") == "system"
                       or (isinstance(m, dict) and m.get("role") == "system")]

    non_system = [m for m in messages if m not in system_messages]

    if len(non_system) > max_messages:
        non_system = non_system[-max_messages:]

    return system_messages + non_system

Réalamh amháin sula nascann tú an fheidhm seo: ná gearr tool_call riamh gan a theachtaireacht tool chomhfhreagrach. Má thiteann an gearradh eatarthu, faigheann an API iarratas glao gan fhreagra agus diúltaíonn sé don cheist. Coigeartaigh an pointe gearrtha chun péirí iomlána a chaomhnú seachas teachtaireachtaí a chomhaireamh go dall.

Príomhphointí

  • Coinnigh stair iomlán de theachtaireachtaí ionas go dtuigeann an tsamhail an comhthéacs
  • Úsáid lúb while chun glaonna feidhme seicheamhacha a láimhseáil
  • Tuigeann an tsamhail tagairtí intuigthe (“an ceann sin”, “an ceann roimhe”) a bhuíochas leis an gcomhthéacs
  • Sa táirgeadh, teorainn a chur le méid na staire agus péirí tool_call/tool á gcoinneáil slán
  • Is patrún in-athúsáidte é an fheidhm chat() a taispeántar anseo d’aon fheidhmchlár glaonna feidhme