Comenzar

En esta guía, se muestra cómo comenzar a usar Genkit en una app de Node.js.

Requisitos previos

En esta guía, se da por sentado que conoces la compilación de aplicaciones con Node.js.

Para completar esta guía de inicio rápido, asegúrate de que tu entorno de desarrollo cumpla con los siguientes requisitos:

  • Node.js v20 o versiones posteriores
  • npm

Instala las dependencias de Genkit

Instala las siguientes dependencias de Genkit para usar Genkit en tu proyecto:

  • @genkit-ai/ai y @genkit-ai/core proporcionan las funciones principales de Genkit.
  • @genkit-ai/googleai proporciona acceso a los modelos de Gemini de la IA de Google.
  • genkit proporciona la CLI y las herramientas de Genkit para ayudarte a probar y depurar tu solución más adelante.
npm install @genkit-ai/ai @genkit-ai/core @genkit-ai/googleai
npm install -g genkit

Configura la clave de API de tu modelo

En esta guía, te mostraremos cómo usar la API de Gemini, que ofrece un generoso nivel gratuito y no requiere una tarjeta de crédito para comenzar. Para usar la API de Gemini, necesitarás una clave de API. Si aún no tienes una, crea una clave en Google AI Studio.

Obtén una clave de API de Google AI Studio

Después de crear una clave de API, configura la variable de entorno GOOGLE_GENAI_API_KEY para tu clave con el siguiente comando:

export GOOGLE_GENAI_API_KEY=<your API key>

Cómo importar la biblioteca

Importa las bibliotecas principales de Genkit y el complemento para las APIs de Gemini de IA de Google.

import { generate } from '@genkit-ai/ai';
import { configureGenkit } from '@genkit-ai/core';
import { googleAI, gemini15Flash } from '@genkit-ai/googleai';

Realiza tu primera solicitud

Usa el método generate para generar una respuesta de texto.

configureGenkit({ plugins: [googleAI()] });

const result = await generate({
    model: gemini15Flash,
    prompt: 'Tell me a heroic story about a software developer.',
});

console.log(result.text())

Próximos pasos

Ahora que tienes todo listo para realizar solicitudes de modelos con Genkit, aprende a usar más funciones de Genkit para crear tus apps y flujos de trabajo impulsados por IA. Para comenzar a usar funciones adicionales de Genkit, consulta las siguientes guías:

  • Herramientas para desarrolladores: Aprende a configurar y usar la CLI y la IU para desarrolladores de Genkit para probar y depurar tu app de forma local.
  • Generación de contenido: Aprende a usar la API de generación unificada de Genkit para generar texto y datos estructurados a partir de cualquier modelo compatible.
  • Crea flujos: Aprende a usar las funciones especiales de Genkit, llamadas flujos, que proporcionan observabilidad de extremo a extremo para los flujos de trabajo y depuraciones enriquecidas de las herramientas de Genkit.
  • Modelos de instrucciones: Descubre cómo Genkit te permite tratar las plantillas de instrucciones como funciones, encapsulando las configuraciones del modelo y el esquema de entrada y salida.