Usa la API de Gemini para las llamadas a funciones


Las llamadas a función facilitan la obtención de resultados de datos estructurados desde generativos. Luego, puedes usar estos resultados para llamar a otras APIs y mostrar los datos de respuesta relevantes al modelo. En otras palabras, las llamadas a función te ayudan a conectar modelos generativos a sistemas externos para que el contenido generado incluya la información más actualizada y precisa.

Puedes proporcionarles descripciones de funciones a los modelos de Gemini. Estas son funciones que escribes en el lenguaje de tu app (es decir, no son Cloud Functions). Es posible que el modelo te solicite que llames a una función y le envíes el resultado para ayudar al modelo a controlar tu consulta.

Puedes obtener más información sobre las llamadas a función en la documentación de Google Cloud.

Antes de comenzar

Si aún no lo hiciste, completa la guía de introducción a los SDK de Vertex AI in Firebase. Asegúrate de haber hecho lo siguiente:

  1. Configura un proyecto de Firebase nuevo o existente, incluido el uso del plan de precios Blaze y la habilitación de las APIs requeridas.

  2. Conecta tu app a Firebase, lo que incluye registrarla y agregar la configuración de Firebase a ella.

  3. Agrega el SDK y, luego, inicializa el servicio de Vertex AI y el modelo generativo en tu app.

Después de conectar la app a Firebase, agregar el SDK e inicializar la el servicio de Vertex AI y el modelo generativo, ya puedes llamar a Gemini API.

Configura una llamada a función

En este instructivo, harás que el modelo interactúe con una moneda hipotética Exchange que admite los siguientes parámetros:

Parámetro Tipo Obligatorio Descripción
currencyFrom string sí Moneda de la que quiere convertir
currencyTo string sí Moneda a la que se realizará la conversión

Ejemplo de solicitud a la API

{
  "currencyFrom": "USD",
  "currencyTo": "SEK"
}

Ejemplo de respuesta de la API

{
  "base": "USD",
  "rates": {"SEK": 10.99}
}

Paso 1: Crea la función que realiza la solicitud a la API

Si aún no lo hiciste, comienza por crear la función que realiza una solicitud a la API.

Para fines de demostración en este instructivo, en lugar de enviar una API real devolverás valores codificados en el mismo formato que una solicitud que volvería a aparecer la API.

Paso 2: Crea una declaración de función

Crea la declaración de función que pasarás al modelo generativo. (paso siguiente de este instructivo).

Incluye tantos detalles como sea posible en las descripciones de las funciones y los parámetros. El modelo generativo usa esta información para determinar qué función seleccionar y cómo proporcionar valores para los parámetros en la llamada a función.

Paso 3: Especifica la declaración de la función durante la inicialización del modelo

Especifica la declaración de la función cuando inicialices el modelo generativo. Para ello, establece el parámetro tools del modelo:

Descubre cómo elegir un modelo de Gemini y, opcionalmente, una ubicación adecuados para tu caso de uso y app.

Paso 4: Genera una llamada a función

Ahora puedes indicarle al modelo la función definida.

La forma recomendada de usar las llamadas a función es a través de la interfaz de chat, ya que estas se adaptan perfectamente a la estructura de varios turnos del chat.

¿Qué más puedes hacer?

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

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.


Enviar comentarios sobre tu experiencia con Vertex AI in Firebase