Z użyciem najnowszych modeli Gemini

Ta strona 3.5 Flash

Modele Gemini 3.6 Flash (gemini-3.6-flash) i Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite) są ogólnie dostępne i gotowe do użycia w produkcji.

• Gemini 3.6 Flash: większa wydajność w przypadku złożonych zadań agentowych i multimodalnych przy jednoczesnym zmniejszeniu zużycia tokenów i niższej cenie niż w przypadku modelu 3.5 Flash.
• Gemini 3.5 Flash-Lite: najszybszy i najtańszy model z rodziny 3.5. Przewyższa poprzednie generacje Flash-Lite pod względem przepustowości.

Z tego przewodnika dowiesz się, co nowego wprowadziliśmy w poszczególnych modelach, jakie zmiany w interfejsie API mają wpływ na Twój kod i jak przeprowadzić migrację.

Nowe modele

Oba modele obsługują okno kontekstu o wielkości 1 mln tokenów, maksymalnie 64 tys. tokenów wyjściowych, myślenie i pełny zestaw wbudowanych narzędzi, w tym korzystanie z komputera.

Pełne dane techniczne znajdziesz na stronach modeli:

• Strona modelu Gemini 3.6 Flash
• Strona modelu Gemini 3.5 Flash-Lite

Szczegółowe informacje o cenach znajdziesz na stronie z cennikiem.

Krótkie wprowadzenie

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Write a three.js script that renders an interactive 3D robot."
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.6-flash",
    input: "Write a three.js script that renders an interactive 3D robot.",
  });
  console.log(interaction.outputText);
}

main();

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "model": "gemini-3.6-flash",
    "input": {
      "parts": [{"text": "Write a three.js script that renders an interactive 3D robot."}]
    }
  }'

Nowości w Gemini 3.6 Flash

• Redukcja liczby tokenów i tur: wykonuje wieloetapowe przepływy pracy z mniejszą liczbą kroków rozumowania, tur konwersacyjnych i wywołań narzędzi niż Gemini 3.5. Ogranicza też spiralne działanie pętli wykonania.
• Ulepszone generowanie kodu: generuje kod wyższej jakości, gotowy do wdrożenia, z mniejszą liczbą niechcianych zmian i pętli debugowania.
• Lepsze wykonywanie instrukcji: ogranicza niepożądane zmiany w plikach podczas zadań diagnostycznych.
• Zaawansowane rozumowanie multimodalne i przestrzenne: lepsze wyniki w interpretacji wykresów, konwersji wizualnych planów i generowaniu układów stron internetowych z wieloma elementami.
• Wstępne sprawdzanie programowe: częściej niż Gemini 1.5 Flash uruchamia skrypty kodu diagnostycznego przed wprowadzeniem zmian. Zwiększa to dokładność w przypadku złożonych zadań, ale może wymagać dodatkowych kroków eksploracyjnych w przypadku prostych prac związanych z interfejsem.
• Obsługa korzystania z komputera: obsługiwana jako natywne narzędzie do automatyzacji interfejsu użytkownika agenta.
• Preferencje dotyczące stylu interfejsu: lepiej tworzy funkcjonalny kod, ale weryfikatorzy preferowali wcześniejsze modele pod względem układu wizualnego i stylu. Możesz temu zapobiec, podając wyraźne wytyczne dotyczące projektu.
• Domyślny poziom myślenia (średni): korzysta z tego samego medium domyślnego poziomu myślenia co Gemini 3.5 Flash.
• Niższe ceny: niższe koszty tokenów wyjściowych (7,50 USD za milion w porównaniu z 9,00 USD za milion w przypadku 3.5 Flash). Tokeny wejściowe pozostają na poziomie 1,50 USD za 1 mln.

Nowości w Gemini 3.5 Flash-Lite

