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 :
- Utilisez Gemini avec la recherche Google pour étudier les tendances actuelles du marché.
- Extrayez les données structurées de la recherche pour générer des graphiques.
- 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,pnpmouyarn.
Configurer votre application
Commencez par créer un répertoire pour votre projet et initialisez-le.
npm
mkdir market-trend-appcd market-trend-appnpm init -y
pnpm
mkdir market-trend-appcd market-trend-apppnpm init
fil
mkdir market-trend-appcd market-trend-appyarn 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 zodnpm 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 zodpnpm add -D @types/node tsx typescript
fil
yarn add ai @ai-sdk/google zodyarn 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.jsnpm install -D @types/chart.js
pnpm
pnpm add puppeteer chart.jspnpm add -D @types/chart.js
fil
yarn add puppeteer chart.jsyarn 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.