Gemini 3.1 Pro Preview vs Customtools: którego używać?

Obie nazwy Gemini 3.1 Pro są oficjalnymi ID modeli Google. gemini-3.1-pro-preview to zwykły model. gemini-3.1-pro-preview-customtools jest wariantem zaprojektowanym tak, by lepiej korzystać z narzędzi niestandardowych, gdy agent ma też dostęp do bash. Sufiks nie oznacza „więcej rozumowania”, a zwykły model już obsługuje wywoływanie funkcji.^[1]

Do ogólnego programowania, analizy dokumentów i pytań multimodalnych zwykły Preview jest rozsądnym punktem wyjścia. Rozważ porównanie Customtools, gdy agent wielokrotnie wybiera polecenie powłoki zamiast zamierzonej funkcji niestandardowej. Zalecenie wynika z udokumentowanej różnicy; ten artykuł nie przedstawia nowego benchmarku A/B.

Dwa ID modeli Gemini 3.1 Pro

Skopiuj pełny identyfikator do konfiguracji. Oba ID zawierają preview; Customtools jest osobnym wyborem w obrębie tej rodziny wydań.

Google wymienia obie nazwy razem na stronie modelu. Ostrzega też, że wersja Customtools może wykazywać wahania jakości przy zapytaniach, które nie korzystają z tego przepływu pracy z narzędziami. Inny sufiks to zatem powód do oceny konkretnego zachowania, a nie dowód na ogólną poprawę.^[1]

Wspólna specyfikacja modelu podaje limit wejścia 1 048 576 tokenów, limit wyjścia 65 536 tokenów, wejście multimodalne i wyjście tekstowe. Te główne limity nie mówią, które narzędzie agent wybierze w konkretnej rozmowie. Porównując wyniki, oddzielaj identyfikator modelu, definicje narzędzi i rezultat zadania.

Co zmienia Customtools

Google opisuje preferowanie funkcji niestandardowych, takich jak view_file i search_code, gdy dostępny jest również bash. Ma to znaczenie, gdy aplikacja ma już zdefiniowane wyspecjalizowane narzędzia z przewidywalnymi wynikami i uprawnieniami.^[1]

Rozważ hipotetycznego asystenta programistycznego z trzema opcjami: funkcją odczytującą jeden plik, funkcją wyszukującą symbole repozytorium i ogólnym narzędziem powłoki. Zadaniem jest znalezienie definicji funkcji. Pomóc może zarówno funkcja wyszukiwania w repozytorium, jak i polecenie powłoki. Przydatne pytanie brzmi: czy model wybiera narzędzie najlepiej pasujące do zamierzonego przepływu pracy aplikacji?

To scenariusz ilustracyjny, a nie zarejestrowana odpowiedź któregoś modelu. Customtools nie gwarantuje konkretnego wywołania, nie eliminuje potrzeby deklarowania funkcji ani nie przejmuje kontroli uprawnień aplikacji. Aplikacja nadal decyduje, czy wykonać wywołanie i jaki wynik zwrócić.

Różnica staje się najbardziej istotna po zaobserwowaniu problemu z wyborem narzędzi. Jeśli zwykły model już wybiera zamierzoną funkcję i wykonuje zadanie, zmiana wariantu dodaje kolejną zmienną bez wcześniejszego określenia poprawy, którą można zmierzyć.

Customtools nie jest poziomem rozumowania

Gemini 3.1 Pro ma odrębne poziomy rozumowania low, medium i high. Natywne generateContent domyślnie używa high; minimal nie jest obsługiwane przez ten model. To ustawienia generowania, a nie alternatywne ID modeli.^[2]

Przejście z low na high może zmienić budżet rozumowania używany do zadania. Zmiana ID modelu na Customtools dotyczy sposobu wyboru narzędzi. Jeśli zmienisz oba ustawienia naraz, inna odpowiedź nie pokaże, która zmiana miała znaczenie.

Aby porównanie było przydatne, zachowaj ten sam prompt, deklaracje narzędzi, historię rozmowy, poziom rozumowania i limit wyjścia. Google zaleca też pozostawienie temperatury 1.0 w Gemini 3. Porównaj, czy żądana praca została wykonana, jakie narzędzia wywołano, czy argumenty były poprawne i jakie zużycie zgłosiła odpowiedź. Są to wskazówki do oceny, a nie zmierzone przewagi któregoś wariantu.

Możesz korzystać z funkcji w zwykłym Preview

