Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Responses API pret Chat Completions: kāpēc pāriet

Nodarbība 2 no 22 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Responses API pret Chat Completions
  2. Būtiskas izmaiņas
  3. Sesiju pārvaldība servera pusē
  4. Garantēts JSON, nevis cerību JSON
  5. Funkciju izsaukumi un straumēšana
  6. Ātra migrācijas rokasgrāmata
  7. Vai pāriet nekavējoties?
  8. Galvenās atziņas

Responses API pret Chat Completions

Chat Completions API gadiem ilgi bija standarts, un lielākā daļa tiešsaistē atrodamā koda joprojām to izmanto. Tomēr kopš 2025. gada OpenAI to ir atzīmējusi kā novecojušu (legacy) un visiem jaunajiem projektiem iesaka lietot Responses API. Šajā nodarbībā salīdzinām abus interfeisus, koncentrējoties uz atšķirībām, kas faktiski ietekmē tavu kodu.

Būtiskas izmaiņas

Izmantojot Chat Completions, tu veidoji ziņojumu sarakstu un ar katru izsaukumu nosūtīji visu sarakstu. Sarunas stāvoklis glabājās tavā lietotnē, nevis serverī:

from openai import OpenAI
client = OpenAI()

# Vecais modelis — Chat Completions (novecojis)
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)
# Rezultāts: "The capital of France is Paris."

Responses API samazina šo pašu izsaukumu līdz diviem parametriem un nodrošina tiešu piekļuvi ģenerētajam tekstam. Sistēmas ziņojums kļūst par parametru instructions, un satura iegūšanai vairs nav jāiet cauri choices[0].message.content:

from openai import OpenAI
client = OpenAI()

# Jaunais modelis — Responses API
response = client.responses.create(
    model="gpt-5.6-terra",
    input="What is the capital of France?"
)
print(response.output_text)
# Rezultāts: "The capital of France is Paris."

Sesiju pārvaldība servera pusē

Tas sniedz vislielāko tūlītējo labumu. API uztur sarunas stāvokli, tāpēc tev ir jānorāda tikai iepriekšējā atbilde, izmantojot tās ID. Iedomājies atbalsta asistentu: desmitajā solī Chat Completions pieeja tevi spieda atkārtoti nosūtīt iepriekšējos deviņus apmaiņas brīžus, nozīmējot, ka tu par šiem tokeniem maksāji vēlreiz. Šeit pietiek ar vienu lauku:

# Pirmais jautājums
response = client.responses.create(
    model="gpt-5.6-terra",
    input="My name is Marie."
)

# Otrais jautājums — konteksts tiek saglabāts automātiski
followup = client.responses.create(
    model="gpt-5.6-terra",
    input="What is my name?",
    previous_response_id=response.id
)
print(followup.output_text)
# Rezultāts: "Your name is Marie."

Garantēts JSON, nevis cerību JSON

Otrais lielais uzlabojums attiecas uz strukturētu izvadi. Tu apraksti sagaidāmo formātu, un Responses API garantē, ka atbilde atbildīs tavai JSON shēmai — ļaujot veikt deserializāciju bez drošības tīkliem. Reģistrācijas veidlapa, kas iegūst informāciju no brīvā teksta, vairs neizjūk tikai tāpēc, ka modelis nolemj pirms sava JSON pievienot ievada teikumu:

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)
# Rezultāts: {"name": "Paris", "country": "France", "population": 2161000}

Funkciju izsaukumi un straumēšana

Rīku deklarēšana seko tai pašai vienkāršošanas loģikai: funkcijas deskriptors tiek deklarēts plakani sadaļā tools, un modeļa pieprasītais izsaukums parādās tieši response.output bez papildu ligzdošanas līmeņiem.

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"]
        }
    }]
)

# API atgriež izpildāmo funkcijas izsaukumu tieši
for item in response.output:
    if item.type == "function_call":
        print(f"Function: {item.name}, Arguments: {item.arguments}")
# Rezultāts: Function: get_meteo, Arguments: {"city": "Lyon"}

Straumēšana vairs neatgriež nediferencētu gabalu plūsmu, bet gan tipētus notikumus. Tu filtrē pēc event.type un precīzi zini, ar ko strādā — teksta fragmentu, funkcijas argumentu vai ģenerēšanas beigām:

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)

Ātra migrācijas rokasgrāmata

Chat CompletionsResponses API
client.chat.completions.create()client.responses.create()
messages=[...]input="..." vai input=[...]
response.choices[0].message.contentresponse.output_text
Manuāla vēstureprevious_response_id
response_formattext={"format": {...}}
tools + tool_choicetools (vienkāršots)

Vai pāriet nekavējoties?

Chat Completions API joprojām darbojas un netiks dzēsts. Esošais kods, kas strādā, neprasa izmaiņas un balstās uz testēšanas cauruļvadu, kas izveidots ap veco formātu, no steidzamas pārrakstīšanas negūs nekādu labumu. Tāpat, ja esi atkarīgs no trešās puses bibliotēkas, kas vēl neatbalsta Responses API, pagaidi tās atjauninājumu. Tomēr jebkuram jaunam projektam atbilde ir skaidra: Responses API ir sākumpunkts, un pārējā šī kursa daļa balstās uz šo pieņēmumu.

Galvenās atziņas

  • Responses API aizstāj Chat Completions ar vienkāršāku interfeisu
  • Sesiju pārvaldība servera pusē novērš nepieciešamību atkārtoti sūtīt vēsturi
  • Strukturētā izvade un funkciju izsaukumi ir integrēti dabiski
  • Migrācija ir vienkārša: koncepcijas paliek tās pašas, mainās tikai sintakse