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 fornisce le funzionalità di base di Genkit.
  • @genkit-ai/googleai fornisce l'accesso ai modelli Gemini di Google AI.
npm install genkit @genkit-ai/googleai

Configura la chiave API del modello

In 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>

Effettua la tua prima richiesta

Inizia a utilizzare Genkit con poche righe di codice semplice.

// import the Genkit and Google AI plugin libraries
import { gemini15Flash, googleAI } from '@genkit-ai/googleai';
import { genkit } from 'genkit';

// configure a Genkit instance
const ai = genkit({
  plugins: [googleAI()],
  model: gemini15Flash, // set default model
});

(async () => {
  // make a generation request
  const { text } = await ai.generate('Hello, Gemini!');
  console.log(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.
  • Generare 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 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.