Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Süsteemi sõrmejälg ja reprodutseeritavus

Õppetund 10 / 12 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. system_fingerprint: konfiguratsiooni jälgimine
  2. Milleks system_fingerprint mõeldud on?
  3. Mudeli versioonid ja sõrmejäljed
  4. Vastuse reprodutseeritavus
  5. Sõrmejälgede logimine tootmiskeskkonnas
  6. Mudeli elutsükkel
  7. Peamised punktid

system_fingerprint: konfiguratsiooni jälgimine

Iga vestluse lõpetamise API (Chat Completions API) vastus sisaldab välja system_fingerprint – see on string, mis tuvastab vastuse genereerimiseks kasutatud süsteemi konfiguratsiooni. Arendajad jätavad selle välja sageli tähelepanuta, kuid see on hindamatu silumise ja reprodutseeritavuse jaoks.

{
  "id": "chatcmpl-abc123",
  "system_fingerprint": "fp_44709d6fcb",
  "choices": [...],
  "usage": {...}
}

Milleks system_fingerprint mõeldud on?

Sõrmejälg tuvastab mudeli versiooni, süsteemi parameetrite ja taristu kombinatsiooni, mida sinu päringu töötlemiseks kasutati. Kaks identset päringut, mida töödeldakse sama sõrmejäljega, annavad tulemused, mis on omavahel sarnasemad kui kahe erineva sõrmejäljega päringu tulemused.

Praktilised kasutusjuhtumid

  • Silumine: kui vastus muutub ootamatult, kontrolli, kas sõrmejälg on muutunud. Sõrmejälje muutus viitab serveripoolsele uuendusele.
  • Reprodutseeritavus: kui sul on vaja tulemust korrata, pane sõrmejälg kirja. Sama viip + sama sõrmejälg = suurem tõenäosus saada sama vastus.
  • Audit: reguleeritud keskkondades võimaldab sõrmejälg dokumenteerida täpselt, milline süsteemi versioon konkreetse vastuse lõi.

Mudeli versioonid ja sõrmejäljed

Sõrmejälg on tihedalt seotud mudeli versiooniga. xAI pakub mudelite jaoks kolme nimetamiskonventsiooni:

Lihtne alias

model = "grok-4.20"

Viitab viimasele stabiilsele versioonile. Sõrmejälg võib muutuda, kui xAI seda stabiilset versiooni uuendab – isegi kui mudeli nimi jääb samaks.

Viimane alias

model = "grok-4.20-latest"

Viitab kõige uuemale, arendusjärgus versioonile. Sõrmejälg muutub sageli, kuna see versioon areneb pidevalt.

Fikseeritud versioon

model = "grok-4.20-0309"

Viitab konkreetsele versioonile, mis ei muutu kunagi. Sõrmejälg on selle viite tüübi puhul kõige stabiilsem.

Vastuse reprodutseeritavus

Isegi sama viiba, mudeli ja sõrmejälje korral ei ole vastused alati identsed. Teksti genereerimine hõlmab juhuslikkuse elementi, mida juhib parameeter temperature.

Reprodutseeritavuse maksimeerimiseks:

response = client.chat.completions.create(
    model="grok-4.20-0309",  # Fikseeritud versioon
    messages=[
        {"role": "user", "content": "Calculate 2 + 2"}
    ],
    temperature=0,  # Deterministlik
    seed=42          # Juhusliku generaatori seeme
)

# Salvesta sõrmejälg viiteks
print(f"Fingerprint: {response.system_fingerprint}")

Maksimaalse reprodutseeritavuse kombinatsioon

  • Fikseeritud mudeli versioon (grok-4.20-0309): tagab, et mudel ei muutu
  • Temperatuur seatud väärtusele 0: eemaldab juhusliku valimi
  • Fikseeritud seeme: initsialiseerib juhusliku generaatori samast punktist
  • Sama sõrmejälg: kinnitab, et taristu ei ole muutunud

Isegi kõige selle juures ei ole reprodutseeritavus 100% garanteeritud numbriliste optimeerimiste (mittedeterministlike ujukomaarvude tehtete) tõttu. Praktikas on tulemused siiski väga sarnased.

Sõrmejälgede logimine tootmiskeskkonnas

Hea tava on salvestada sõrmejälg iga päringuga, et hilisemat silumist lihtsustada:

def call_grok(messages: list, model: str = "grok-4.20-0309"):
    response = client.chat.completions.create(
        model=model,
        messages=messages
    )

    # Logi silumiseks
    log = {
        "response_id": response.id,
        "model": response.model,
        "fingerprint": response.system_fingerprint,
        "finish_reason": response.choices[0].finish_reason,
        "tokens": response.usage.total_tokens
    }
    logger.info("API call", extra=log)

    return response.choices[0].message.content

Mudeli elutsükkel

xAI mudelid läbivad kolme etappi elutsükli:

  • Aktiivne: saadaval ja soovitatud kasutamiseks tootmiskeskkonnas
  • Aegunud: töötab endiselt, kuid eemaldatakse peagi. Vastustes võib ilmuda hoiatus. Migreeru nii kiiresti kui võimalik.
  • Iganenud: eemaldatud. Päringud ebaõnnestuvad veatega.

Kui mudel liigub olekust Aktiivne olekusse Aegunud, muutub sõrmejälg sageli, kuna xAI võib päringud suunata uuemale versioonile.

Peamised punktid

  • system_fingerprint tuvastab vastuse genereerimiseks kasutatud süsteemi konfiguratsiooni
  • Sõrmejälje muutus viitab serveripoolsele muutusele (mudeli või taristu uuendus)
  • Kasuta tootmiskeskkonnas maksimaalse stabiilsuse saavutamiseks fikseeritud versioone (grok-4.20-0309)
  • Kombineeri fikseeritud versioon + temperatuur 0 + fikseeritud seeme parima reprodutseeritavuse jaoks
  • Logi sõrmejälg iga päringuga, et silumist lihtsustada