Herramientas para desarrolladores de Firebase Genkit

Firebase Genkit proporciona dos herramientas clave para desarrolladores:

  • Una CLI de Node.js para operaciones de línea de comandos
  • Una app web local opcional, llamada IU para desarrolladores, que interactúa con tu configuración de Genkit para realizar pruebas y desarrollo interactivos

Interfaz de línea de comandos (CLI)

Instala la CLI en tu proyecto con lo siguiente:

npm install -D genkit-cli

La CLI admite varios comandos para facilitar el trabajo con proyectos de Genkit:

  • genkit start -- <command to run your code>: Inicia la IU para desarrolladores y conéctala a un proceso de código en ejecución.
  • genkit flow:run <flowName>: Ejecuta un flujo especificado.
  • genkit eval:flow <flowName>: Evalúa un flujo específico.

Para obtener una lista completa de comandos, usa lo siguiente:

npx genkit --help

IU para desarrolladores de Genkit

La IU para desarrolladores de Genkit es una app web local que te permite trabajar de forma interactiva con modelos, flujos, instrucciones y otros elementos de tu proyecto de Genkit.

La IU para desarrolladores puede identificar los componentes de Genkit que definiste en tu código cuando se adjunta a un proceso de código en ejecución.

Para iniciar la IU, ejecuta el siguiente comando:

npx genkit start -- <command to run your code>

El <command to run your code> variará según la configuración de tu proyecto y el archivo que deseas ejecutar. Estos son algunos ejemplos:

# 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

Si incluyes la opción --watch, la IU para desarrolladores podrá detectar y reflejar los cambios guardados en tu código sin necesidad de reiniciarlo.

Después de ejecutar el comando, obtendrás un resultado como el siguiente:

Telemetry API running on http://localhost:4033
Genkit Developer UI: http://localhost:4000

Abre la dirección de host local de la IU para desarrolladores de Genkit en tu navegador para verla. También puedes abrirlo en el navegador simple de VS Code para verlo junto con tu código.

Como alternativa, puedes agregar la opción -o al comando start para abrir automáticamente la IU para desarrolladores en la pestaña del navegador predeterminada.

npx genkit start -o -- <command to run your code>

Te damos la bienvenida a la IU para desarrolladores de Genkit

La IU para desarrolladores tiene ejecutores de acciones para flow, prompt, model, tool, retriever, indexer, embedder y evaluator según los componentes que definiste en tu código.

Aquí tienes una visita rápida en GIF con gatos.

Gif de descripción general de la IU para desarrolladores de Genkit

Analytics

La CLI de Genkit y la IU para desarrolladores usan cookies y tecnologías similares de Google para brindar y mejorar la calidad de sus servicios, y analizar el uso. Obtén más información.

Para inhabilitar las estadísticas, puedes ejecutar el siguiente comando:

npx genkit config set analyticsOptOut true

Para ver la configuración actual, ejecuta lo siguiente:

npx genkit config get analyticsOptOut