Tools für das Modell bereitstellen, wenn über das Foundation Models-Framework von Apple auf die Gemini API zugegriffen wird


Bei den Beispielen auf dieser Seite wird davon ausgegangen, dass Sie die Erste Schritte: Zugriff auf Gemini API über das Foundation Models-Framework von Apple abgeschlossen haben.


Sie können Gemini-Modellen integrierte Gemini-Tools zur Verfügung stellen, wenn Sie über das Foundation Models-Framework von Apple auf die Gemini API zugreifen, um das Modell mit externen Datenquellen zu verbinden.

Auf dieser Seite wird beschrieben, wie Sie die folgenden integrierten Tools für Gemini-Modelle verwenden:

Durch die Fundierung mit Google Search wird ein Gemini-Modell mit öffentlich verfügbaren Webinhalten in Echtzeit verbunden. So kann das Modell genauere, aktuellere Antworten geben und überprüfbare Quellen zitieren.

Weitere Informationen, Best Practices und Anwendungsfälle finden Sie im allgemeinen Leitfaden Fundierung mit Google Search.

Unterstützte Modelle

  • gemini-3.1-pro-preview
  • gemini-3.8-flash (und die älteren gemini-3.7-flash, gemini-3.6-flash und gemini-3.5-flash)
  • gemini-3.5-flash-lite (und die ältere gemini-3.1-flash-lite)
  • gemini-3-pro-image (auch „Nano Banana Pro“ genannt)
  • gemini-3.1-flash-image (auch „Nano Banana 2“)

Geben Sie das googleSearch-Tool an, wenn Sie die geminiLanguageModel erstellen:

import FoundationModels
import FirebaseCore
import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(
  name: "GEMINI_MODEL_NAME",
  // Provide Google Search as a tool that the model can use to generate its response.
  serverTools: [GeminiTool.googleSearch()]
)

let session = LanguageModelSession(model: model)
let response = try await session.respond(to: "What is the weather in Toronto today?")
for entry in response.transcriptEntries {
  if case let .response(responseEntry) = entry {
    if let groundingMetadata = responseEntry
        .metadata["groundingMetadata"] as? GroundingMetadata {
      for chunk in groundingMetadata.groundingChunks {
        let webChunk = chunk.web
        // use the webChunk
      }
    }
  }
}

// Make sure to comply with the "Grounding with Google Search" usage requirements,
// which includes how you use and display the grounded result

Fundierung mit Google Maps

Durch die Fundierung mit Google Maps wird ein Gemini-Modell mit Geodaten von Google Maps verbunden, sodass Sie standortbezogene Funktionen in Ihre Apps einbauen können.

Weitere Informationen, Best Practices und Anwendungsfälle finden Sie im allgemeinen Leitfaden Fundierung mit Google Maps.

Unterstützte Modelle

  • gemini-3.1-pro-preview
  • gemini-3.5-flash
  • gemini-3.1-flash-lite

Google Maps-Tool aktivieren

Geben Sie das googleMaps-Tool an, wenn Sie die geminiLanguageModel erstellen. Sie können optional auch Koordinaten in der Konfiguration des Tools angeben.

import FoundationModels
import FirebaseCore
import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(
  name: "GEMINI_MODEL_NAME",
  // Provide Google Maps as a tool that the model can use to generate its response.
  serverTools: [GeminiTool.googleMaps()]
)

let session = LanguageModelSession(model: model)

let response = try await session
      respond(to: "Where is a good place to grab a coffee near Alameda, CA?")

for entry in response.transcriptEntries {
  if case let .response(responseEntry) = entry {
    if let groundingMetadata = responseEntry
        .metadata["groundingMetadata"] as? GroundingMetadata {
      for chunk in groundingMetadata.groundingChunks {
        let mapsChunk = chunk.maps
        // use the mapsChunk
      }
    }
  }
}

// Make sure to comply with the "Grounding with Google Maps" usage requirements,
// which includes how you meet service usage requirements


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