ارائه ابزار به مدل هنگام دسترسی به Gemini API ازطریق چارچوب «مدل‌های پایه» Apple


نمونه‌های این صفحه فرض می‌کنند که شما شروع به کار: دسترسی به Gemini API ازطریق چارچوب مدل‌های پایه Apple را تکمیل کرده‌اید.


می‌توانید Gemini ابزار داخلی را برای مدل‌های Gemini ارائه دهید وقتی که ازطریق چارچوب «مدل‌های بنیادی» Apple به Gemini API دسترسی پیدا می‌کنید تا مدل را به منابع داده خارجی متصل کنید.

این صفحه به شما نشان می‌دهد که چگونه از ابزارهای داخلی زیر برای مدل‌های Gemini استفاده کنید:

پایه‌مندسازی با Google Search مدل Gemini را به محتوای وب هم‌زمان و دردسترس عموم متصل می‌کند. این کار به مدل امکان می‌دهد پاسخ‌های دقیق‌تر و به‌روزتری ارائه دهد و به منابع قابل‌درستی‌سنجی استناد کند.

برای جزئیات، روال‌های مطلوب، و موارد استفاده، راهنمای کلی «پایه‌سازی با Google Search» را ببینید.

مدل‌های پشتیبانی‌شده

  • gemini-4-argon
  • gemini-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 با کاربرد عمومی از این قابلیت پشتیبانی می‌کنند، اما به‌دلیل تاریخ‌های توقف آتی و/یا مسیریابی خودکار به مدل‌های جدیدتر، دیگر برای استفاده توصیه نمی‌شوند.

ابزار 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-4-argon
  • gemini-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