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.