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

W każdym żądaniu wysyłanym do modelu możesz przekazać ustawienia konfiguracji, aby określić, jak model ma generować odpowiedź. Każdy Gemini model 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:

• Instrukcje systemowe
• Myślenie (czyli „rozumowanie”)
• Wygenerowany obraz
• Konfiguracja ogólna

Określanie instrukcji systemowych

Instrukcje systemowe to rodzaj „wprowadzenia”, które 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."
)

// ...

Konfigurowanie myślenia (czyli „rozumowania”)

Możesz skonfigurować ilość myślenia (nazywanego też rozumowaniem), jaką Gemini model może wykonać, aby wygenerować odpowiedź. Szczegółowe informacje, sprawdzone metody i przypadki użycia znajdziesz w ogólnym przewodniku Myślenie.

Zamiast poziomu myślenia firma Apple używa terminu poziom rozumowania. W przypadku każdej prośby możesz ustawić reasoningLevel w ContextOptions 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:

• Gemini 3.x modele zawsze korzystają z myślenia. W przypadku tych modeli nie można wyłączyć ani wstrzymać myślenia.
• 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ć w przypadku 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.

^{1 gemini-3.8-flash i gemini-3.7-flashnie obsługują poziomu myślenia MINIMAL. Jeśli ustawisz poziom myślenia na MINIMAL, żądanie nie powiedzie się i zwróci błąd 400.}

Konfigurowanie danych wyjściowych obrazu

Konfiguracja ogólna

Prześlij opinię o dostępie do Gemini API za pomocą platformy modeli podstawowych Apple