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

Pakāpeniska pāreja uz Responses API

Nodarbība 12 no 12 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Kāpēc un kad veikt migrāciju
  2. 1. solis: Identificē izmantotās funkcijas
  3. 2. solis: Migrē pamata izsaukumus
  4. 3. solis: Migrē daudzpakāpju sarunas
  5. 4. solis: Izmanto jaunās funkcijas
  6. Ieteicamā migrācijas stratēģija
  7. Galvenās atziņas
  8. Pārbaudi savas zināšanas

Atjaunināts 2026. gada 3. novembrī: Parametru kartēšana iepriekš norādīja, ka max_tokens saglabā savu nosaukumu Responses API; xAI tabula to maina uz max_output_tokens, un arī lietojuma skaitītāju nosaukumi mainās. Avots: Salīdzinājums ar Chat Completions.

Kāpēc un kad veikt migrāciju

Chat Completions galapunkts ir atzīts par novecojušu (legacy). Tas turpinās darboties, taču tam netiks pievienotas jaunas funkcijas. Ja tavai lietotnei ir nepieciešami servera puses rīki (meklēšana tīmeklī, koda izpilde), sarunu glabāšana vai šifrēta spriešana, pāreja uz Responses API kļūst obligāta.

Labā ziņa: šo migrāciju var veikt pakāpeniski. Tev nav viss jāpārraksta uzreiz.

1. solis: Identificē izmantotās funkcijas

Pirms migrācijas veic inventarizāciju, ko tieši tava lietotne izmanto, strādājot ar Chat Completions:

# Auditē savu esošo kodu
# Meklē šos rakstus:

# 1. Pamata izsaukumi (vienkāršs teksts)
client.chat.completions.create(model=..., messages=...)

# 2. Straumēšana
client.chat.completions.create(..., stream=True)

# 3. Funkciju izsaukšana
client.chat.completions.create(..., tools=[...])

# 4. Redze (attēli)
# ziņojumi ar saturu kā masīvu [text, image_url]

# 5. Ģenerēšanas parametri
# temperature, max_tokens, top_p, stop, seed

Pamata izsaukumus un straumēšanu migrēt ir visvienkāršāk. Funkciju izsaukšanai nepieciešams pielāgot formātu. Redze darbojas līdzīgi.

2. solis: Migrē pamata izsaukumus

Vienkārša izsaukuma migrēšana seko šim paraugam:

# PIRMS — Chat Completions
response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)
texte = response.choices[0].message.content

# PĒC — Responses API
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    instructions="You are a helpful assistant.",
    input="Hello!"
)
texte = response.output_text

Lauku kartēšana

Galvenās izmaiņas ir:

  • messages ar lomu system → instructions (speciāls parametrs)
  • messages ar lomu user → input (vienkārša virkne)
  • response.choices[0].message.content → response.output_text
  • max_tokens → max_output_tokens, saskaņā ar xAI kartēšanas tabulu; temperature saglabā savu nosaukumu
  • response.usage.prompt_tokens un completion_tokens → input_tokens un output_tokens (detalizēti: input_tokens_details.cached_tokens, output_tokens_details.reasoning_tokens)

3. solis: Migrē daudzpakāpju sarunas

Šeit Responses API lietas vienkāršo. Tā vietā, lai ar katru pieprasījumu no jauna veidotu vēsturi, tu tās saista pēc ID:

# PIRMS — Chat Completions (pats pārvaldi vēsturi)
historique = [
    {"role": "system", "content": "You are a helpful assistant."}
]

def envoyer_message(texte: str) -> str:
    historique.append({"role": "user", "content": texte})
    response = client.chat.completions.create(
        model="grok-4.20-0309-reasoning",
        messages=historique
    )
    reponse = response.choices[0].message.content
    historique.append({"role": "assistant", "content": reponse})
    return reponse

# PĒC — Responses API (serveris pārvalda vēsturi)
dernier_id = None

def envoyer_message(texte: str) -> str:
    response = client.responses.create(
        model="grok-4.20-0309-reasoning",
        instructions="You are a helpful assistant.",
        input=texte,
        previous_response_id=dernier_id
    )
    dernier_id = response.id
    return response.output_text

Kods ir vienkāršāks, un tev vairs nav manuāli jāpārvalda ziņojumu masīvs.

4. solis: Izmanto jaunās funkcijas

