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

API tar-Responses vs Chat Completions: Għaliex Timmigra

Lezzjoni 2 / 22 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. API tar-Responses vs Chat Completions
  2. Bidliet Fundamentali
  3. Ġestjoni tas-Sessjonijiet fuq in-Naħa tas-Server
  4. JSON Garantit, Mhux JSON ta’ Xewqa
  5. Sejħiet tal-Funzjonijiet u Streaming
  6. Gwida ta’ Migrazzjoni Rapida
  7. Għandek Timmigra Immedjatament?
  8. Punti Ewlenin

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 CompletionsAPI tar-Responses
client.chat.completions.create()client.responses.create()
messages=[...]input="..." jew input=[...]
response.choices[0].message.contentresponse.output_text
Storja manwaliprevious_response_id
response_formattext={"format": {...}}
tools + tool_choicetools (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