Opcje konfiguracji podczas uzyskiwania dostępu do interfejsu Gemini API za pomocą platformy modeli podstawowych Apple


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 reasoningLevelContextOptions 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: .light
Gemini: LOW
Apple: .moderate
Gemini: MEDIUM
Apple: .deep
Gemini: 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