Agent d'étude de marché avec Gemini et le SDK AI de Vercel

Le SDK AI de Vercel est une puissante bibliothèque Open Source permettant de créer des applications, des interfaces utilisateur et des agents optimisés par l'IA en TypeScript.

Ce guide vous explique comment créer une application Node.js avec TypeScript qui utilise le SDK IA pour se connecter à l'API Gemini via le fournisseur Google IA générative et effectuer une analyse automatisée des tendances du marché. L'application finale :

  1. Utilisez Gemini avec la recherche Google pour étudier les tendances actuelles du marché.
  2. Extrayez les données structurées de la recherche pour générer des graphiques.
  3. Combinez les recherches et les graphiques dans un rapport HTML professionnel, puis enregistrez-le au format PDF.

Prérequis

Pour suivre ce guide, vous aurez besoin des éléments suivants :

  • Une clé API Gemini. Vous pouvez en créer une sans frais dans Google AI Studio.
  • Node.js version 18 ou ultérieure.
  • Un gestionnaire de paquets, tel que npm, pnpm ou yarn.

Configurer votre application

Commencez par créer un répertoire pour votre projet et initialisez-le.

npm

mkdir market-trend-app
cd market-trend-app
npm init -y

pnpm

mkdir market-trend-app
cd market-trend-app
pnpm init

fil

mkdir market-trend-app
cd market-trend-app
yarn init -y

Installer des dépendances

Ensuite, installez le SDK IA, le fournisseur Google IA générative et les autres dépendances nécessaires.

npm

npm install ai @ai-sdk/google zod
npm install -D @types/node tsx typescript && npx tsc --init

Pour éviter une erreur du compilateur TypeScript, mettez en commentaire la ligne suivante dans le fichier tsconfig.json généré :

//"verbatimModuleSyntax": true,

pnpm

pnpm add ai @ai-sdk/google zod
pnpm add -D @types/node tsx typescript

fil

yarn add ai @ai-sdk/google zod
yarn add -D @types/node tsx typescript && yarn tsc --init

Pour éviter une erreur du compilateur TypeScript, mettez en commentaire la ligne suivante dans le fichier tsconfig.json généré :

//"verbatimModuleSyntax": true,

Cette application utilisera également les packages tiers Puppeteer et Chart.js pour afficher les graphiques et créer un PDF :

npm

npm install puppeteer chart.js
npm install -D @types/chart.js

pnpm

pnpm add puppeteer chart.js
pnpm add -D @types/chart.js

fil

yarn add puppeteer chart.js
yarn add -D @types/chart.js

Le package puppeteer nécessite l'exécution d'un script pour télécharger le navigateur Chromium. Votre gestionnaire de packages peut vous demander votre approbation. Assurez-vous donc d'approuver le script lorsque vous y êtes invité.

Configurer votre clé API

Définissez la variable d'environnement GOOGLE_GENERATIVE_AI_API_KEY avec votre clé API Gemini. Le fournisseur d'IA générative de Google recherche automatiquement votre clé API dans cette variable d'environnement.

macOS/Linux

export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE"

Powershell

setx GOOGLE_GENERATIVE_AI_API_KEY "YOUR_API_KEY_HERE"

Créer votre application

Créons maintenant le fichier principal de notre application. Créez un fichier nommé main.ts dans le répertoire de votre projet. Vous allez créer la logique de ce fichier étape par étape.

Pour effectuer un test rapide et vous assurer que tout est correctement configuré, ajoutez le code suivant à main.ts. Cet exemple de base utilise generateText pour obtenir une réponse simple de Gemini.

import { google } from "@ai-sdk/google";
import { generateText } from "ai";

async function main() {
  const { text } = await generateText({
    model: google("gemini-3.7-flash"),
    prompt: 'What is plant-based milk?',
  });

  console.log(text);
}

main().catch(console.