Das AI SDK von Vercel ist eine leistungsstarke Open-Source-Bibliothek zum Erstellen von KI-gestützten Anwendungen, Benutzeroberflächen und Agenten in TypeScript.
In dieser Anleitung erfahren Sie, wie Sie eine Node.js-Anwendung mit TypeScript erstellen, die das KI SDK verwendet, um über den Google Generative AI Provider eine Verbindung zur Gemini API herzustellen und automatisierte Markttrendanalysen durchzuführen. Die fertige Anwendung kann Folgendes:
- Gemini mit der Google Suche verwenden, um aktuelle Markttrends zu recherchieren.
- Strukturierte Daten aus der Recherche extrahieren, um Diagramme zu erstellen.
- Die Recherche und die Diagramme in einem professionellen HTML-Bericht zusammenfassen und als PDF speichern.
Vorbereitung
Für diese Anleitung benötigen Sie Folgendes:
- Einen Gemini API-Schlüssel. Sie können ihn kostenlos in Google AI Studio erstellen.
- Node.js, Version 18 oder höher.
- Einen Paketmanager wie
npm,pnpm, oderyarn.
Anwendung einrichten
Erstellen Sie zuerst ein neues Verzeichnis für Ihr Projekt und initialisieren Sie es.
npm
mkdir market-trend-appcd market-trend-appnpm init -y
pnpm
mkdir market-trend-appcd market-trend-apppnpm init
yarn
mkdir market-trend-appcd market-trend-appyarn init -y
Abhängigkeiten installieren
Installieren Sie als Nächstes das AI SDK, den Google Generative AI Provider und andere erforderliche Abhängigkeiten.
npm
npm install ai @ai-sdk/google zodnpm install -D @types/node tsx typescript && npx tsc --init
Um einen TypeScript-Compilerfehler zu vermeiden, kommentieren Sie die folgende Zeile in der generierten tsconfig.json aus:
//"verbatimModuleSyntax": true,
pnpm
pnpm add ai @ai-sdk/google zodpnpm add -D @types/node tsx typescript
yarn
yarn add ai @ai-sdk/google zodyarn add -D @types/node tsx typescript && yarn tsc --init
Um einen TypeScript-Compilerfehler zu vermeiden, kommentieren Sie die folgende Zeile in der generierten tsconfig.json aus:
//"verbatimModuleSyntax": true,
Diese Anwendung verwendet auch die Drittanbieterpakete Puppeteer und Chart.js zum Rendern von Diagrammen und zum Erstellen einer PDF-Datei:
npm
npm install puppeteer chart.jsnpm install -D @types/chart.js
pnpm
pnpm add puppeteer chart.jspnpm add -D @types/chart.js
yarn
yarn add puppeteer chart.jsyarn add -D @types/chart.js
Für das Paket puppeteer muss ein Skript ausgeführt werden, um den Chromium-Browser herunterzuladen. Ihr Paketmanager fordert möglicherweise eine Genehmigung an. Genehmigen Sie das Skript, wenn Sie dazu aufgefordert werden.
API-Schlüssel konfigurieren
Legen Sie die Umgebungsvariable GOOGLE_GENERATIVE_AI_API_KEY mit Ihrem Gemini API-Schlüssel fest. Der Google Generative AI Provider sucht automatisch in dieser Umgebungsvariable nach Ihrem API-Schlüssel.
macOS/Linux
export GOOGLE_GENERATIVE_AI_API_KEY="YOUR_API_KEY_HERE"Powershell
setx GOOGLE_GENERATIVE_AI_API_KEY "YOUR_API_KEY_HERE"Anwendung erstellen
Erstellen wir nun die Hauptdatei für unsere Anwendung. Erstellen Sie in Ihrem Projektverzeichnis eine neue Datei mit dem Namen main.ts. Die Logik wird in dieser Datei Schritt für Schritt aufgebaut.
Fügen Sie der Datei main.ts den folgenden Code hinzu, um zu prüfen, ob alles richtig eingerichtet ist. In diesem einfachen Beispiel wird generateText verwendet, um eine einfache Antwort von Gemini zu erhalten.
import { google } from "@ai-sdk/google";
import { generateText } from "ai";
async function main() {
const { text } = await generateText({
model: google("gemini-3-flash-preview"),
prompt: 'What is plant-based milk?',
});
console.log(text);
}
main().catch(console.error);
Bevor Sie weitere Komplexität hinzufügen, führen Sie dieses Skript aus, um zu prüfen, ob Ihre Umgebung richtig konfiguriert ist. Führen Sie in Ihrem Terminal den folgenden Befehl aus:
npm
npx tsc && node main.jspnpm
pnpm tsx main.tsyarn
yarn tsc && node main.jsWenn alles richtig eingerichtet ist, wird die Antwort von Gemini in der Konsole ausgegeben.
Marktforschung mit der Google Suche durchführen
Wenn Sie aktuelle Informationen erhalten möchten, können Sie das Google Suche-Tool für Gemini aktivieren. Wenn dieses Tool aktiv ist, kann das Modell im Web nach Antworten auf den Prompt suchen und gibt die verwendeten Quellen zurück.
Ersetzen Sie den Inhalt von main.ts durch den folgenden Code, um den ersten Schritt unserer Analyse auszuführen.
import { google } from "@ai-sdk/google";
import { generateText } from "ai";
async function main() {
// Step 1: Search market trends
const { text: marketTrends, sources } = await generateText({
model: google("gemini-3-flash-preview"),
tools: {
google_search: google.tools.googleSearch({}),
},
prompt: `Search the web for market trends for plant-based milk in North America for 2024-2025.
I need to know the market size, key players and their market share, and primary consumer drivers.
`,
});
console.log("Market trends found:\n", marketTrends);
// To see the sources, uncomment the following line:
// console.log("Sources:\n", sources);
}
main().catch(console.error);
Diagrammdaten extrahieren
Als Nächstes verarbeiten wir den Recherchetext, um strukturierte Daten zu extrahieren, die für Diagramme geeignet sind. Verwenden Sie die Funktion generateObject des AI SDK zusammen mit einem zod-Schema, um die genaue Datenstruktur zu definieren.
Erstellen Sie außerdem eine Hilfsfunktion, um diese strukturierten Daten in eine Konfiguration zu konvertieren, die Chart.js verstehen kann.
Fügen Sie der Datei main.ts den folgenden Code hinzu. Beachten Sie die neuen Importe und den hinzugefügten Schritt 2.
import { google } from "@ai-sdk/google";
import { generateText, generateObject } from "ai";
import { z } from "zod/v4";
import { ChartConfiguration } from "chart.js";
// Helper function to create Chart.js configurations
function createChartConfig({labels, data, label, type, colors,}: {
labels: string[];
data: number[];
label: string;
type: "bar" | "line";
colors: string[];
}): ChartConfiguration {
return {
type: type,
data: {
labels: labels,
datasets: [
{
label: label,
data: data,
borderWidth: 1,
...(type === "bar" && { backgroundColor: colors }),
...(type === "line" && colors.length > 0 && { borderColor: colors[0] }),
},
],
},
options: {
animation: { duration: 0 }, // Disable animations for static PDF rendering
},
};
}
async function main() {
// Step 1: Search market trends
const { text: marketTrends, sources } = await generateText({
model: google("gemini-3-flash-preview"),
tools: {
google_search: google.tools.googleSearch({}),
},
prompt: `Search the web for market trends for plant-based milk in North America for 2024-2025.
I need to know the market size, key players and their market share, and primary consumer drivers.
`,
});
console.log("Market trends found.");
// Step 2: Extract chart data
const { object: chartData } = await generateObject({
model: google("gemini-3-flash-preview"),
schema: z.object({
chartConfigurations: z
.array(
z.object({
type: z.enum(["bar", "line"]).describe('The type of chart to generate. Either "bar" or "line"',),
labels: z.array(z.string()).describe("A list of chart labels"),
data: z.array(z.number()).describe("A list of the chart data"),
label: z.string().describe("A label for the chart"),
colors: z.array(z.string()).describe('A list of colors to use for the chart, e.g. "rgba(255, 99, 132, 0.8)"',),
}),
)
.describe("A list of chart configurations"),
}),
prompt: `Given the following market trends text, come up with a list of 1-3 meaningful bar or line charts
and generate chart data.
Market Trends:
${marketTrends}
`,
});
const chartConfigs = chartData.chartConfigurations.map(createChartConfig);
console.log("Chart configurations generated.");
}
main().catch(console.error);
Abschlussbericht erstellen
Im letzten Schritt weisen Sie Gemini an, als Experte für das Verfassen von Berichten zu fungieren. Geben Sie die Marktforschung, die Diagrammkonfigurationen und eine klare Anleitung zum Erstellen eines HTML-Berichts an. Verwenden Sie dann Puppeteer, um diesen HTML-Code zu rendern und als PDF zu speichern.
Fügen Sie den letzten puppeteer-Import und Schritt 3 der Datei main.ts hinzu.
// ... (imports from previous step)
import puppeteer from "puppeteer";
// ... (createChartConfig helper function from previous step)
async function main() {
// ... (Step 1 and 2 from previous step)
// Step 3: Generate the final HTML report and save it as a PDF
const { text: htmlReport } = await generateText({
model: google("gemini-3-flash-preview"),
prompt: `You are an expert financial analyst and report writer.
Your task is to generate a comprehensive market analysis report in HTML format.
**Instructions:**
1. Write a full HTML document.
2. Use the provided "Market Trends" text to write the main body of the report. Structure it with clear headings and paragraphs.
3. Incorporate the provided "Chart Configurations" to visualize the data. For each chart, you MUST create a unique <canvas> element and a corresponding <script> block to render it using Chart.js.
4. Reference the "Sources" at the end of the report.
5. Do not include any placeholder data; use only the information provided.
6. Return only the raw HTML code.
**Chart Rendering Snippet:**
Include this script in the head of the HTML: <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
For each chart, use a structure like below, ensuring the canvas 'id' is unique for each chart, and apply the correspinding config:
---
<div style="width: 800px; height: 600px;">
<canvas id="chart1"></canvas>
</div>
<script>
new Chart(document.getElementById('chart1'), config);
</script>
---
(For the second chart, use 'chart2' and the corresponding config, and so on.)
**Data:**
- Market Trends: ${marketTrends}
- Chart Configurations: ${JSON.stringify(chartConfigs)}
- Sources: ${JSON.stringify(sources)}
`,
});
// LLMs may wrap the HTML in a markdown code block, so strip it.
const finalHtml = htmlReport.replace(/^```html\n/, "").replace(/\n```$/, "");
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.setContent(finalHtml);
await page.pdf({ path: "report.pdf", format: "A4" });
await browser.close();
console.log("\nReport generated successfully: report.pdf");
}
main().catch(console.error);
Anwendung ausführen
Sie können die Anwendung jetzt ausführen. Führen Sie im Terminal folgenden Befehl aus:
npm
npx tsc && node main.jspnpm
pnpm tsx main.tsyarn
yarn tsc && node main.jsIm Terminal wird eine Protokollierung angezeigt, während das Skript die einzelnen Schritte ausführt.
Nach Abschluss wird im Projektverzeichnis eine Datei report.pdf mit Ihrer Marktanalyse erstellt.
Unten sehen Sie die ersten beiden Seiten eines Beispiel-PDF-Berichts:

Weitere Ressourcen
Weitere Informationen zum Erstellen von Anwendungen mit Gemini und dem AI SDK finden Sie in den folgenden Ressourcen: