Firebase Genkit bietet zwei wichtige Entwicklertools:
- Eine Node.js-Befehlszeile für Befehlszeilenvorgänge
- Eine optionale lokale Webanwendung, die als Entwickleroberfläche bezeichnet wird und für interaktive Tests und die Entwicklung mit Ihrer Genkit-Konfiguration verwendet wird
Befehlszeile
Installieren Sie die Befehlszeile in Ihrem Projekt mit:
npm install -D genkit-cli
Die Befehlszeile unterstützt verschiedene Befehle, um die Arbeit mit Genkit-Projekten zu erleichtern:
genkit start -- <command to run your code>
: Starten Sie die Entwickler-Benutzeroberfläche und stellen Sie eine Verbindung zu einem laufenden Codeprozess her.genkit flow:run <flowName>
: Einen bestimmten Ablauf ausführen.genkit eval:flow <flowName>
: Einen bestimmten Ablauf bewerten.
Eine vollständige Liste der Befehle erhalten Sie mit:
npx genkit --help
Genkit-Benutzeroberfläche für Entwickler
Die Genkit-Entwickler-UI ist eine lokale Webanwendung, mit der Sie interaktiv mit Modellen, Abläufen, Prompts und anderen Elementen in Ihrem Genkit-Projekt arbeiten können.
Die Entwickleroberfläche kann anhand eines laufenden Codeprozesses ermitteln, welche Genkit-Komponenten Sie in Ihrem Code definiert haben.
Führen Sie den folgenden Befehl aus, um die Benutzeroberfläche zu starten:
npx genkit start -- <command to run your code>
Die <command to run your code>
variiert je nach Projekteinrichtung und Datei, die Sie ausführen möchten. Hier sind einige Beispiele:
# 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
Wenn Sie die Option --watch
angeben, werden gespeicherte Änderungen am Code in der Entwickleroberfläche erkannt und berücksichtigt, ohne dass der Code neu gestartet werden muss.
Nach der Ausführung des Befehls erhalten Sie eine Ausgabe wie die folgende:
Telemetry API running on http://localhost:4033
Genkit Developer UI: http://localhost:4000
Öffnen Sie die lokale Hostadresse für die Genkit-Entwickler-UI in Ihrem Browser, um sie aufzurufen. Sie können sie auch im einfachen Browser von VS Code öffnen, um sie neben Ihrem Code anzusehen.
Alternativ können Sie dem Startbefehl die Option -o
hinzufügen, um die Entwickleroberfläche automatisch in Ihrem Standardbrowsertab zu öffnen.
npx genkit start -o -- <command to run your code>
Die Entwickleroberfläche enthält Aktionsauslöser für flow
, prompt
, model
, tool
, retriever
, indexer
, embedder
und evaluator
, die auf den Komponenten basieren, die Sie in Ihrem Code definiert haben.
Hier ist eine kurze GIF-Demo mit Katzen.
Analytics
Die Genkit-Befehlszeile und die Entwickler-Benutzeroberfläche verwenden Cookies und ähnliche Technologien von Google, um die Qualität der angebotenen Dienste zu verbessern und Zugriffe zu analysieren. Weitere Informationen
Wenn Sie die Analyse deaktivieren möchten, können Sie den folgenden Befehl ausführen:
npx genkit config set analyticsOptOut true
Sie können die aktuelle Einstellung mit folgendem Befehl aufrufen:
npx genkit config get analyticsOptOut