Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Alias, Latest und festgelegte Versionen

Lektion 13 von 14 Aktualisiert am 29. Juli 2026 Fortgeschritten
Auf dieser Seite
  1. Drei Möglichkeiten zur Modellreferenzierung
  2. Einfacher Alias
  3. Latest-Alias
  4. Festgelegte Version
  5. Eine Konvention pro Umgebung
  6. Wechsel von einer festgelegten Version zur nächsten
  7. Wichtige Erkenntnisse

Drei Möglichkeiten zur Modellreferenzierung

Das model-Feld Ihrer Anfrage akzeptiert drei Namenskonventionen, um – auf den ersten Blick identische – Modelle zu bezeichnen. Dies ist nicht nur eine Dokumentationsschönheit: Je nach gewählter Konvention erhält Ihre Anwendung bei jedem Aufruf entweder exakt das gleiche Modell über Monate hinweg oder eine Version, die sich ohne Ankündigung ändern kann. Die meisten unerklärten Produktionsregressionen – „unsere Antworten wurden länger, aber niemand hat etwas geändert” – gehen auf dieses Problem zurück.

Einfacher Alias

Der einfache Alias verwendet den Basenamen des Modells ohne Suffix:

{
  "model": "grok-4.20"
}

Dies verweist auf die neueste stabile Version des Modells. xAI kann die zugrundeliegende Version jederzeit aktualisieren, und Sie werden dies nur durch das Überwachen Ihrer eigenen Ausgaben erfahren. Diese Flexibilität ist genau das, was Sie während der Entwicklung und des Prototypenbaus benötigen: Sie arbeiten stets mit der besten verfügbaren Version, ohne Änderungen vornehmen zu müssen. Solange Sie an Prompts iterieren, Modellfähigkeiten erkunden und die exakte Reproduzierbarkeit der Antworten keine Rolle spielt, funktioniert diese Konvention.

Latest-Alias

Der latest-Alias verweist auf die fortschrittlichste Version, die noch nicht stabilisiert wurde:

{
  "model": "grok-4.20-latest"
}

Das, was Sie hier erhalten, kann sich häufig ändern und enthält Änderungen, die noch in der Validierung sind. Es dient als Evaluationswerkzeug, um bevorstehende Versionen vor ihrer Einführung als Standard-Alias zu testen, Qualitäts- oder Leistungsgewinne zu messen und Ihre Migration informiert vorzubereiten.

Er gehört in Testumgebungen, niemals in die Produktion. Eine Änderung kann über Nacht eintreten, das Verhalten Ihrer Prompts verändern und Ihre Nutzer ohne Warnung erreichen – Sie werden keine Commit-Zeile oder einen Ticket-Eintrag haben, um zu verstehen, was passiert ist.

Festgelegte Version

Eine festgelegte Version enthält ein Datum im Identifier:

{
  "model": "grok-4.20-0309"
}

Das Suffix -0309 entspricht dem Veröffentlichungsdatum, hier dem 9. März. Diese Version bleibt unverändert: Solange sie aktiv ist, wird das Modell, das heute antwortet, auch in sechs Monaten antworten. Dies ist die einzige vertretbare Option für die Produktion aus vier soliden Gründen. Das Verhalten Ihrer Anwendung wird reproduzierbar, wodurch Ihre Integrationstests und Regressionstests langfristig gültig bleiben. Stille Updates können Sie nicht mehr überraschen. Der Zeitpunkt der Migration wird zu einer geplanten Entscheidung des Teams und nicht zu etwas, das Ihnen widerfährt. Und wenn sich das Verhalten dennoch ändert, wissen Sie, dass die Ursache auf Ihrer Seite liegt.

Eine Konvention pro Umgebung

Die beste Praxis besteht nicht darin, zwischen den drei Optionen zu wählen, sondern jeder Umgebung eine zuzuordnen:

import os

ENVIRONMENT = os.getenv("APP_ENV", "development")

MODEL = {
    "development": "grok-4.20",         # Einfacher Alias: neueste stabile Version
    "staging": "grok-4.20-latest",      # Latest: Testen neuer Funktionen
    "production": "grok-4.20-0309",     # Festgelegte Version: maximale Stabilität
}[ENVIRONMENT]

Betrachten Sie dieses Wörterbuch als Frühwarnsystem. Ihre Staging-Umgebung läuft dauerhaft auf latest: Wenn eine bevorstehende Änderung einen Prompt bricht, fangen Ihre Integrationstests dies auf, bevor Ihre Nutzer es tun. Ihre Produktion bleibt dazwischen auf einer festgelegten Version. Sie entdecken Änderungen im upstream, ohne sie im downstream zu erleiden.

Wechsel von einer festgelegten Version zur nächsten

Wenn eine neue festgelegte Version erscheint – sagen wir grok-4.20-0612 – erfordert der Wechsel ein Verfahren statt einer einfachen Zeichenkettenänderung. Veröffentlichen Sie zunächst die neue Version in der Staging-Umgebung über den latest-Alias, führen Sie dort Ihre Prompt-Testsuite aus und vergleichen Sie die Ergebnisse mit denen der Version, die derzeit in der Produktion läuft. Wenn der Vergleich zufriedenstellend ist, aktualisieren Sie die Produktionskonfiguration, überwachen Sie die Metriken für 48 Stunden – Antwortqualität, Zufriedenheitsrate, Kosten – und validieren Sie die Migration oder kehren Sie zur vorherigen Version zurück.

Der Vergleichsschritt ist der Kern des Systems und setzt voraus, dass Sie die Ausgaben der installierten Version erhalten haben: Ohne diese Referenz reduziert sich „Vergleichen” auf eine bloße Einschätzung. Die Beobachtungsphase beinhaltet bewusst die Kosten. Eine neuere Version könnte ausführlicher sein, mehr Ausgabe-Token generieren und Ihre Rechnung für gleich wahrgenommene Qualität um mehrere Prozent erhöhen. 48 Stunden reichen in der Regel aus, um dies zu erkennen, und die Rückkehr zur vorherigen Version bleibt eine einfache Konfigurationszeile.

Wichtige Erkenntnisse

  • Einfacher Alias (grok-4.20): neueste stabile Version, für die Entwicklung
  • Latest-Alias (grok-4.20-latest): Version am Rand des Stabilitätsbereichs, ausschließlich zum Testen
  • Festgelegte Version (grok-4.20-0309): unveränderlich, die einzige empfohlene Option für die Produktion
  • Verwenden Sie verschiedene Konventionen pro Umgebung (Entwicklung/Staging/Produktion)
  • Planen Sie einen strukturierten Migrationsprozess, wenn Sie von einer festgelegten Version zur nächsten wechseln