Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Otisak sustava i reproduktivnost

Lekcija 10 od 12 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. The system_fingerprint: praćenje konfiguracije
  2. Čemu služi system_fingerprint?
  3. Verzije modela i otisci
  4. Reproduktivnost odgovora
  5. Bilježenje otisaka u proizvodnji
  6. Životni ciklus modela
  7. Ključne točke

The system_fingerprint: praćenje konfiguracije

Svaki odgovor API-ja Chat Completions uključuje polje system_fingerprint – niz znakova koji identificira konfiguraciju sustava korištenu za generiranje odgovora. Programeri često zanemaruju ovo polje, no ono je dragocjeno za otklanjanje pogrešaka i reproduktivnost.

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

Čemu služi system_fingerprint?

Otisak identificira kombinaciju verzije modela, sistemskih parametara i infrastrukture korištene za obradu tvog zahtjeva. Dva identična zahtjeva obrađena s istim otiskom proizvest će rezultate koji su međusobno sličniji nego dva zahtjeva s različitim otiscima.

Praktični slučajevi uporabe

  • Otklanjanje pogrešaka: kada se odgovor neočekivano promijeni, provjeri je li se otisak promijenio. Promjena otiska ukazuje na ažuriranje na strani poslužitelja.
  • Reproduktivnost: ako trebaš reproducirati rezultat, zabilježi otisak. Isti upit + isti otisak = veće šanse za dobivanje istog odgovora.
  • Revizija: u reguliranim okruženjima, otisak ti omogućuje dokumentiranje točne verzije sustava koja je proizvela određeni odgovor.

Verzije modela i otisci

Otisak je usko povezan s verzijom modela. xAI nudi tri konvencije imenovanja za modele:

Jednostavni alias

model = "grok-4.20"

Uputuje na najnoviju stabilnu verziju. Otisak se može promijeniti kada xAI ažurira ovu stabilnu verziju – čak i ako ime modela ostane isto.

Alias „najnovije“

model = "grok-4.20-latest"

Uputuje na verziju na samom rubu razvoja. Otisak će se često mijenjati jer se ova verzija neprestano evoluira.

Fiksna verzija

model = "grok-4.20-0309"

Uputuje na specifičnu verziju koja se nikada neće promijeniti. Otisak će biti najstabilniji s ovom vrstom reference.

Reproduktivnost odgovora

Čak i s istim upitom, modelom i otiskom, odgovori nisu uvijek identični. Generiranje teksta uključuje element slučajnosti kojim upravlja parametar temperature.

Za maksimiziranje reproduktivnosti:

response = client.chat.completions.create(
    model="grok-4.20-0309",  # Fiksna verzija
    messages=[
        {"role": "user", "content": "Calculate 2 + 2"}
    ],
    temperature=0,  # Deterministički
    seed=42          # Sjeme za generator slučajnih brojeva
)

# Spremi otisak za referencu
print(f"Fingerprint: {response.system_fingerprint}")

Kombinacija za maksimalnu reproduktivnost

  • Fiksna verzija modela (grok-4.20-0309): osigurava da se model ne mijenja
  • Temperature postavljen na 0: uklanja slučajno uzorkovanje
  • Fiksno sjeme: inicijalizira generator slučajnih brojeva na istoj točki
  • Isti otisak: potvrđuje da se infrastruktura nije promijenila

Čak ni uz sve ovo, reproduktivnost nije 100 % zajamčena zbog numeričkih optimizacija (nedeterminističke operacije s pomičnim zarezom). No, u praksi će rezultati biti vrlo slični.

Bilježenje otisaka u proizvodnji

Najbolja praksa je spremanje otiska uz svaki zahtjev kako bi se olakšalo kasnije otklanjanje pogrešaka:

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

    # Bilježenje za otklanjanje pogrešaka
    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

Životni ciklus modela

xAI modeli prolaze kroz životni ciklus od tri faze:

  • Aktivan: dostupan i preporučen za uporabu u proizvodnji
  • Zastario: još uvijek radi, ali će biti uklonjen. Upozorenje se može pojaviti u odgovorima. Migriraj što je prije moguće.
  • Neupotrebljiv: uklonjen. Zahtjevi će rezultirati pogreškom.

Kada model prijeđe iz aktivnog u zastarjeli status, otisak se često mijenja jer xAI može preusmjeriti zahtjeve na noviju verziju.

Ključne točke

  • system_fingerprint identificira konfiguraciju sustava korištenu za generiranje odgovora
  • Promjena otiska ukazuje na promjenu na strani poslužitelja (ažuriranje modela ili infrastrukture)
  • Koristi fiksne verzije (grok-4.20-0309) za maksimalnu stabilnost u proizvodnji
  • Kombiniraj fiksnu verziju + temperature 0 + fiksno sjeme za najbolju reproduktivnost
  • Bilježi otisak uz svaki zahtjev kako bi olakšao otklanjanje pogrešaka