Começar a usar o Genkit em Go

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.

Faça sua primeira solicitação

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

  2. Inicialize um novo diretório de projeto Go com o pacote Genkit:

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

  3. Crie um arquivo main.go com o seguinte conteúdo:

    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. Configure a chave de API Gemini definindo a variável de ambiente GEMINI_API_KEY:

    export GEMINI_API_KEY=<your API key>

    Se ainda não tiver, crie uma chave no Google AI Studio. A IA do Google oferece um nível sem custo financeiro generoso e não exige um cartão de crédito para começar.

  5. Execute o app para conferir a resposta do 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ó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.