לספק כלים למודל כשניגשים אל Gemini API דרך מסגרת Foundation Models של אפל


בדוגמאות שבדף הזה מניחים שסיימתם את השלב תחילת העבודה: גישה אל Gemini API באמצעות מסגרת Foundation Models של Apple.


אתם יכולים לספק Gemini כלים מובנים לGemini מודלים כשאתם ניגשים אל Gemini API דרך מסגרת Foundation Models של אפל כדי לחבר את המודל למקורות נתונים חיצוניים.

בדף הזה מוסבר איך להשתמש בכלים המובנים הבאים למודלים של Gemini:

העיגון באמצעות Google Search מחבר מודל של Gemini לתוכן מהאינטרנט שזמין לציבור ומתעדכן בזמן אמת. כך המודל יכול לספק תשובות מדויקות ועדכניות יותר ולצטט מקורות ניתנים לאימות.

פרטים, שיטות מומלצות ותרחישי שימוש מופיעים במדריך הכללי בנושא הארקה באמצעות Google Search.

מודלים נתמכים

  • gemini-3.1-pro-preview
  • gemini-3.5-flash
  • gemini-3.1-flash-lite
  • gemini-3-pro-image-preview (או Nano Banana Pro)
  • gemini-3.1-flash-image-preview (נקרא גם Nano Banana 2)

צריך לספק את הכלי googleSearch כחלק מיצירת 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

עיגון באמצעות Google Maps

הארקה באמצעות Google Maps מקשרת מודל Gemini לנתונים גיאו-מרחביים מ-Google Maps, כדי שתוכלו לשלב באפליקציות שלכם פונקציונליות שמבוססת על מיקום.

פרטים, שיטות מומלצות ותרחישי שימוש מופיעים במדריך הכללי בנושא הארקה באמצעות Google Maps.

מודלים נתמכים

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

הפעלת הכלי Google Maps

השימוש בכלי googleMaps הוא חלק מתהליך היצירה של 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 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


שליחת משוב על הגישה אל Gemini API באמצעות מסגרת Foundation Models של Apple