Inizia

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

Prerequisiti

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

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

  • Node.js versione 20 e successive
  • npm

Installa le dipendenze Genkit

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

  • genkit fornisce le funzionalità di base di Genkit.
  • @genkit-ai/googleai consente di accedere 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 generoso livello senza costi e non richiede una carta di credito per iniziare. Per utilizzare l'API Gemini, devi avere 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 comando seguente:

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 workflow basati sull'IA. Per iniziare a utilizzare le funzionalità aggiuntive di Genkit, consulta le guide seguenti:

  • Strumenti per sviluppatori: scopri come configurare e utilizzare l'interfaccia a riga di comando e la UI per sviluppatori di Genkit per testare ed eseguire il debug della tua app a livello locale.
  • 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, denominate flussi, che forniscono l'osservabilità end-to-end per i workflow e un ricco debug dagli strumenti Genkit.
  • Gestire i prompt: scopri come Genkit ti consente di gestire i prompt e la configurazione insieme come codice.