Oficjalna specyfikacja zwykłego modelu wymienia obsługę wywoływania funkcji. Nie potrzebujesz sufiksu Customtools, aby zadeklarować funkcję, otrzymać jej wywołanie, wykonać ją w aplikacji i odesłać wynik.^[1]

Do interfejsu funkcji używaj natywnego tools[].functionDeclarations. Kontynuując rozmowę, zachowuj zwrócone części treści i podpisy rozumowania. Błąd wynikający z brakującego podpisu, niepoprawnego schematu argumentów lub nieprawidłowo zbudowanej odpowiedzi narzędzia jest problemem protokołu; zmiana nazw modeli nie potwierdza jego usunięcia.

Dokumentacja API Gemini 3.1 Pro zawiera natywne pola i ich ograniczenia. Zacznij od niewielkiej funkcji i wyniku, który możesz sprawdzić, zanim dodasz cały zestaw narzędzi.

Wybieraj pod kątem rzeczywistego przepływu pracy

Wybierz najpierw zwykły Preview, gdy praca polega głównie na generowaniu tekstu, wyjaśnianiu kodu, ekstrakcji dokumentów lub analizie multimodalnej. Jest też właściwym punktem wyjścia dla aplikacji używającej narzędzi. Przed oceną określ, jak wygląda poprawny wynik.

Porównaj Customtools, gdy aplikacja łączy bash z narzędziami niestandardowymi i masz konkretny problem wyboru do odtworzenia. Przygotuj krótki zestaw reprezentatywnych przypadków: jeden, w którym właściwa jest wyspecjalizowana funkcja, jeden rzeczywiście wymagający powłoki i jeden, w którym nie należy wywoływać żadnego narzędzia. Oceń zarówno wybrane działanie, jak i końcowy wynik.

Nie oceniaj wariantu wyłącznie po częstotliwości wywoływania preferowanego narzędzia. Zbędne wywołanie funkcji nadal jest zbędne. Przydatny model musi wybrać odpowiednie działanie, podać poprawne argumenty, zinterpretować wynik i odpowiedzieć na pierwotne żądanie.

Strona cenowa Google grupuje oba ID w tej samej tabeli cen modelu. Nie oznacza to, że rozumowanie, wybór poziomu przetwarzania czy zużycie tokenów są wymienne. Porównując żądania, sprawdzaj właściwe bieżące stawki i rzeczywiste zużycie.^[3]

Którą wersję podłącza SeedRouter?

Strona Gemini 3.1 Pro używa gemini-3.1-pro-preview. Wariant Customtools nie jest podłączony w tej integracji. Strona udostępnia Playground zwykłego modelu i bieżące ceny grup; dokumentacja API opisuje aktualne ograniczenia weryfikacji.

Używaj w aplikacji dokładnego ID zwykłego modelu. Ustaw jawnie opcje przetwarzania do kontrolowanej oceny i sprawdź wynik na własnym zadaniu, zanim uznasz konfigurację za odpowiednią do produkcji.

Często zadawane pytania

Czy obie nazwy modeli Gemini 3.1 Pro są oficjalne?

Tak. Google opisuje zarówno gemini-3.1-pro-preview, jak i gemini-3.1-pro-preview-customtools na tej samej stronie modelu. Drugi jest wyspecjalizowanym wariantem, a nie nieoficjalną pisownią.

Czy Customtools zastępuje zwykłe wywoływanie funkcji?

Nie. Zwykłe wywoływanie funkcji jest już dostępne w standardowym Preview. Customtools zmienia preferencje modelu w przepływie łączącym narzędzia niestandardowe i bash; aplikacja nadal deklaruje i wykonuje funkcje.

Czy Customtools zawsze jest lepszy do programowania?

Google nie formułuje tak ogólnego twierdzenia. Udokumentowana różnica dotyczy wyboru narzędzi, a strona modelu ostrzega o wahaniach jakości poza docelowym przepływem pracy. Porównaj zachowanie, którego faktycznie potrzebuje twoja aplikacja programistyczna.

Źródła

Sprawdzono 17 października 2026 r. Powyższe porównanie opiera się na dokumentacji, a nie na nowo przeprowadzonym benchmarku jakości.

1. Google: specyfikacja modelu Gemini 3.1 Pro — oficjalne ID, limity wejścia/wyjścia, wywoływanie funkcji i różnica dotycząca Customtools.
2. Google: przewodnik po natywnym Gemini 3 dla programistów — poziomy rozumowania, ustawienia natywnych żądań i zalecenia dotyczące temperatury.
3. Google: ceny Gemini API — wspólna oficjalna tabela cen dla obu ID modeli.