| مثالهای این صفحه فرض میکنند که شما بخش «شروع به کار: دسترسی به API Gemini از طریق چارچوب مدلهای بنیادی اپل » را تکمیل کردهاید. |
شما میتوانید ابزارهای داخلی Gemini را هنگام دسترسی به API Gemini از طریق چارچوب Foundation Models اپل برای اتصال مدل به منابع داده خارجی، در اختیار مدلهای Gemini قرار دهید.
این صفحه نحوه استفاده از ابزارهای داخلی زیر را برای مدلهای Gemini به شما نشان میدهد:
اتصال به زمین با Google Search
اتصال به
برای جزئیات، بهترین شیوهها و موارد استفاده، به راهنمای عمومی Grounding with
مدلهای پشتیبانیشده
-
gemini-3.1-pro-preview -
gemini-3.5-flash -
gemini-3.1-flash-lite -
gemini-3-pro-image-preview(معروف به "نانو موز پرو") -
gemini-3.1-flash-image-preview(معروف به "نانو موز ۲")
فعال کردن ابزار 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-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
در مورد دسترسی به API Gemini از طریق چارچوب مدلهای بنیادی اپل، بازخورد خود را ارائه دهید.