Premiers pas

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

Prérequis

Ce guide part du principe que vous savez créer des applications avec Node.js.

Pour suivre ce guide de démarrage rapide, assurez-vous que votre environnement de développement répond aux exigences suivantes :

  • Node.js v20 ou version ultérieure
  • npm

Installer les dépendances Genkit

Installez les dépendances Genkit suivantes pour utiliser Genkit dans votre projet :

  • @genkit-ai/ai et @genkit-ai/core fournissent les fonctionnalités de base de Genkit.
  • @genkit-ai/googleai : permet d'accéder aux modèles Gemini d'IA de Google.
  • genkit fournit la CLI Genkit et les outils nécessaires pour vous aider à tester et déboguer votre solution par la suite.
npm install @genkit-ai/ai @genkit-ai/core @genkit-ai/googleai
npm install -g genkit

Configurer la clé API de votre modèle

Dans ce guide, nous allons vous montrer comment utiliser l'API Gemini, qui propose un niveau gratuit 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 ne l'avez pas encore fait, créez une clé dans Google AI Studio.

Obtenir une clé API depuis Google AI Studio

Après avoir créé une clé API, définissez la variable d'environnement GOOGLE_GENAI_API_KEY sur votre clé à l'aide de la commande suivante :

export GOOGLE_GENAI_API_KEY=<your API key>

Importer la bibliothèque

Importez les bibliothèques principales Genkit et le plug-in pour les API Google AI Gemini.

import { generate } from '@genkit-ai/ai';
import { configureGenkit } from '@genkit-ai/core';
import { googleAI, gemini15Flash } from '@genkit-ai/googleai';

Faites votre première demande

Utilisez la méthode generate pour générer une réponse textuelle.

configureGenkit({ plugins: [googleAI()] });

const result = await generate({
    model: gemini15Flash,
    prompt: 'Tell me a heroic story about a software developer.',
});

console.log(result.text())

Étapes suivantes

Maintenant que vous êtes prêt à envoyer des requêtes de modèle 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 les fonctionnalités supplémentaires de Genkit, consultez les guides suivants:

  • Outils pour les développeurs: découvrez comment configurer et utiliser la CLI et l'interface utilisateur de Genkit pour vous aider à 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 flux : découvrez comment utiliser des fonctions Genkit spéciales, appelées flux, qui offrent une observabilité de bout en bout pour les workflows et un débogage avancé à partir des outils Genkit.
  • Modèles de requêtes: découvrez comment Genkit vous permet de traiter les modèles de requêtes comme des fonctions, en encapsulant les configurations de modèle et le schéma d'entrée/sortie.