Firebase Genkit fournit deux outils clés pour les développeurs:
- Une CLI Node.js pour les opérations de ligne de commande
- Une application Web locale facultative, appelée UI pour les développeurs, qui interagit avec votre configuration Genkit pour le développement et les tests interactifs
Interface de ligne de commande (CLI)
Installez la CLI dans votre projet à l'aide de:
npm install -D genkit-cli
La CLI prend en charge diverses commandes pour faciliter le travail avec les projets Genkit:
genkit start -- <command to run your code>
: démarre l'UI du développeur et la connecte à un processus de code en cours d'exécution.genkit flow:run <flowName>
: exécute un flux spécifié. Votre environnement d'exécution doit déjà s'exécuter dans un terminal distinct avec la variable d'environnementGENKIT_ENV=dev
définie.genkit eval:flow <flowName>
: évaluez un flux spécifique. Votre environnement d'exécution doit déjà s'exécuter dans un terminal distinct avec la variable d'environnementGENKIT_ENV=dev
définie.
Pour obtenir la liste complète des commandes, utilisez:
npx genkit --help
UI du développeur Genkit
L'UI pour les développeurs de Genkit est une application Web locale qui vous permet de travailler de manière interactive avec les modèles, les flux, les invites et d'autres éléments de votre projet Genkit.
L'UI du développeur peut identifier les composants Genkit que vous avez définis dans votre code en se connectant à un processus de code en cours d'exécution.
Pour démarrer l'UI, exécutez la commande suivante:
npx genkit start -- <command to run your code>
Le <command to run your code>
varie en fonction de la configuration de votre projet et du fichier que vous souhaitez exécuter. Voici quelques exemples :
# Running a typical development server npx genkit start -- npm run dev
# Running a TypeScript file directly npx genkit start -- npx tsx --watch src/index.ts
# Running a JavaScript file directly npx genkit start -- node --watch src/index.js
L'inclusion de l'option --watch
permet à l'UI du développeur de remarquer et de refléter les modifications enregistrées dans votre code sans avoir à le redémarrer.
Après avoir exécuté la commande, vous obtiendrez un résultat semblable à celui-ci:
Telemetry API running on http://localhost:4033
Genkit Developer UI: http://localhost:4000
Ouvrez l'adresse hôte locale de l'interface utilisateur du développeur Genkit dans votre navigateur pour l'afficher. Vous pouvez également l'ouvrir dans le navigateur simple de VS Code pour l'afficher à côté de votre code.
Vous pouvez également ajouter l'option -o
à la commande de démarrage pour ouvrir automatiquement l'UI du développeur dans l'onglet de votre navigateur par défaut.
npx genkit start -o -- <command to run your code>
L'UI du développeur dispose de déclencheurs d'action pour flow
, prompt
, model
, tool
, retriever
, indexer
, embedder
et evaluator
en fonction des composants que vous avez définis dans votre code.
Voici un bref tour d'horizon des GIF avec des chats.
Analytics
La CLI Genkit et l'UI du développeur utilisent des cookies et des technologies similaires de Google pour fournir ses services et en améliorer la qualité, ainsi que pour analyser l'utilisation. En savoir plus
Pour désactiver les données analytiques, vous pouvez exécuter la commande suivante:
npx genkit config set analyticsOptOut true
Pour afficher le paramètre actuel, exécutez la commande suivante:
npx genkit config get analyticsOptOut