Comienza a usar Genkit con Go

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

Si detectas problemas con las bibliotecas o con esta documentación, infórmalos en nuestro repositorio de GitHub.

Realiza tu primera solicitud

  1. Instala Go 1.24 o una versión posterior. Consulta Download and install en la documentación oficial de Go.

  2. Inicializa un nuevo directorio de proyecto de Go con el paquete de Genkit:

    mkdir genkit-intro && cd genkit-intro
go mod init example/genkit-intro
go get github.com/firebase/genkit/go

  3. Crea un archivo main.go con el siguiente código de muestra:

    package main

import (
    "context"
    "log"

    "github.com/firebase/genkit/go/ai"
    "github.com/firebase/genkit/go/genkit"
    "github.com/firebase/genkit/go/plugins/googlegenai"
)

func main() {
    ctx := context.Background()

    // Initialize Genkit with the Google AI plugin and Gemini 2.0 Flash.
    g, err := genkit.Init(ctx,
        genkit.WithPlugins(&googlegenai.GoogleAI{}),
        genkit.WithDefaultModel("googleai/gemini-2.0-flash"),
    )
    if err != nil {
        log.Fatalf("could not initialize Genkit: %w", err)
    }

    resp, err := genkit.Generate(ctx, g, ai.WithPrompt("What is the meaning of life?"))
    if err != nil {
        log.Fatal("could not generate model response: %w", err)
    }

    log.Println(resp.Text())
}

  4. Para configurar tu clave de API de Gemini, establece la variable de entorno GEMINI_API_KEY:

    export GEMINI_API_KEY=<your API key>

    Si aún no tienes una, créala en Google AI Studio. La IA de Google ofrece un nivel generoso sin costo y no requiere una tarjeta de crédito para comenzar.

  5. Ejecuta la app para ver la respuesta del modelo:

    go run .
There is no single universally agreed-upon meaning of life; it's a deeply
personal question. Many find meaning through connection, growth,
contribution, happiness, or discovering their own purpose.

Próximos pasos

Ahora que ya puedes hacer solicitudes de modelos con Genkit, aprende a usar más capacidades de Genkit para compilar tus apps y flujos de trabajo potenciados por IA. Para comenzar a usar las capacidades 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 de forma local tu app.
  • Generar contenido: Aprende a usar la API de generación unificada de Genkit para generar texto y datos estructurados de cualquier modelo compatible.
  • Creación de flujos: Aprende a usar las funciones especiales de Genkit, llamadas flujos, que proporcionan la capacidad de observabilidad de extremo a extremo para los flujos de trabajo y la depuración completa de las herramientas de Genkit.
  • Administrar instrucciones: Descubre cómo Genkit te ayuda a administrar tus instrucciones y configuración como código.