هنگام دسترسی به API Gemini از طریق چارچوب مدل‌های Foundation اپل، ابزارهایی را در اختیار مدل قرار دهید.


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


شما می‌توانید ابزارهای داخلی Gemini را هنگام دسترسی به API Gemini از طریق چارچوب Foundation Models اپل برای اتصال مدل به منابع داده خارجی، در اختیار مدل‌های Gemini قرار دهید.

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

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

برای جزئیات، بهترین شیوه‌ها و موارد استفاده، به راهنمای عمومی Grounding with Google Search مراجعه کنید.

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

  • 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 (معروف به "نانو موز ۲")

ابزار 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-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 از طریق چارچوب مدل‌های بنیادی اپل، بازخورد خود را ارائه دهید.