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 von geminiLanguageModel oder LanguageModelSession erhalten. Wenn Sie eine andere Konfiguration verwenden möchten, erstellen Sie ein neues Modell oder eine neue Sitzung mit dieser Konfiguration.

Auf dieser Seite werden die folgenden Konfigurationsoptionen beschrieben:

• Systemanweisungen
• Denkprozesse (auch „Reasoning“ genannt)
• Generierte Bildausgabe
• Allgemeine Konfiguration

Systemanweisungen angeben

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

Geben Sie Systemanweisungen für die 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 „Reasoning“ genannt) konfigurieren

Sie können konfigurieren, wie viel Denkarbeit (auch Reasoning genannt) ein Gemini Modell leisten kann, um eine Antwort zu generieren. Weitere Informationen, Best Practices und Anwendungsfälle für Denkprozesse finden Sie in der allgemeinen Anleitung zu Denkprozessen.

Anstelle von Denkstufe verwendet Apple Reasoning-Stufe. 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 die Denkstufe

Wichtige Hinweise:

• Gemini 3.x Modelle verwenden immer Denkprozesse. Sie können die Denkprozesse für diese Modelle nicht deaktivieren oder ausschalten.
• Gemini 3.x Modelle verwenden immer dynamische Denkprozesse. Das Modell entscheidet wann und wie viel es bis zum konfigurierten Betrag denkt.

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

Bildausgabe konfigurieren

Allgemeine Konfiguration

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