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

Staid na comhráite agus bainistíocht seisiún

Ceacht 11 as 22 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Staid na comhráite agus bainistíocht seisiún
  2. Slabhraú le previous_response_id
  3. Ilchomhráite a rith
  4. Cathain smacht a ghlacadh ar an stair
  5. Maireachtáil tar éis atosú
  6. Príomhphointí

Staid na comhráite agus bainistíocht seisiún

Tacaíonn an API Freagraí le staid na comhráite go dúchasach, rud a shimplíonn go mór an comhthéacs a choinneáil thar gach babhta. Ní gá duit an stair a athchruthú do gach iarratas a thuilleadh: déanann an freastalaí é sin duitse, agus ní gá duit ach aitheantóir a sheoladh.

Slabhraú le previous_response_id

Tagann an mheicníocht síos go réimse amháin. Tá id ag gach freagra; seol é in previous_response_id ar an nglaonna chugainn, agus beidh rochtain ag an tsamhail ar gach rud a tháinig roimhe. Sa mhalartú thíos, ní bhíonn ciall ar bith leis an tríú ceist—“Conas iad a chur leis?”—ina haonar: ligeann an slabhraú don tsamhail a fháil amach go bhfuilimid ag caint faoi chodáin agus gur túsaithe é an t-úsáideoir.

from openai import OpenAI
client = OpenAI()

# An chéad mhalartú
r1 = client.responses.create(
    model="gpt-5.6-terra",
    instructions="You are a patient math teacher.",
    input="I'd like to learn about fractions."
)
print(f"R1: {r1.output_text}")

# An dara malartú — caomhnaítear an comhthéacs go huathoibríoch
r2 = client.responses.create(
    model="gpt-5.6-terra",
    input="Can you give me a concrete example?",
    previous_response_id=r1.id
)
print(f"R2: {r2.output_text}")

# An tríú malartú — tá an comhrá iomlán inrochtana
r3 = client.responses.create(
    model="gpt-5.6-terra",
    input="And how do I add them?",
    previous_response_id=r2.id
)
print(f"R3: {r3.output_text}")
# Tá a fhios ag an tsamhail go raibhimid ag caint faoi chodáin ón tús

Breathnaigh ar an difríocht i gcomparáid leis an gcur chuige roimhe seo. Le Chat Completions, bhíodh an comhrá i liosta a choimeád tú féin agus a sheoladh ar ais ina iomláine ar gach babhta, agus na costais ag méadú de réir mar a bhíodh an malartú ag fadú.

# SEAN — bhí ort gach rud a bhainistiú leat féin
history = [
    {"role": "system", "content": "You are a math teacher."},
    {"role": "user", "content": "I'd like to learn about fractions."},
    {"role": "assistant", "content": "Sure! Fractions..."},
    {"role": "user", "content": "A concrete example?"},
    {"role": "assistant", "content": "Let's take a pizza..."},
    {"role": "user", "content": "How do I add them?"},
]
# Seolta ina iomláine ar gach glaonna = costais ag ardú

Laghdaítear an malartú céanna anois go tagairt amháin:

# NUA — tá aitheantóir amháin go leor
r = client.responses.create(
    model="gpt-5.6-terra",
    input="How do I add them?",
    previous_response_id="previous_response_id"
)
# Bainistíonn an freastalaí an stair duitse

Ilchomhráite a rith

Chomh luath agus a fhreastalaíonn d’iarratas ar il-úsáideoirí, is é an cheist ná: cé a bhaineann leis an aitheantóir sin? Is é an freagra ná tábla mapála idir an t-úsáideoir agus an response.id is déanaí dá chomhrá. Cuimsíonn an bainisteoir thíos an loighic seo: ní chuireann sé previous_response_id leis ach amháin má tá seisiún ann cheana, agus ansin stórálann sé an t-aitheantóir nua. Mar sin, is féidir le hAlice agus le Bob comhrá a dhéanamh go comhthreomhar gan a gcomhthéacsanna a mheascadh, agus ciallaíonn “seisiún nua” díreach an t-aitheantóir reatha a dhéanamh dearmad.

class SessionManager:
    """Bainisteoir seisiún comhráite."""

    def __init__(self):
        self.sessions: dict[str, str] = {}  # user_id -> last_response_id

    def send_message(self, user_id: str, message: str,
                     instructions: str = "") -> str:
        """Seolann teachtaireacht i seisiún an úsáideora."""
        kwargs = {
            "model": "gpt-5.6-terra",
            "input": message,
        }

        # Cuir treoracha leis má tá siad ann
        if instructions:
            kwargs["instructions"] = instructions

        # Slabhraigh leis an bhfreagra roimhe má tá sé ann
        if user_id in self.sessions:
            kwargs["previous_response_id"] = self.sessions[user_id]

        response = client.responses.create(**kwargs)

        # Sábháil an t-ID don chéad bhabhta eile
        self.sessions[user_id] = response.id

        return response.output_text

    def new_session(self, user_id: str):
        """Tosaíonn comhrá nua don úsáideoir."""
        if user_id in self.sessions:
            del self.sessions[user_id]

