| Przykłady na tej stronie zakładają, że masz już za sobą pierwsze kroki: dostęp do Gemini API w ramach platformy Foundation Models od Apple. |
W każdym żądaniu wysyłanym do modelu możesz przekazać ustawienia konfiguracji, aby określić, jak model ma generować odpowiedź. Każdy model Gemini oferuje różne opcje konfiguracji.
W zależności od ustawienia konfiguracja jest utrzymywana przez cały okres ważności geminiLanguageModel lub LanguageModelSession. Jeśli chcesz użyć innej konfiguracji, utwórz nowy model lub sesję z tą konfiguracją.
Na stronie opisano te opcje konfiguracji:
Określanie instrukcji systemowych
Instrukcje systemowe to rodzaj „wstępu”, który dodajesz, zanim model otrzyma dalsze instrukcje od użytkownika. Umożliwia to sterowanie działaniem modelu na podstawie konkretnych potrzeb i przypadków użycia.
Określ instrukcje systemowe na stronie 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."
)
// ...
Skonfiguruj myślenie (czyli „rozumowanie”)
Możesz skonfigurować ilość myślenia (nazywanego też rozumowaniem), jaką modelGemini może wykorzystać do wygenerowania odpowiedzi. Szczegółowe informacje, sprawdzone metody i przykłady użycia myślenia znajdziesz w ogólnym przewodniku Myślenie.
Zamiast poziomu myślenia Apple używa poziomu wnioskowania. W każdym żądaniu ustawiasz parametr reasoningLevel w ContextOptions za pomocą parametru 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 korzystają z myślenia. Nie możesz wyłączyć ani dezaktywować myślenia w przypadku tych modeli.
- Gemini 3.x modele zawsze używają dynamicznego myślenia – 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 modelu Gemini. Pamiętaj, że jeśli użyjesz wartości Gemini (MINIMAL, LOW, MEDIUM, HIGH), zostanie ona automatycznie zamieniona na wersję Apple.
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. Proste zadania |
Model wykorzystuje mniej tokenów, co minimalizuje czas oczekiwania i koszty. Proste zadania i zadania wymagające dużej przepustowości |
Model stosuje zrównoważone podejście Zadania o średniej złożoności |
Model wykorzystuje tokeny do maksymalnego poziomu złożone prompty wymagające dogłębnego rozumowania, |
|
gemini-3.1-pro-preview |
(domyślnie) | |||
gemini-3.5-flash |
(domyślnie) | |||
gemini-3.1-flash-lite |
(domyślnie) | |||
gemini-3-pro-image-preview („Nano Banana Pro”) |
(domyślnie) | |||
gemini-3.1-flash-image-preview („Nano Banana 2”) |
(domyślnie) |
Konfigurowanie danych wyjściowych obrazu
Przykłady użycia tej funkcji w przypadku platformy Foundation Models od Apple pojawią się wkrótce.Konfiguracja ogólna
Prześlij opinię na temat dostępu do Gemini API za pomocą platformy modeli podstawowych Apple