Staid na comhráite agus bainistíocht seisiún
Ar an leathanach seo
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_idfreagraí go huathoibríoch gan an stair a athsheoladh - Tá
iduathú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