Iniziare a utilizzare Genkit con Go (beta)

Questa guida mostra come iniziare a utilizzare Genkit in un'app Go.

Se riscontri problemi con le librerie o con questa documentazione, segnalali nel nostro repository GitHub.

Requisiti

Go 1.24 o versioni successive. Consulta la sezione Download e installazione della documentazione ufficiale di Go.
Node.js 20 o versioni successive (per l'interfaccia a riga di comando e l'interfaccia utente di Genkit). Consulta la sezione successiva per una breve guida all'installazione di Node.

Installa Genkit

Se non hai già Node 20 o versioni successive sul tuo sistema, installalo ora.

Consiglio: gli strumenti nvm e nvm-windows sono un modo pratico per installare versioni specifiche di Node se non è già installato sul tuo sistema. Questi strumenti installano Node su base utente, quindi non è necessario apportare modifiche a livello di sistema.

Per installare nvm:
Linux, macOS e così via
Esegui questo comando:
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
Windows
Scarica ed esegui il programma di installazione come descritto nella documentazione di nvm-windows.
Quindi, per installare Node e npm, apri una nuova shell ed esegui il seguente comando:
```
nvm install 20
```
Installa Genkit CLI eseguendo il seguente comando:
```
npm i -g genkit-cli
```
Questo comando installa il client Genkit nella directory di installazione di Node in modo che possa essere utilizzato al di fuori di un progetto Node.

Crea ed esplora un progetto di esempio

Crea una nuova directory del progetto:
```
mkdir genkit-intro && cd genkit-intro
```

Inizializza il modulo Go e ricevi il pacchetto Genkit:

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

Configura la chiave API del modello

In questa guida ti mostreremo come utilizzare l'API Gemini, che offre un generoso livello senza costi e non richiede una carta di credito per iniziare. Per utilizzare l'API Gemini, devi avere una chiave API. Se non ne hai già una, crea una chiave in Google AI Studio.

Dopo aver creato una chiave API, imposta la variabile di ambiente GEMINI_API_KEY sulla chiave con il comando seguente:

export GEMINI_API_KEY=<your API key>

Effettua la tua prima richiesta

Inizia a utilizzare Genkit con poche righe di codice.

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())
}

Passaggi successivi

Ora che hai configurato le richieste di modelli con Genkit, scopri come utilizzare altre funzionalità di Genkit per creare app e workflow basati sull'AI. Per iniziare a utilizzare le funzionalità aggiuntive di Genkit, consulta le guide seguenti:

Strumenti per sviluppatori: scopri come configurare e utilizzare l'interfaccia a riga di comando e la UI per sviluppatori di Genkit per testare ed eseguire il debug della tua app a livello locale.
Generazione di contenuti: scopri come utilizzare l'API di generazione unificata di Genkit per generare testo e dati strutturati da qualsiasi modello supportato.
Creazione di flussi: scopri come utilizzare funzioni Genkit speciali, denominate flussi, che forniscono l'osservabilità end-to-end per i workflow e un ricco debug dagli strumenti Genkit.
Gestire i prompt: scopri come Genkit ti consente di gestire i prompt e la configurazione insieme come codice.