Comienza a usar la API de Gemini con los SDK de Vertex AI en Firebase


En esta guía, se muestra cómo comenzar a realizar llamadas al Vertex AI Gemini API directamente desde tu app con el SDK de Vertex AI in Firebase para la plataforma que elegiste.

Requisitos previos

En esta guía, se asume que estás familiarizado con el uso de Xcode para desarrollar apps de Plataformas de Apple (como iOS)

  • Asegúrate de que tu entorno de desarrollo y la app para plataformas de Apple cumplan con los siguientes requisitos:

    • Xcode 15.0 o una versión más reciente
    • Tu app debe orientarse a iOS 15 o versiones posteriores, o macOS 12 o versiones posteriores.
  • (Opcional) Consulta la app de ejemplo.

    Descarga la app de ejemplo

    Puedes probar el SDK rápidamente, ver una implementación completa de varios casos de uso o usar la app de ejemplo si no tienes tu propia app para plataformas de Apple. Para usar la app de ejemplo, deberás conectarla a un proyecto de Firebase.

Paso 1: Configura un proyecto de Firebase y conecta tu app a Firebase

Si ya tienes un proyecto y una app de Firebase conectados a Firebase

  1. En la consola de Firebase, ve a Página de Crea con Gemini.

  2. Haz clic en la tarjeta Vertex AI in Firebase para iniciar un flujo de trabajo que te ayude completa las siguientes tareas. (Ten en cuenta que, si ves una pestaña en la consola para Vertex AI, significa que estas tareas están completas).

  3. Continúa con el siguiente paso de esta guía para agregar el SDK a tu app.

Si aún no tienes un proyecto y una app de Firebase conectados a esta plataforma


Paso 2: Agrega el SDK

Con tu proyecto de Firebase configurado y tu app conectada a Firebase (consulta el paso anterior), ahora puedes agregar el SDK de Vertex AI in Firebase a tu app.

La biblioteca Vertex AI in Firebase proporciona acceso a Vertex AI Gemini API y se incluye como parte del SDK de Firebase para plataformas de Apple (firebase-ios-sdk). Para la biblioteca Vertex AI in Firebase, debes usar Swift Package Manager para instalar y administrar las dependencias de Firebase. Por el momento, no están disponibles otros administradores de paquetes, como CocoaPods. no es compatible.

  1. En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.

  2. Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:

      https://github.com/firebase/firebase-ios-sdk
    
  3. Selecciona la versión más reciente del SDK.

  4. Selecciona la biblioteca FirebaseVertexAI-Preview.

    Cuando termines, Xcode comenzará a resolver y descargar automáticamente tus dependencias en segundo plano.

Paso 3: Inicializa el servicio Vertex AI y el modelo generativo

Antes de realizar llamadas a la API, debes inicializar Vertex AI. y el modelo generativo.

  1. Importa el módulo FirebaseVertexAI:

    import FirebaseVertexAI
    
  2. Inicializa el servicio Vertex AI y el modelo generativo:

    import FirebaseVertexAI
    
    // Initialize the Vertex AI service
    let vertex = VertexAI.vertexAI()
    
    // Initialize the generative model with a model that supports your use case
    // Gemini 1.5 models are versatile and can be used with all API capabilities
    let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
    

Cuando hayas terminado la guía de introducción, aprende a elegir Modelo de Gemini y, de forma opcional, un la ubicación adecuada para tu caso de uso y app.

Paso 4: Llama al Vertex AI Gemini API

Ahora que conectaste tu app a Firebase, agregaste el SDK y, luego, inicializaste el servicio de Vertex AI y el modelo generativo, ya puedes llamar a Vertex AI Gemini API.

Puedes usar generateContent() para generar texto a partir de una solicitud de instrucción solo de texto:

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

¿Qué más puedes hacer?

Más información sobre los modelos de Gemini

Obtén más información acerca de la modelos disponibles para varios casos de uso y sus cuotas y precios.

Prueba otras funciones de Gemini API

Aprende a controlar la generación de contenido

También puedes experimentar con instrucciones y configuraciones de modelos usando Vertex AI Studio


Envía comentarios sobre tu experiencia con Vertex AI in Firebase