Entwicklerleitfaden für Gemini 3.7 Flash

Gemini 3.7 Flash ist unser intelligentes Modell für den täglichen Einsatz für Entwickler. Es stellt einen Schritt nach vorn im Bereich Softwareentwicklung dar und ist deutlich angenehmer zu verwenden. Dieses Modell bietet eine bessere Intelligenz für komplexe Aufgaben, die Befolgung von Anweisungen und Toolaufrufe in Ihren täglichen Workflows.

In diesem Dokument erfahren Sie, was es Neues bei Gemini 3.7 Flash gibt, wie es in die Gemini-Modellfamilie passt, wie Sie zu Gemini 3.7 Flash migrieren und wie Sie Gemini 3.7 Flash schnell verwenden können.

Wie passt es in die Gemini-Familie?

Gemini 3.7 Flash ist das wichtigste Agentenmodell in der Gemini 3-Familie. Es schließt die Lücke zwischen den Pro-Modellen mit umfassenden Schlussfolgerungen und den Gemini Flash-Lite-Modellen mit hohem Durchsatz und bietet gleichzeitig eine hohe Token-Effizienz und multimodale Verarbeitung in mehreren Schritten.

Modellspezifikationen und Vergleiche

In der folgenden Tabelle werden einige der Spezifikationen von Gemini 3.7 Flash, Gemini 3.6 Flash und Gemini 3.1 Pro verglichen:

Auf der Modellseite zu Gemini 3.7 Flash finden Sie eine vollständige Liste der unterstützten Funktionen, Tools und Nutzungsoptionen.

Neuerungen in Gemini 3.7 Flash

In der folgenden Tabelle werden die Standard-Benchmarks für die Entwicklerbewertung zwischen Gemini 3.7 Flash und Gemini 3.6 Flash verglichen:

Kurzanleitung

Bevor Sie beginnen, müssen Sie sich mit den Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) oder einem API-Schlüssel bei der Agent Platform authentifizieren. Weitere Informationen finden Sie unter Erste Schritte mit der Gemini Enterprise Agent Platform.

Ersetzen Sie in den folgenden Codeblöcken PROJECT_ID durch Ihre Projekt-ID.

Installation

Achten Sie darauf, dass Sie das neueste google-genai-SDK verwenden:

pip install --upgrade google-genai

Einfache Anfrage

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.7-flash",
  contents="How does AI work?",
)
print(response.text)

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.7-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Obligatorische API-Regeln und Verhaltenskonventionen

Gemini 3.7 Flash erzwingt die folgenden Standard-API-Konventionen der Gemini 3-Familie:

• Eingestellte Sampling-Parameter (temperature, top_k, top_p): Diese Parameter werden vom Back-End ignoriert. Stattdessen können Sie den Determinismus mit thinking_level (LOW, MEDIUM, HIGH) und response_schema oder json_schema steuern.
• Nicht unterstützte Parameter (frequency_penalty, presence_penalty, candidate_count): Wenn Sie frequency_penalty, presence_penalty oder candidate_count übergeben, wird ein aktiver API-Fehler ausgelöst. Entfernen Sie sie aus dem Legacy-Clientcode.

• Strenge Regeln für Funktionsaufrufe: Ein FunctionResponse Turn muss genau mit der id, dem name und der Anzahl der Ausführungen des vorherigen FunctionCall übereinstimmen.

  • Multimodale Assets: Platzieren Sie multimodale Assets immer in der Antwortnutzlast.
  • Formatierung und Text vor dem Tool: Formatieren Sie Inline-Anweisungen mit \n\n. Wenn Malformed_Function_Call-Fehler im Zusammenhang mit Text vor dem Tool auftreten, entfernen Sie vor Toolaufrufen führende Kommentare.

  • Wenn Sie vor einem Toolaufruf Zwischennotizen oder Statusaktualisierungen übergeben möchten, schließen Sie sie in einen dedizierten update()-Funktionsaufruf ein, anstatt Roh-XML oder Text auszugeben:

    {
      "name": "update",
      "description": "Update working notes before tool execution",
      "parameters": {
        "type": "OBJECT",
        "properties": {
          "previous_step": {"type": "STRING"},
          "plan": {"type": "STRING"},
          "next_step": {"type": "STRING"}
        },
        "required": ["previous_step", "plan", "next_step"]
      }
    }
    

• Validierung der Chatsequenz:

  • Verlaufsnutzlasten dürfen nicht mit einem Turn der Rolle "model" enden.
  • Vorausgefüllte Modell-Turns werden nicht unterstützt und müssen beim Upgrade entfernt werden.
  • Leere Turns im Unterhaltungsverlauf werden automatisch entfernt oder führen zu Validierungsfehlern.

Von Gemini 3.5 Flash oder Gemini 3.6 Flash zu Gemini 3.7 Flash migrieren

So migrieren Sie von Gemini 3.5 Flash oder Gemini 3.6 Flash zu Gemini 3.7 Flash:

1. Modell-ID aktualisieren: Ändern Sie die Modellstring in Ihren API-Aufrufen in gemini-3.7-flash.
2. Parameter für das Budget für Schlussfolgerungen ersetzen: Ersetzen Sie die Konfigurationen für die Ganzzahl thinking_budget durch die String-Enum thinking_level, die auf einen der folgenden Werte festgelegt ist:
   • HIGH: Empfohlen für dichte visuelle Qualitätssicherung, Erkennung von Bewegungen im Bruchteil einer Sekunde (Sport, Bearbeitung) oder mehrstufige Schlussfolgerungen in Videos mit einer Länge von mehr als 60 Minuten.
   • MEDIUM: Der Standard-Denkaufwand. Diese Stufe bietet ein optimales Gleichgewicht für allgemeine Fragen und Antworten zu Videos, Zusammenfassungen von Vorlesungen und das Abrufen von Clips.
   • LOW: Empfohlen für Aufgaben wie schnelle transkriptorientierte Suchvorgänge oder grundlegende Metadatenextraktion.
3. Eingestellte und nicht unterstützte Parameter entfernen:
   • Entfernen Sie temperature, top_p und top_k.
   • Entfernen Sie candidate_count, frequency_penalty und presence_penalty.
   • Entfernen Sie alle vorausgefüllten Modell-Turns aus Unterhaltungsverläufen.

Zusammenfassende Checkliste für Entwickler

Zusätzliche Ressourcen

• Modellseite zu Gemini 3.7 Flash
• Einführungs-Notebook