• Krótszy czas oczekiwania na wykonanie zadania: najwyższa przepustowość w rodzinie 3.5 w przypadku analizowania dużych ilości danych i wyodrębniania dokumentów.
• Ulepszone rozumowanie i wydajność multimodalna: solidna ścieżka migracji z Gemini 2.5 Flash, z wyższymi wynikami w przypadku zadań związanych z rozumowaniem, takich jak HLE (18,0% w porównaniu z 11,0%), oraz testów porównawczych multimodalnych, takich jak CharXIV (74,5% w porównaniu z 63,7%).
• Orkiestracja subagentów i niezawodność narzędzi: zwiększa niezawodność wykonywania narzędzi w przypadku wykonywania kodu, wyszukiwania i przepływów pracy MCP. Zwiększ poziom myślenia w przypadku autonomicznego planowania i złożonych zadań podrzędnych agenta.
• Lepsze rozumienie dokumentów: zwiększa dokładność analizowania dokumentów i wyodrębniania danych strukturalnych. Eksperymentuj z minimalnym i wysokim poziomem myślenia w zależności od złożoności dokumentu.
• Interaktywne kodowanie w internecie i przetwarzanie danych tabelarycznych: dobrze radzi sobie z kodowaniem w JavaScript po stronie klienta i przetwarzaniem danych tabelarycznych, planując działania za pomocą lekkiego wykonywania kodu.
• Trwałość chatbota i osobowości: lepsze wykonywanie instrukcji wieloetapowych i spójność osobowości w porównaniu z modelem Gemini 3.1 Flash-Lite.
• Obsługa korzystania z komputera: obsługiwana jako natywne narzędzie do automatyzacji interfejsu użytkownika agenta.

Wybór odpowiedniego modelu Flash lub Flash-Lite

Wybierz odpowiedni model i ścieżkę migracji dla swoich zbiorów zadań.

W przypadku obu modeli należy usunąć wycofane parametry próbkowania (temperature, top_p, top_k) i wstępnie wypełnione tury modelu. Szczegółowe informacje znajdziesz w sekcji Zmiany w interfejsie API.

Zaktualizowany agent Antigravity

Ze względu na lepszą wydajność Gemini 3.6 Flash jest teraz nowym modelem domyślnym, który obsługuje agenta Antigravity w Gemini zarządzane agenty. Możesz to zmienić, ustawiając nowe pole w interfejsie API.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment="remote",
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    "environment": "remote"
}'

Zmiany w interfejsie API i aktualizacje parametrów

Począwszy od modeli Gemini 3.6 Flash i Gemini 3.5 Flash-Lite, poniższe zmiany w API będą dotyczyć tych modeli i wszystkich przyszłych wersji modeli Gemini.

• Wycofanie parametru próbkowania: parametry temperature, top_p i top_k zostały wycofane. Interfejs API ignoruje te parametry i w przyszłych generacjach modeli zwraca błąd.
• Weryfikacja wstępnie wypełnionych odpowiedzi modelu: wstępne wypełnianie odpowiedzi modelu nie jest już obsługiwane. Jeśli ostatnia niepusta tura w żądaniu jest turą model, interfejs API zwraca błąd 400.

Poniżej znajdziesz szczegółowe wyjaśnienia i przykłady kodu dotyczące każdej zmiany w interfejsie API.

1. Wycofanie parametrów próbkowania (temperature, top_p, top_k)

temperature, top_p i top_k są przestarzałe i ignorowane. W przyszłych generacjach modeli podanie tych parametrów będzie powodować zwrócenie błędu HTTP 400. Usuń te parametry ze wszystkich żądań.

# ⚠️ Remove these parameters (deprecated)
generation_config = {
     "temperature": 0.7,
     "top_p": 0.9,
     "top_k": 40,
}

Aby zwiększyć determinizm, zdefiniuj instrukcję systemową z wyraźnymi regułami dla konkretnego przypadku użycia.

2. Weryfikacja wstępnie wypełnionego modelu

