| تفترض الأمثلة الواردة في هذه الصفحة أنّك أكملت مقالة البدء: الوصول إلى Gemini API من خلال إطار عمل Apple's Foundation Models. |
يمكنك تزويد Gemini نماذج بـ Gemini أدوات مضمّنة عند الوصول إلى Gemini API من خلال إطار عمل Apple's Foundation Models لـ ربط النموذج بمصادر البيانات الخارجية.
توضّح لك الصفحة كيفية استخدام الأدوات المضمّنة التالية لنماذج Gemini:
تحديد المصدر من خلال Google Search
تتيح ميزة "تحديد المصدر من خلال
للاطّلاع على التفاصيل وأفضل الممارسات وحالات الاستخدام، يُرجى الرجوع إلى دليل تحديد المصدر من خلال بحث Google العام
النماذج المتوافقة
gemini-3.1-pro-previewgemini-3.6-flash(والإصدار الأقدمgemini-3.5-flash)gemini-3.5-flash-lite(والإصدار الأقدمgemini-3.1-flash-lite)gemini-3-pro-image(المعروف أيضًا باسم "Nano Banana Pro")gemini-3.1-flash-image(المعروف أيضًا باسم "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 من خلال إطار عمل Apple's Foundation Models