En esta guía, se muestra cómo comenzar a realizar llamadas a Vertex AI Gemini API directamente desde tu app con el SDK de Vertex AI in Firebase para la plataforma que elijas.
Requisitos previos
En esta guía, se da por sentado que conoces el uso de Xcode para desarrollar apps para 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 posterior
- Tu app debe orientarse a iOS 15 o una versión posterior, o macOS 12 o una versión posterior.
(Opcional) Consulta 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 de Firebase y una app conectada a Firebase
En la consola de Firebase, ve a la página Crear con Gemini.
Haz clic en la tarjeta Vertex AI in Firebase para iniciar un flujo de trabajo que te ayude a completar las siguientes tareas:
Actualiza tu proyecto para usar el plan de precios de pago por uso de Blaze.
Habilita las APIs necesarias en tu proyecto (API de Vertex AI y API de Vertex AI in Firebase).
Continúa con el siguiente paso de esta guía para agregar el SDK a tu app.
Si no tienes un proyecto de Firebase ni una app conectada a Firebase
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.
Usa Swift Package Manager para instalar y administrar las dependencias de Firebase.
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
).
En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.
Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:
https://github.com/firebase/firebase-ios-sdk
Selecciona la versión más reciente del SDK.
Selecciona la biblioteca de
FirebaseVertexAI
.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 poder realizar llamadas a la API, debes inicializar el servicio de Vertex AI y el modelo generativo.
Importa el módulo
FirebaseVertexAI
:import FirebaseVertexAI
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 termines la guía de introducción, aprende a elegir un modelo de Gemini y, de manera opcional, una ubicación adecuada para tu caso de uso y app.
Paso 4: Llama a Vertex AI Gemini API
Ahora que conectaste tu app a Firebase, agregaste el SDK y inicializaste el servicio Vertex AI y el modelo generativo, está todo listo para 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)
print(response.text ?? "No text in response.")
¿Qué más puedes hacer?
Más información sobre los modelos de Gemini
Obtén información sobre los modelos disponibles para varios casos de uso y sus cuotas y precios.
Prueba otras funciones de Gemini API
- Obtén más información para generar texto a partir de instrucciones de solo texto, lo que incluye cómo transmitir la respuesta.
- Genera texto a partir de instrucciones multimodales (incluidos texto, imágenes, PDF, video y audio).
- Crea conversaciones de varios turnos (chat).
- Genera resultados estructurados (como JSON) a partir de instrucciones multimodales y de texto.
- Usa las llamadas a funciones para conectar los modelos generativos a sistemas y datos externos.
Aprende a controlar la generación de contenido
- Comprende el diseño de instrucciones, incluidas las prácticas recomendadas, las estrategias y los ejemplos de instrucciones.
- Configura los parámetros del modelo, como la temperatura y la cantidad máxima de tokens de salida.
- Usa la configuración de seguridad para ajustar la probabilidad de recibir respuestas que se puedan considerar dañinas.
Envía comentarios sobre tu experiencia con Vertex AI in Firebase