Menyediakan alat ke model saat mengakses Gemini API melalui framework Model Dasar Apple


Contoh di halaman ini mengasumsikan bahwa Anda telah menyelesaikan Mulai: Akses Gemini API melalui framework Model Foundation Apple.


Anda dapat menyediakan alat bawaan Gemini untuk model Gemini saat mengakses Gemini API melalui framework Model Dasar Apple untuk menghubungkan model ke sumber data eksternal.

Halaman ini menunjukkan cara menggunakan alat bawaan berikut untuk model Gemini:

Grounding dengan Google Search menghubungkan model Gemini ke konten web real-time yang tersedia secara publik. Dengan fitur ini, model dapat memberikan jawaban yang lebih akurat dan terbaru serta mengutip sumber yang dapat diverifikasi.

Untuk mengetahui detail, praktik terbaik, dan kasus penggunaan, lihat panduan umum Perujukan dengan Google Search.

Model yang didukung

  • gemini-3.1-pro-preview
  • gemini-3.5-flash
  • gemini-3.1-flash-lite
  • gemini-3-pro-image-preview (alias "Nano Banana Pro")
  • gemini-3.1-flash-image-preview (alias "Nano Banana 2")

Berikan alat googleSearch sebagai bagian dari pembuatan geminiLanguageModel:

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

Menyambungkan dengan Google Maps

Grounding dengan Google Maps menghubungkan model Gemini ke data geospasial dari Google Maps sehingga Anda dapat membangun fungsi yang mengetahui lokasi ke dalam aplikasi Anda.

Untuk mengetahui detail, praktik terbaik, dan kasus penggunaan, lihat panduan umum Perujukan dengan Google Maps.

Model yang didukung

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

Mengaktifkan alat Google Maps

Sediakan alat googleMaps sebagai bagian dari pembuatan geminiLanguageModel. Anda juga dapat secara opsional memberikan koordinat dalam konfigurasi alat.

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


Memberikan masukan tentang cara mengakses Gemini API melalui framework Model Dasar Apple