API tar-Responses vs Chat Completions: Għaliex Timmigra
F'din il-paġna
API tar-Responses vs Chat Completions
L-API ta’ Chat Completions serviet bħala l-istandard għal snin sħaħ, u ħafna mill-kodiċi li ssib online għadu jużaha. Madankollu, mill-2025 ‘l hawn, OpenAI ħabbret li hija antika (legacy) u tirrakkomanda l-API tar-Responses għall-proġetti ġodda kollha. Din il-lezzjoni tqabbel iż-żewġ interfaċċi, billi tiffoka fuq id-differenzi li effettivament jaffettwaw il-kodiċi tiegħek.
Bidliet Fundamentali
Ma’ Chat Completions, kont tibni lista ta’ messaġġi u tibgħat il-lista sħiħa ma’ kull sejħa. L-istat tal-konversazzjoni kien jgħix fl-applikazzjoni tiegħek, qatt fuq is-server:
from openai import OpenAI
client = OpenAI()
# Mudell antik — Chat Completions (legacy)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "What is the capital of France?"},
]
)
print(response.choices[0].message.content)
# Result: "The capital of France is Paris."
L-API tar-Responses tnaqqas din l-istess sejħa għal żewġ parametri biss u tipprovdi aċċess dirett għat-test iġġenerat. Il-messaġġ tas-sistema jsir il-parametru instructions, u l-estrazzjoni tal-kontenut ma teħtieġx aktar li tnaviga choices[0].message.content:
from openai import OpenAI
client = OpenAI()
# Mudell ġdid — API tar-Responses
response = client.responses.create(
model="gpt-5.6-terra",
input="What is the capital of France?"
)
print(response.output_text)
# Result: "The capital of France is Paris."
Ġestjoni tas-Sessjonijiet fuq in-Naħa tas-Server
Dan joffri l-aktar benefiċċju immedjat. L-API żżomm l-istat tal-konversazzjoni, allura trid biss tirreferenzja r-risposta preċedenti bl-ID tagħha. Imaġina assistent tas-sostenn: sal-għaxar dawra, l-approċċ ta’ Chat Completions kien jfurzak terġa’ tibgħat id-disa’ skambji preċedenti, jiġifieri kont tħallas għal dawk it-tokens mill-ġdid. Hawnhekk, kamp wieħed huwa biżżejjed:
# L-ewwel mistoqsija
response = client.responses.create(
model="gpt-5.6-terra",
input="My name is Marie."
)
# It-tieni mistoqsija — il-kuntest jinżamm awtomatikament
followup = client.responses.create(
model="gpt-5.6-terra",
input="What is my name?",
previous_response_id=response.id
)
print(followup.output_text)
# Result: "Your name is Marie."
JSON Garantit, Mhux JSON ta’ Xewqa
It-tieni titjib kbir jikkonċerna l-output strutturat. Int tiddeskrivi l-format mistenni, u l-API tar-Responses tiggarantixxi li r-risposta taderixxi mal-iskema JSON tiegħek—li jippermettilek tagħmel deserializzazzjoni mingħajr netwerks ta’ sikurezza. Formola ta’ reġistrazzjoni li testratti informazzjoni minn test liberu ma titkissirx sempliċiment għax il-mudell jiddeċiedi li jżid sentenza introduttorja qabel il-JSON tiegħu:
from pydantic import BaseModel
class City(BaseModel):
name: str
country: str
population: int
response = client.responses.create(
model="gpt-5.6-terra",
input="Give me information about Paris.",
text={"format": {"type": "json_schema", "json_schema": {
"name": "city",
"strict": True,
"schema": City.model_json_schema()
}}}
)
print(response.output_text)
# Result: {"name": "Paris", "country": "France", "population": 2161000}
Sejħiet tal-Funzjonijiet u Streaming
Id-dikjarazzjoni tal-għodda ssegwi l-istess loġika ta’ simplifikazzjoni: id-deskrittur tal-funzjoni jiġi ddikjarat b’mod ċatt f’tools, u s-sejħa mitluba mill-mudell tidher direttament f’response.output, mingħajr livelli extra ta’ nesting.
response = client.responses.create(
model="gpt-5.6-terra",
input="What is the weather like in Lyon?",
tools=[{
"type": "function",
"name": "get_meteo",
"description": "Get the weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "Name of the city"}
},
"required": ["city"]
}
}]
)
# L-API tirritorna s-sejħa tal-funzjoni biex tiġi eżegwita direttament
for item in response.output:
if item.type == "function_call":
print(f"Function: {item.name}, Arguments: {item.arguments}")
# Result: Function: get_meteo, Arguments: {"city": "Lyon"}
L-istreaming ma jirritornax aktar fluss ta’ biċċiet mhux differenzjati iżda avvenimenti ttajpjati. Int tiffiltra fuq event.type u tkun taf eżattament x’inhu qed timmanipula—framment ta’ test, argument ta’ funzjoni, jew it-tmiem tal-ġenerazzjoni:
stream = client.responses.create(
model="gpt-5.6-terra",
input="Tell a short story.",
stream=True
)
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
Gwida ta’ Migrazzjoni Rapida
| Chat Completions | API tar-Responses |
|---|---|
client.chat.completions.create() | client.responses.create() |
messages=[...] | input="..." jew input=[...] |
response.choices[0].message.content | response.output_text |
| Storja manwali | previous_response_id |
response_format | text={"format": {...}} |
tools + tool_choice | tools (issimplifikat) |
Għandek Timmigra Immedjatament?
L-API ta’ Chat Completions tibqa’ funzjonali u mhix se titneħħa. Kodiċi eżistenti li jaħdem, ma jeħtieġ l-ebda bidla, u jiddependi fuq pipeline tat-test mibni madwar il-format antik ma jikseb xejn minn riscrittura urġenti. Bl-istess mod, jekk tiddependi fuq librerija ta’ parti terza li għadha ma tappoġġjax l-API tar-Responses, stenna l-aġġornament tagħha. Madankollu, għal kwalunkwe proġett ġdid, it-tweġiba hija ċara: l-API tar-Responses hija l-punt tat-tluq, u l-bqija ta’ dan il-kors jipproċedi minn dik l-assunzjoni.
Punti Ewlenin
- L-API tar-Responses tissostitwixxi Chat Completions b’interfaċċa aktar sempliċi
- Il-ġestjoni tas-sessjonijiet fuq in-naħa tas-server telimina l-ħtieġa li terġa’ tibgħat l-istorja
- L-Output Strutturat u s-sejħiet tal-funzjonijiet huma integrati nativament
- Il-migrazzjoni hija sempliċi: il-kunċetti jibqgħu l-istess, tinbidel biss is-sintassi