Konfigurationsoptionen für den Zugriff auf die Gemini API über das Foundation Models-Framework von Apple

In jeder Anfrage an ein Modell können Sie einige Konfigurationseinstellungen senden, um zu steuern, wie das Modell eine Antwort generiert. Jedes Gemini-Modell bietet unterschiedliche Konfigurationsoptionen.

Je nach Einstellung bleibt die Konfiguration für die Lebensdauer des geminiLanguageModel oder des LanguageModelSession erhalten. Wenn Sie eine andere Konfiguration verwenden möchten, erstellen Sie ein neues Modell oder eine neue Sitzung mit dieser Konfiguration.

Auf der Seite werden die folgenden Konfigurationsoptionen beschrieben:

• Systemanweisungen
• Denken (auch „Schlussfolgern“)
• Ausgabe generierter Bilder
• Allgemeine Konfiguration

Systemanweisungen festlegen

Systemanweisungen sind wie eine „Präambel“, die Sie hinzufügen, bevor das Modell für weitere Anweisungen des Endnutzers freigegeben wird. Sie können das Verhalten des Modells basierend auf Ihren spezifischen Anforderungen und Anwendungsfällen steuern.

Geben Sie Systemanweisungen auf der LanguageModelSession an:

// ...

// 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."
)

// ...

Denkprozesse (auch als „Begründung“ bezeichnet) konfigurieren

Sie können die Menge an Denkarbeit (auch Begründung genannt) konfigurieren, die ein Gemini-Modell leisten kann, um seine Antwort zu generieren. Weitere Informationen, Best Practices und Anwendungsfälle für das Denken finden Sie im allgemeinen Leitfaden Thinking.

Anstelle von Denkaufwand verwendet Apple Schlussfolgerungsniveau. Sie legen die reasoningLevel in ContextOptions für jede Anfrage über eine LanguageModelSession fest:

// ...

// 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)
)

// ...

Unterstützte Werte für den Denkaufwand

Wichtige Hinweise:

• Gemini 3.x-Modelle verwenden immer die Funktion „Thinking“. Sie können diese Funktion für diese Modelle nicht deaktivieren oder ausschalten.
• Gemini 3.x-Modelle verwenden immer dynamisches Denken. Das Modell entscheidet, wann und wie viel es bis zum konfigurierten Betrag denkt.

In der folgenden Tabelle sind die Denkebenen (reasoningLevel) aufgeführt, die Sie für jedes Gemini-Modell festlegen können. Wenn Sie einen Gemini-Wert verwenden (MINIMAL, LOW, MEDIUM, HIGH), wird dieser automatisch der Apple-Version dieses Werts zugeordnet.

^{1 gemini-3.8-flash und gemini-3.7-flash unterstützen nicht den Denkaufwand MINIMAL. Wenn Sie den Denkaufwand auf MINIMAL festlegen, schlägt die Anfrage mit einem 400-Fehler fehl.}

Bildausgabe konfigurieren

Allgemeine Konfiguration

Feedback zum Zugriff auf Gemini API über das Foundation Models-Framework von Apple geben