Premiers pas avec Genkit à l'aide de Go (bêta)

Ce guide vous explique comment commencer à utiliser Genkit dans une application Go.

Si vous découvrez des problèmes avec les bibliothèques ou cette documentation, veuillez les signaler dans notre dépôt GitHub.

Conditions requises

Go 1.24 ou version ultérieure. Consultez la section Télécharger et installer dans la documentation officielle de Go.
Node.js 20 ou version ultérieure (pour la CLI et l'UI Genkit) Consultez la section suivante pour obtenir un bref guide d'installation de Node.

Installer Genkit

Si Node 20 ou une version ultérieure n'est pas déjà installé sur votre système, installez-le maintenant.

Recommandation: Les outils nvm et nvm-windows sont un moyen pratique d'installer des versions spécifiques de Node s'il n'est pas déjà installé sur votre système. Ces outils installent Node par utilisateur. Vous n'avez donc pas besoin d'apporter de modifications à l'échelle du système.

Pour installer nvm, procédez comme suit :
Linux, macOS, etc.
Exécutez la commande suivante :
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
Windows
Téléchargez et exécutez le programme d'installation comme décrit dans la documentation nvm-windows.
Pour installer Node et npm, ouvrez un nouveau shell et exécutez la commande suivante:
```
nvm install 20
```
Installez la CLI Genkit en exécutant la commande suivante:
```
npm i -g genkit-cli
```
Cette commande installe la CLI Genkit dans votre répertoire d'installation Node afin qu'elle puisse être utilisée en dehors d'un projet Node.

Créer et explorer un exemple de projet

Créez un répertoire de projet:
```
mkdir genkit-intro && cd genkit-intro
```

Initialisez le module Go et obtenez le package Genkit:

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

Configurer la clé API de votre modèle

Dans ce guide, nous allons vous montrer comment utiliser l'API Gemini, qui propose un niveau sans frais généreux et ne nécessite pas de carte de crédit pour commencer. Pour utiliser l'API Gemini, vous avez besoin d'une clé API. Si vous n'en avez pas encore, créez-en une dans Google AI Studio.

Une fois que vous avez créé une clé API, définissez la variable d'environnement GEMINI_API_KEY sur votre clé à l'aide de la commande suivante:

export GEMINI_API_KEY=<your API key>

Créer votre première requête

Commencez à utiliser Genkit avec quelques lignes de code.

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

Étapes suivantes

Maintenant que vous êtes prêt à envoyer des requêtes aux modèles avec Genkit, découvrez comment utiliser d'autres fonctionnalités de Genkit pour créer vos applications et workflows optimisés par l'IA. Pour commencer à utiliser d'autres fonctionnalités Genkit, consultez les guides suivants:

Outils pour les développeurs: découvrez comment configurer et utiliser la CLI et l'UI pour les développeurs de Genkit pour tester et déboguer votre application en local.
Générer du contenu: découvrez comment utiliser l'API de génération unifiée de Genkit pour générer du texte et des données structurées à partir de n'importe quel modèle compatible.
Créer des flows: découvrez comment utiliser des fonctions Genkit spéciales, appelées flows, qui offrent une observabilité de bout en bout pour les workflows et permettent un débogage avancé à l'aide des outils Genkit.
Gérer les requêtes: découvrez comment Genkit vous aide à gérer vos requêtes et votre configuration conjointement en tant que code.