Começar a usar o Genkit no Go (beta)

Este guia mostra como começar a usar o Genkit em um app Go.

Se você encontrar problemas com as bibliotecas ou com esta documentação, informe no nosso repositório do GitHub.

Requisitos

  • Go 1.24 ou mais recente. Consulte Fazer o download e instalar nos documentos oficiais do Go.

  • Node.js 20 ou mais recente (para a CLI e a interface do Genkit). Consulte a próxima seção para o guia rápido sobre a instalação do Node.

Instalar o Genkit

  1. Se você ainda não tem o Node 20 ou a versão mais recente no sistema, instale-o agora.

    Recomendação: as APIs nvm e as ferramentas do nvm-windows são uma maneira conveniente de instalar versões específicas do Node se ainda não estiver instalado em seu sistema. Essas ferramentas instalam o Node por usuário, então você não precisa fazer alterações em todo o sistema.

    Para instalar nvm:

    Linux, macOS etc.

    Execute este comando:

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    Windows

    Faça o download e execute o instalador conforme descrito nos documentos do nvm-windows.

    Em seguida, para instalar o nó e npm, abra um novo shell e execute o seguinte comando:

    nvm install 20

  2. Instale a CLI do Genkit executando o seguinte comando:

    npm i -g genkit-cli

    Esse comando instala a CLI do Genkit no diretório de instalação do nó para que possa ser usado fora de um projeto Node.

Criar e analisar um projeto de amostra

  1. Crie um novo diretório do projeto:

    mkdir genkit-intro && cd genkit-intro

  2. Inicialize o módulo Go e receba o pacote do Genkit:

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

Configure a chave de API do modelo

Neste guia, vamos mostrar como usar a API Gemini, que oferece um nível sem custo financeiro e não exige um cartão de crédito para começar. Para usar a API Gemini, você precisará de uma chave de API. Se ainda não tiver, crie uma no Google AI Studio.

Depois de criar uma chave de API, defina a variável de ambiente GEMINI_API_KEY para sua chave com o comando a seguir:

export GEMINI_API_KEY=<your API key>

Faça sua primeira solicitação

Comece a usar o Genkit com apenas algumas linhas de código.

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 a Genkit instance.
    g, err := genkit.Init(ctx,
        // Install the Google AI plugin which provides Gemini models.
        genkit.WithPlugins(&googlegenai.GoogleAI{}),
        // Set the default model to use for generate calls.
        genkit.WithDefaultModel("googleai/gemini-2.0-flash"),
    )
    if err != nil {
        log.Fatal(err)
    }

    // Generate a model response.
    resp, err := genkit.Generate(ctx, g, ai.WithPrompt("Hello, Gemini!"))
    if err != nil {
        log.Fatal(err)
    }

    log.Println(resp.Text())
}

Próximas etapas

Agora que está tudo pronto para fazer solicitações de modelo com o Genkit, saiba como usar mais recursos para criar seus apps e fluxos de trabalho com tecnologia de IA. Para começar a usar outros recursos do Genkit, consulte estes guias:

  • Ferramentas para desenvolvedores: saiba como configurar e usar a CLI e a interface de desenvolvedor do Genkit para testar e depurar seu app.
  • Geração de conteúdo: aprenda a usar a API de geração unificada do Genkit para gerar texto e dados estruturados de qualquer modelo com suporte.
  • Criação de fluxos: saiba como usar funções especiais do Genkit, chamadas de flows, que fornecem observabilidade de ponta a ponta para fluxos de trabalho e depuração rica com as ferramentas do Genkit.
  • Gerenciamento de comandos: saiba como o Genkit ajuda a gerenciar os comandos e a configuração em conjunto como código.