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


Contoh di halaman ini mengasumsikan bahwa Anda telah menyelesaikan Memulai: Mengakses Gemini API melalui framework Foundation Models Apple.


Anda dapat menyediakan alat bawaan Gemini ke model Gemini saat mengakses Gemini API melalui framework Foundation Models 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 demikian, 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 Grounding dengan Google Search.

Model yang didukung

  • gemini-4-argon
  • gemini-3.8-flash
  • gemini-3.5-flash-lite (dan gemini-3.1-flash-lite yang lebih lama)
  • gemini-nano-banana-2.1 (Nano Banana 2.1)
  • gemini-3.1-flash-image (Nano Banana 2)
  • gemini-3-pro-image (Nano Banana Pro)

Model Gemini 3.x Flash penggunaan umum yang lebih lama mendukung kemampuan ini, tetapi tidak lagi direkomendasikan untuk digunakan karena tanggal penonaktifan yang akan datang dan/atau perutean otomatis ke model yang lebih baru.

Sediakan 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

Grounding dengan Google Maps

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

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

Model yang didukung

  • gemini-4-argon
  • gemini-3.8-flash
  • gemini-3.5-flash-lite (dan gemini-3.1-flash-lite yang lebih lama)

Model Gemini 3.x Flash penggunaan umum yang lebih lama mendukung kemampuan ini, tetapi tidak lagi direkomendasikan untuk digunakan karena tanggal penonaktifan yang akan datang dan/atau perutean otomatis ke model yang lebih baru.

Mengaktifkan alat Google Maps

Sediakan alat googleMaps sebagai bagian dari pembuatan geminiLanguageModel. Anda juga dapat 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


Berikan masukan tentang mengakses Gemini API melalui framework Foundation Models Apple