| Przykłady na tej stronie zakładają, że masz już za sobą sekcję Pierwsze kroki: dostęp do Gemini API za pomocą platformy Foundation Models firmy Apple. |
W każdym żądaniu wysyłanym do modelu możesz przesłać ustawienia konfiguracji, które określają, jak model ma generować odpowiedź. Każdy Gemini model oferuje inne opcje konfiguracji.
W zależności od ustawienia konfiguracja jest zachowywana przez cały okres istnienia geminiLanguageModel lub LanguageModelSession. Jeśli chcesz użyć innej konfiguracji, utwórz nowy model lub sesję z tą konfiguracją.
Na tej stronie opisujemy te opcje konfiguracji:
- Instrukcje systemowe
- Myślenie (inaczej „rozumowanie”)
- Wygenerowany obraz wyjściowy
- Konfiguracja ogólna
Określanie instrukcji systemowych
Instrukcje systemowe są jak „preambuła”, którą dodajesz, zanim model zostanie udostępniony użytkownikowi końcowemu. Pozwalają one sterować zachowaniem modelu na podstawie konkretnych potrzeb i przypadków użycia.
Określ instrukcje systemowe w LanguageModelSession:
// ...
// Make sure you initialize your chosen Gemini API backend service
let model = FirebaseAI.firebaseAI().geminiLanguageModel(name: "GEMINI_MODEL_NAME")
// Specify the system instructions as part of creating the session
let session = LanguageModelSession(
model: model,
instructions: "You are a cat. Your name is Neko."
)
// ...
Konfigurowanie myślenia (inaczej „rozumowania”)
Możesz skonfigurować ilość myślenia (inaczej rozumowania), jaką model Gemini może wykonać, aby wygenerować odpowiedź. Więcej informacji, sprawdzonych metod i przypadków użycia myślenia znajdziesz w ogólnym przewodniku po myśleniu.
Zamiast poziomu myślenia Apple używa poziomu rozumowania. Ustaw reasoningLevel w ContextOptions w każdym żądaniu za pomocą LanguageModelSession:
// ...
// Make sure you initialize your chosen Gemini API backend service
let model = FirebaseAI.firebaseAI().geminiLanguageModel(name: "GEMINI_MODEL_NAME")
let session = LanguageModelSession(model: model)
// Specify the reasoning level when generating a response
// Possible reasoningLevels: .light, .moderate, .deep, .custom("minimal")
let response = try await session.respond(
to: "Write a story about a magic backpack.",
contextOptions: ContextOptions(reasoningLevel: .REASONING_LEVEL)
)
// ...
Obsługiwane wartości poziomu myślenia
Pamiętaj:
- Modele Gemini 3.x zawsze używają myślenia. Nie możesz wyłączyć ani wyłączyć myślenia w przypadku tych modeli.
- Modele Gemini 3.x zawsze używają myślenia dynamicznego – model decyduje kiedy i ile myśli, aż do skonfigurowanej ilości.
W tabeli poniżej znajdziesz poziomy myślenia (reasoningLevel), które możesz
ustawić dla każdego Gemini modelu. Pamiętaj, że jeśli użyjesz wartości Gemini
(MINIMAL, LOW, MEDIUM, HIGH), zostanie ona automatycznie przypisana do
wersji Apple tej wartości.
Apple: .custom("minimal")Gemini: MINIMAL
|
Apple: .lightGemini: LOW
|
Apple: .moderateGemini: MEDIUM
|
Apple: .deepGemini: HIGH
|
|
|---|---|---|---|---|
|
Model używa jak najmniejszej liczby tokenów; prawie nie myśli Zadania o niskim stopniu złożoności |
Model używa mniejszej liczby tokenów; minimalizuje opóźnienie i koszty Proste zadania i zadania o dużej przepustowości |
Model stosuje zrównoważone podejście Zadania o średnim stopniu złożoności |
Model używa tokenów do maksymalnego poziomu Złożone prośby wymagające głębokiego rozumowania |
|
Gemini 3.x Progemini-3.1-pro-preview
|
(domyślnie) | |||
Gemini 3.x Flashgemini-3.6-flashgemini-3.5-flash
|
(domyślnie) | |||
Gemini 3.x Flash‑Litegemini-3.5-flash-litegemini-3.1-flash-lite
|
(domyślnie) | |||
Gemini 3.x Pro Imagegemini-3-pro-image(„Nano Banana Pro”) |
(domyślnie) | |||
Gemini 3.x Flash Imagegemini-3.1-flash-image(„Nano Banana 2”) |
(domyślnie) | |||
Gemini 3.x Flash‑Lite Imagegemini-3.1-flash-lite-image(„Nano Banana 2 Lite”) |
(domyślnie) |
Konfigurowanie obrazu wyjściowego
Konfiguracja ogólna
Prześlij opinię na temat dostępu do Gemini API za pomocą platformy Foundation Models firmy Apple