Kad migrācija pabeigta, vari izmantot funkcijas, kas pieejamas tikai Responses API:

Iebūvēta tīmekļa meklēšana

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest developments in generative AI?",
    tools=[{"type": "web_search"}]
)
# Atbilde ietver citātus ar avotu URL

Atbilžu glabāšana

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze this document...",
    store=True  # Glabā 30 dienas
)

# Iegūst vēlāk
stored = client.responses.retrieve(response.id)

Šifrēta spriešana

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Solve this complex problem...",
    include=["reasoning.encrypted_content"]
)
# Šifrēto spriešanu var atkārtoti izmantot turpmākajos pieprasījumos

Ieteicamā migrācijas stratēģija

Tā vietā, lai migrētu visu uzreiz, rīkojies pa soļiem:

  1. Identificē Chat Completions izsaukumus savā kodā
  2. Klasificē tos pēc sarežģītības (pamata → straumēšana → funkciju izsaukšana)
  3. Vispirms migrē jaunus galapunktus vai funkcijas (greenfield)
  4. Tad migrē vienkāršākos esošos izsaukumus
  5. Patur Chat Completions trešo pušu integrācijām, kurām tas ir nepieciešams (LangChain u.c.)

Pagaidu līdzāspastāvēšana

Pārejas periodā ir pilnīgi pieņemami darbināt abus galapunktus blakus:

# Aplauzums, kas abstrahē izmantoto galapunktu
class GrokClient:
    def __init__(self, use_responses: bool = False):
        self.use_responses = use_responses
        self.client = OpenAI(
            api_key=os.getenv("XAI_API_KEY"),
            base_url="https://api.x.ai/v1"
        )

    def generate(self, system: str, user_message: str) -> str:
        if self.use_responses:
            response = self.client.responses.create(
                model="grok-4.20-0309-reasoning",
                instructions=system,
                input=user_message
            )
            return response.output_text
        else:
            response = self.client.chat.completions.create(
                model="grok-4.20-0309-reasoning",
                messages=[
                    {"role": "system", "content": system},
                    {"role": "user", "content": user_message}
                ]
            )
            return response.choices[0].message.content

Šī pieeja ļauj pāriet pakāpeniski, katru migrāciju testējot atsevišķi.

Galvenās atziņas

  • Migrācija var būt pakāpeniska: nav jāpārraksta viss uzreiz
  • Galvenās izmaiņas: messages → input/instructions, choices[0].message.content → output_text
  • Daudzpakāpju sarunas pāriet no ziņojumu masīva uz vienkāršu previous_response_id
  • Responses API nodrošina piekļuvi ekskluzīvām funkcijām (web_search, glabāšana, šifrēta spriešana)
  • Pārejas laikā darbini abus galapunktus blakus un migrē pēc sarežģītības pakāpes

Pārbaudi savas zināšanas

Novecojušais API ir saprasts — un migrācija sagatavota.

1. Ko nozīmē Chat Completions novecojušais un bezstāvokļa statuss?

Atbilde: Galapunkts joprojām tiek atbalstīts, bet vairs neattīstās: būdams bezstāvokļa, tas prasa nosūtīt visu vēsturi ar katru izsaukumu — Responses API ir mūsdienu ceļš.

2. Kuras lomas strukturē ziņojumus?

Atbilde: system (un developer), user, assistant — ietvars, pieprasījumi, atbildes: visa vēsture sākas no jauna ar katru pieprasījumu.

3. Kā izmantot esošo OpenAI kodu ar Grok?

Atbilde: Mainot base_url uz https://api.x.ai/v1 un API atslēgu — formāta saderība paveic pārējo, ieskaitot OpenAI SDK un Vercel AI SDK.

4. Ko tu lasi atbildē un lietojumā?

Atbilde: choices nes atbildes ar finish_reason; usage detalizē tokenus, ieskaitot reasoning_tokens spriešanas modeļiem — tas ir izmaksu izsekošanas pamats.

5. Kā tīri migrēt uz Responses API?

Atbilde: Pakāpeniski: jauni izstrādājumi Responses vidē, esošie galapunkti pārvērsti pa vienam ar promptu atkārtotu testēšanu — abu formātu salīdzināšana virza konversiju.

Izproti novecojušo, veido moderno: kursa pakāpeniskais migrācijas plāns ir tavs ceļvedis — bez liela sprādziena.