# Úsáid
manager = SessionManager()

# Úsáideoir Alice
print(manager.send_message("alice", "Hello, tell me about Python."))
print(manager.send_message("alice", "What are its advantages?"))

# Úsáideoir Bob (comhrá neamhspleách)
print(manager.send_message("bob", "Hello, tell me about Rust."))

# Leanann Alice lena comhrá faoi Python
print(manager.send_message("alice", "How do I get started?"))

Cathain smacht a ghlacadh ar an stair

Tá teorainn leis an slabhraú uathoibríoch: ní féidir leat athrú a dhéanamh ar an rud a rádh cheana. Má theastaíonn ó d’iarratas achoimre a dhéanamh ar bhabhtaí caite, teachtaireacht a bhfuil sonraí pearsanta inti a scriosadh, nó comhthéacs athfhoirmithe a ath-instealladh, athraigh go hionchur struchtúrtha agus bainistigh an liosta leat féin. Caillfidh tú an tsimplíocht, ach gheobhaidh tú smacht iomlán—agus an cumas boilsciú tocain a rianú babhta i ndiaidh babhta.

def manual_conversation():
    """Comhrá le bainistíocht láimhe ar an stair."""
    history = []

    while True:
        user_input = input("You: ")
        if user_input.lower() == "quit":
            break

        history.append({"role": "user", "content": user_input})

        response = client.responses.create(
            model="gpt-5.6-terra",
            instructions="You are a concise assistant.",
            input=history
        )

        assistant_msg = response.output_text
        history.append({"role": "assistant", "content": assistant_msg})

        print(f"Assistant: {assistant_msg}")
        print(f"  (Tokain charntha: {response.usage.input_tokens})")

# manual_conversation()

Maireachtáil tar éis atosú

Imíonn foclóir sa chuimhne ar an gcéad ath-imscaradh, ag tógáil gach comhrá gníomhach leis. Sa táirgeadh, déan na haitheantóirí a bhuanú—léiríonn an comhad JSON thíos an prionsabal, ar féidir leat é a oiriúnú do do bhunachar sonraí nó do Redis. Tabhair faoi deara go dtaifeadaimid an stampa ama agus úsáid na dtocain freisin, dhá thosa eolais a úsáidtear don éag agus do rianú costais, faoi seach.

import json
from datetime import datetime

class PersistentSessionManager:
    """Seisiúin bhuanaithe le cúltaca."""

    def __init__(self, db_path: str = "sessions.json"):
        self.db_path = db_path
        self.sessions = self._load()

    def _load(self) -> dict:
        try:
            with open(self.db_path, "r") as f:
                return json.load(f)
        except FileNotFoundError:
            return {}

    def _save(self):
        with open(self.db_path, "w") as f:
            json.dump(self.sessions, f, indent=2)

    def send(self, session_id: str, message: str) -> str:
        kwargs = {"model": "gpt-5.6-terra", "input": message}

        if session_id in self.sessions:
            kwargs["previous_response_id"] = self.sessions[session_id]["last_id"]

        response = client.responses.create(**kwargs)

        self.sessions[session_id] = {
            "last_id": response.id,
            "updated_at": datetime.now().isoformat(),
            "total_tokens": response.usage.total_tokens
        }
        self._save()

        return response.output_text

Ar deireadh, cuir éag i bhfeidhm. Gan glantachán, ní dhéanfaidh do thábla seisiún ach fás, agus thosódh úsáideoir a thagann ar ais trí seachtaine ina dhiaidh sin comhrá nach cuimhin leo a thuilleadh. Is pointe tosaigh réasúnach é fiche a ceathair uair an chloig, inchoigeartaithe bunaithe ar do chás úsáide.

from datetime import datetime, timedelta

def clean_sessions(sessions: dict, max_age_hours: int = 24) -> dict:
    """Baineann seisiúin éagtha amach."""
    now = datetime.now()
    active = {}

    for sid, data in sessions.items():
        updated = datetime.fromisoformat(data["updated_at"])
        if now - updated < timedelta(hours=max_age_hours):
            active[sid] = data

    deleted = len(sessions) - len(active)
    if deleted > 0:
        print(f"{deleted} seisiún éagtha bainte")

    return active

Chun na roghanna seo a achoimriú: úsáid previous_response_id do chomhráite simplí—is é an bealach is éifeachtaí é; athraigh go hionchur struchtúrtha nuair is gá duit an stair a mhodhnú; stóráil response.id go hiontaofa, i mbunachar sonraí seachas sa chuimhne; déan seisiúin neamhghníomhacha a ghlanadh; agus déan monatóireacht ar thocain charntha, nó beidh ort íoc as.

Príomhphointí

  • Slabhraíonn previous_response_id freagraí go huathoibríoch gan an stair a athsheoladh
  • Tá id uathúil ag gach freagra atá inúsáidte le haghaidh slabhraíochta
  • Bainistigh ilseisiúin le foclóir user_id -> response_id
  • Tairgeann ionchur struchtúrtha (liosta teachtaireachtaí) níos mó smachta ar an stair
  • Cuir buanú seisiún agus éag i bhfeidhm sa táirgeadh