Żądania do interfejsu API kończące się niepustą rolą modelu są niedozwolone i zwracają błąd HTTP 400.

⚠️ Unikaj

W przypadku starszych ładunków generateContent lub surowych ładunków REST kończących się turą z rolą modelu jest to teraz niedozwolone:

/* ❌ DO NOT: End payload contents with a 'model' role turn */
{
  "contents": [
    {"role": "user", "parts": [{"text": "Translate 'Hello world' to Spanish."}]},
    {"role": "model", "parts": [{"text": "Translation:"}]}  /* ❌ Returns error */
  ]
}

✅ Zalecana migracja (interfejs Interactions API)

W interfejsie API interakcji tury modelu nie są wypełniane ręcznie. Jeśli Twoja aplikacja wcześniej wstępnie wypełniała turę modelu, aby pominąć wstępy lub wymusić formatowanie JSON, użyj zamiast tego system_instruction lub danych wyjściowych strukturalnych.

# ✅ RECOMMENDED: Use system_instruction in the Interactions API to specify output format
interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Translate 'Hello world' to Spanish.",
    system_instruction="Output only the translation without introductory text.",
)

Lista kontrolna migracji

Migracja do modelu gemini-3.6-flash

• Zaktualizuj identyfikator modelu: zmień ciąg docelowego modelu na gemini-3.6-flash.
• Usuń wycofane parametry próbkowania:
  • Usuń temperature, top_p i top_k z konfiguracji generowania.
  • Zastąp thinking_budget wyliczeniem ciągu znaków thinking_level ustawionym na "medium" lub "high".
  • Usuń candidate_count (nieobsługiwane w Gemini 3.x).
• Wymuszaj reguły weryfikacji kolejki:
  • Ujednolicenie wieloetapowych rozmów po stronie serweraprevious_interaction_id.
  • Usuń wstępnie wypełnione tury modelu.
• Sprawdzanie wywoływania funkcji:
  • Umieść zasoby multimodalne w ładunku odpowiedzi.
  • Formatuj instrukcje wbudowane za pomocą \n\n.
  • Jeśli widzisz błędy Malformed_Function_Call związane z tekstem przed narzędziem, zapoznaj się z obejściami wymagań dotyczących tekstu przed narzędziem.
  • Tylko w przypadku korzystania z interfejsu generateContent API: upewnij się, że wszystkie obiekty FunctionResponse zawierają call_id i name.
• Wymagania podstawowe dotyczące Gemini 3.x: informacje o aktualizacjach pakietu SDK i zachowaniu sygnatury myśli znajdziesz na liście kontrolnej migracji do Gemini 3.5.

Migracja do gemini-3.5-flash-lite

• Zaktualizuj identyfikator modelu: zmień ciąg docelowego modelu na gemini-3.5-flash-lite.
• Skonfiguruj poziom wysiłku umysłowego:
  • W przypadku ekstrakcji, routingu lub klasyfikacji dużych ilości danych pozostaw wartość thinking_level na "minimal" (domyślnie), aby uzyskać maksymalną przepustowość.
  • W przypadku autonomicznych subagentów z wywołaniami narzędzi, wykonywaniem kodu lub wieloetapowym rozumowaniem ustaw wartość thinking_level na "medium" lub "high", aby zapobiec przedwczesnemu zakończeniu działania narzędzia.
• Usuwanie wycofanych parametrów i weryfikowanie wywoływania funkcji: zastosuj te same reguły co w przypadku wersji 3.6 Flash.
• Wymagania podstawowe dotyczące Gemini 3.x: zapoznaj się z listą kontrolną migracji do Gemini 3.5.

Dalsze kroki

• Specyfikacje interfejsu API znajdziesz w przeglądzie modeli.
• Więcej informacji o administrowaniu wieloma agentami znajdziesz w przewodniku po interfejsie Interactions API.
• Testuj i dopracowuj prompty w Google AI Studio.