| בדוגמאות שבדף הזה מניחים שסיימתם את השלב תחילת העבודה: גישה אל Gemini API באמצעות מסגרת Foundation Models של Apple. |
אתם יכולים לספק Gemini כלים מובנים לGemini מודלים כשאתם ניגשים אל Gemini API דרך מסגרת Foundation Models של אפל כדי לחבר את המודל למקורות נתונים חיצוניים.
בדף הזה מוסבר איך להשתמש בכלים המובנים הבאים למודלים של Gemini:
עיגון באמצעות Google Search
העיגון באמצעות
פרטים, שיטות מומלצות ותרחישי שימוש מופיעים במדריך הכללי בנושא הארקה באמצעות
מודלים נתמכים
gemini-3.1-pro-previewgemini-3.5-flashgemini-3.1-flash-lite-
gemini-3-pro-image-preview(או Nano Banana Pro) -
gemini-3.1-flash-image-preview(נקרא גם Nano Banana 2)
הפעלת הכלי Google Search
צריך לספק את הכלי 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
הארקה באמצעות
פרטים, שיטות מומלצות ותרחישי שימוש מופיעים במדריך הכללי בנושא הארקה באמצעות
מודלים נתמכים
gemini-3.1-pro-previewgemini-3.5-flashgemini-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