Herramientas para desarrolladores de Genkit

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 se comunica con tu configuración de Genkit para pruebas y desarrollo interactivos

Ambas herramientas requieren Node.js 20 o una versión posterior.

Instalación

  1. Si no tienes Node 20 o una versión más reciente en tu sistema, instálalo ahora.

    Recomendación: Las herramientas nvm y nvm-windows son una forma práctica de instalar versiones específicas de Node si aún no lo hiciste en tu sistema. Estas herramientas instalan Node por usuario, por lo que no es necesario realizar cambios en todo el sistema.

    Para instalar nvm:

    Linux, macOS, etcétera

    Ejecuta el siguiente comando:

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    Windows

    Descarga y ejecuta el instalador como se describe en la documentación de nvm-windows.

    Luego, para instalar Node y npm, abre una shell nueva y ejecuta el siguiente comando:

    nvm install 20

  2. Para instalar la CLI de Genkit, ejecuta el siguiente comando:

    npm i -g genkit-cli

    Este comando instala la CLI de Genkit en el directorio de instalación de Node para que pueda usarse fuera de un proyecto de Node.

Interfaz de línea de comandos (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. El entorno de ejecución ya debe estar ejecutándose en una terminal independiente con la variable de entorno GENKIT_ENV=dev establecida.
  • genkit eval:flow <flowName>: Evalúa un flujo específico. El entorno de ejecución ya debe estar ejecutándose en una terminal independiente con la variable de entorno GENKIT_ENV=dev establecida.

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

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:

genkit start -- <command to run your code>

El <command to run your code> variará según la configuración de tu proyecto, pero para la mayoría de las apps se verá de la siguiente manera:

genkit start -- go run .

La IU del desarrollador depende de que la app para Go siga ejecutándose, incluso si la lógica se completó. Si recién comienzas y Genkit no forma parte de una app más amplia, agrega select {} como la última línea de main() para evitar que la app se cierre y puedas inspeccionarla en la IU.

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 de inicio para abrir automáticamente la IU de desarrollador en la pestaña del navegador predeterminada.

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

Te damos la bienvenida a 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 breve visita guiada con GIFs de 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 sus servicios, mejorar su calidad y analizar el uso. Obtén más información.

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

genkit config set analyticsOptOut true

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

genkit config get analyticsOptOut