شروع به کار با Gemini API با استفاده از Vertex AI در SDKs Firebase، شروع با Gemini API با استفاده از Vertex AI در SDKs Firebase


این راهنما به شما نشان می‌دهد که چگونه می‌توانید با استفاده از Vertex AI در Firebase SDK برای پلتفرم انتخابی خود، مستقیماً از برنامه خود با Vertex AI Gemini API تماس بگیرید.

توجه داشته باشید که می‌توانید از این راهنما برای شروع دسترسی به مدل‌های Imagen با استفاده از Vertex AI در Firebase SDK نیز استفاده کنید.

پیش نیازها

این راهنما فرض می کند که شما با استفاده از جاوا اسکریپت برای توسعه برنامه های وب آشنا هستید. این راهنما مستقل از چارچوب است.

  • مطمئن شوید که محیط توسعه و برنامه وب شما شرایط زیر را دارد:

    • (اختیاری) Node.js
    • مرورگر وب مدرن

  • (اختیاری) برنامه نمونه را بررسی کنید.

    نمونه برنامه را دانلود کنید

    می توانید SDK را به سرعت امتحان کنید، اجرای کامل موارد استفاده مختلف را مشاهده کنید، یا اگر برنامه وب خود را ندارید از نمونه برنامه استفاده کنید. برای استفاده از برنامه نمونه، باید آن را به پروژه Firebase متصل کنید .

مرحله 1 : یک پروژه Firebase راه اندازی کنید و برنامه خود را به Firebase متصل کنید

اگر قبلاً یک پروژه Firebase و یک برنامه متصل به Firebase دارید

  1. در کنسول Firebase ، به صفحه Build with Gemini بروید.

  2. روی Vertex AI در کارت Firebase کلیک کنید تا یک گردش کاری راه اندازی شود که به شما کمک می کند کارهای زیر را انجام دهید:

  3. برای افزودن SDK به برنامه خود، مرحله بعدی این راهنما را ادامه دهید.

اگر قبلاً یک پروژه Firebase و یک برنامه متصل به Firebase ندارید

  1. وارد کنسول Firebase شوید.

  2. روی ایجاد پروژه کلیک کنید و سپس از یکی از گزینه های زیر استفاده کنید:

    • گزینه 1 : با وارد کردن نام پروژه جدید در اولین مرحله از گردش کار «ایجاد پروژه»، یک پروژه کاملاً جدید Firebase (و پروژه Google Cloud زیربنایی آن به صورت خودکار) ایجاد کنید.

    • گزینه 2 : «افزودن Firebase» به پروژه Google Cloud موجود با انتخاب نام پروژه Google Cloud خود از منوی کشویی در مرحله اول گردش کار «ایجاد پروژه».

    توجه داشته باشید که وقتی از شما خواسته شد، برای استفاده از Vertex AI در Firebase SDK نیازی به تنظیم Google Analytics ندارید .

  3. در کنسول Firebase ، به صفحه Build with Gemini بروید.

  4. روی Vertex AI در کارت Firebase کلیک کنید تا یک گردش کاری راه اندازی شود که به شما کمک می کند کارهای زیر را انجام دهید:

  1. برای اتصال برنامه خود به Firebase، که شامل این وظایف است، به گردش کار AI مولد کنسول ادامه دهید:

    • ثبت برنامه خود در پروژه Firebase

    • افزودن شی پیکربندی Firebase به برنامه شما.

  2. در مراحل بعدی این راهنما، Vertex AI در Firebase SDK را به برنامه خود اضافه می‌کنید و مقدار اولیه مورد نیاز برای استفاده از SDK و Gemini API را تکمیل می‌کنید.


مرحله 2 : SDK را اضافه کنید

با راه اندازی پروژه Firebase و اتصال برنامه به Firebase (مرحله قبل را ببینید)، اکنون می توانید Vertex AI در Firebase SDK را به برنامه خود اضافه کنید.

Vertex AI در کتابخانه Firebase دسترسی به API ها را برای تعامل با مدل های Gemini و Imagen فراهم می کند. این کتابخانه به عنوان بخشی از Firebase JavaScript SDK برای وب گنجانده شده است.

  1. Firebase JS SDK برای وب را با استفاده از npm نصب کنید:

      npm install firebase

  2. Firebase را در برنامه خود راه اندازی کنید:

      import { initializeApp } from "firebase/app";

  // TODO(developer) Replace the following with your app's Firebase configuration
  // See: https://firebase.google.com/docs/web/learn-more#config-object
  const firebaseConfig = {
    // ...
  };

  // Initialize FirebaseApp
  const firebaseApp = initializeApp(firebaseConfig);

مرحله 3 : سرویس Vertex AI و مدل مولد را راه اندازی کنید

قبل از اینکه بتوانید هر گونه تماس API برقرار کنید و مدل Gemini را درخواست کنید، باید سرویس Vertex AI و مدل تولیدی را مقداردهی اولیه کنید.

import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI service
const vertexAI = getVertexAI(firebaseApp);

// Initialize the generative model with a model that supports your use case
const model = getGenerativeModel(vertexAI, { model: "gemini-2.0-flash" });

پس از اتمام این راهنمای شروع، نحوه انتخاب مدل و (به صورت اختیاری) مکان مناسب برای مورد استفاده و برنامه خود را بیاموزید.

مرحله 4 : یک درخواست سریع به یک مدل ارسال کنید

اکنون که برنامه خود را به Firebase متصل کرده‌اید، SDK را اضافه کرده‌اید و سرویس Vertex AI و مدل تولیدی را راه‌اندازی کرده‌اید، آماده ارسال درخواست فوری به یک مدل Gemini هستید.

شما می توانید از generateContent() برای تولید متن از یک درخواست اعلان متنی استفاده کنید: 

import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI service
const vertexAI = getVertexAI(firebaseApp);

// Initialize the generative model with a model that supports your use case
const model = getGenerativeModel(vertexAI, { model: "gemini-2.0-flash" });

// Wrap in an async function so you can use await
async function run() {
  // Provide a prompt that contains text
  const prompt = "Write a story about a magic backpack."

  // To generate text output, call generateContent with the text input
  const result = await model.generateContent(prompt);

  const response = result.response;
  const text = response.text();
  console.log(text);
}

run();

چه کار دیگری می توانید انجام دهید؟

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

در مورد مدل های موجود برای موارد استفاده مختلف و سهمیه ها و قیمت آنها اطلاعات کسب کنید.

سایر قابلیت های Gemini API را امتحان کنید

یاد بگیرید چگونه تولید محتوا را کنترل کنید

همچنین می‌توانید با استفاده از Vertex AI Studio ، دستورات و پیکربندی‌های مدل را آزمایش کنید.


درباره تجربه خود با Vertex AI در Firebase بازخورد بدهید