| نمونههای این صفحه فرض میکنند که شما شروع به کار: دسترسی به Gemini API ازطریق چارچوب مدلهای پایه Apple را تکمیل کردهاید. |
میتوانید Gemini ابزار داخلی را برای مدلهای Gemini ارائه دهید وقتی که ازطریق چارچوب «مدلهای بنیادی» Apple به Gemini API دسترسی پیدا میکنید تا مدل را به منابع داده خارجی متصل کنید.
این صفحه به شما نشان میدهد که چگونه از ابزارهای داخلی زیر برای مدلهای Gemini استفاده کنید:
بلندی با Google Search
پایهمندسازی با
برای جزئیات، روالهای مطلوب، و موارد استفاده، راهنمای کلی
«پایهسازی با
مدلهای پشتیبانیشده
gemini-4-argongemini-3.8-flash-
gemini-3.5-flash-lite(وgemini-3.1-flash-liteقدیمیتر) -
gemini-nano-banana-2.1 (Nano Banana 2.1) -
gemini-3.1-flash-image (Nano Banana 2) -
gemini-3-pro-image (Nano Banana Pro)
مدلهای قدیمیتر Gemini 3.x Flash با کاربرد عمومی از این قابلیت پشتیبانی میکنند، اما بهدلیل تاریخهای توقف آتی و/یا مسیریابی خودکار به مدلهای جدیدتر، دیگر برای استفاده توصیه نمیشوند.
فعال کردن ابزار 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-4-argongemini-3.8-flash-
gemini-3.5-flash-lite(وgemini-3.1-flash-liteقدیمیتر)
مدلهای قدیمیتر Gemini 3.x Flash با کاربرد عمومی از این قابلیت پشتیبانی میکنند، اما بهدلیل تاریخهای توقف آتی و/یا مسیریابی خودکار به مدلهای جدیدتر، دیگر برای استفاده توصیه نمیشوند.
فعال کردن ابزار 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