Per iniziare

Questa guida mostra come iniziare a utilizzare Genkit in un'app Node.js.

Prerequisiti

Questa guida presuppone che tu abbia dimestichezza con la creazione di applicazioni con Node.js.

Per completare questa guida introduttiva, assicurati che l'ambiente di sviluppo soddisfi i seguenti requisiti:

  • Node.js versione 20 e successive
  • npm

Installa le dipendenze di Genkit

Installa le seguenti dipendenze di Genkit per utilizzare Genkit nel tuo progetto:

  • @genkit-ai/ai e @genkit-ai/core forniscono le funzionalità di base di Genkit.
  • @genkit-ai/googleai forniscono accesso ai modelli Gemini dell'IA di Google.
  • genkit fornisce l'interfaccia a riga di comando Genkit e gli strumenti per aiutarti a testare e eseguire il debug della soluzione in un secondo momento.
npm install @genkit-ai/ai @genkit-ai/core @genkit-ai/googleai
npm install -g genkit

Configura la chiave API del modello

Per questa guida, ti mostreremo come utilizzare l'API Gemini, che offre un livello senza costi generoso e non richiede una carta di credito per iniziare. Per utilizzare l'API Gemini, devi disporre di una chiave API. Se non ne hai già una, crea una chiave in Google AI Studio.

Ottenere una chiave API da Google AI Studio

Dopo aver creato una chiave API, imposta la variabile di ambiente GOOGLE_GENAI_API_KEY sulla chiave con il seguente comando:

export GOOGLE_GENAI_API_KEY=<your API key>

Importa la libreria

Importa le librerie di base di Genkit e il plug-in per le API Gemini di Google AI.

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

Effettua la tua prima richiesta

Utilizza il metodo generate per generare una risposta di testo.

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

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

console.log(result.text())

Passaggi successivi

Ora che hai configurato le richieste di modelli con Genkit, scopri come utilizzare altre funzionalità di Genkit per creare app e flussi di lavoro basati sull'IA. Per iniziare a utilizzare altre funzionalità di Genkit, consulta le seguenti guide:

  • Strumenti per sviluppatori: scopri come configurare e utilizzare l'interfaccia a riga di comando e l'interfaccia utente per sviluppatori di Genkit per testare e eseguire il debug della tua app localmente.
  • Generazione di contenuti: scopri come utilizzare l'API di generazione unificata di Genkit per generare testo e dati strutturati da qualsiasi modello supportato.
  • Creazione di flussi: scopri come utilizzare funzioni Genkit speciali, chiamate flussi, che forniscono l'osservabilità end-to-end per i flussi di lavoro e un debug avanzato dagli strumenti Genkit.
  • Modelli di prompt: scopri come Genkit ti consente di trattare i modelli di prompt come funzioni, incapsulando le configurazioni del modello e lo schema di input/output.