Genkit 개발자 도구

Genkit는 다음과 같은 두 가지 주요 개발자 도구를 제공합니다.

  • 명령줄 작업을 위한 Node.js CLI
  • 대화형 테스트 및 개발을 위해 Genkit 구성과 상호작용하는 개발자 UI라는 선택적 로컬 웹 앱

이러한 두 도구를 사용하려면 Node.js 20 이상이 필요합니다.

설치

  1. 시스템에 아직 Node 20 이상이 설치되어 있지 않다면 지금 설치합니다.

    권장사항: nvm 및 nvm-windows 도구는 시스템에 아직 설치되지 않은 경우 특정 버전의 Node.js를 설치할 수 있는 편리한 방법입니다. 이러한 도구는 사용자별로 노드를 설치하므로 시스템 전체를 변경할 필요가 없습니다.

    nvm을 설치하려면 다음 안내를 따르세요.

    Linux, macOS 등

    다음 명령어를 실행합니다.

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

    Windows

    nvm-windows 문서에 설명된 대로 설치 프로그램을 다운로드하고 실행합니다.

    그런 다음 노드 및 npm을 설치하려면 새 셸을 열고 다음 명령어를 실행합니다.

    nvm install 20

  2. 다음 명령어를 실행하여 Genkit CLI를 설치합니다.

    npm i -g genkit-cli

    이 명령어는 Genkit CLI를 노드 설치 디렉터리에 설치하여 노드 프로젝트 외부에서 사용할 수 있습니다.

명령줄 인터페이스(CLI)

CLI는 Genkit 프로젝트 작업을 용이하게 하는 다양한 명령어를 지원합니다.

  • genkit start -- <command to run your code>: 개발자 UI를 시작하고 실행 중인 코드 프로세스에 연결합니다.
  • genkit flow:run <flowName>: 지정된 플로우를 실행합니다. 런타임이 이미 GENKIT_ENV=dev 환경 변수가 설정된 별도의 터미널에서 실행 중이어야 합니다.
  • genkit eval:flow <flowName>: 특정 플로우를 평가합니다. 런타임이 이미 GENKIT_ENV=dev 환경 변수가 설정된 별도의 터미널에서 실행 중이어야 합니다.

전체 명령어 목록을 확인하려면 다음을 사용합니다.

genkit --help

Genkit 개발자 UI

Genkit 개발자 UI는 Genkit 프로젝트의 모델, 플로우, 프롬프트, 기타 요소를 대화형으로 작업할 수 있는 로컬 웹 앱입니다.

개발자 UI는 실행 중인 코드 프로세스에 연결하여 코드에서 정의한 Genkit 구성요소를 식별할 수 있습니다.

UI를 시작하려면 다음 명령어를 실행합니다.

genkit start -- <command to run your code>

<command to run your code>는 프로젝트 설정에 따라 다르지만 대부분의 앱에서는 다음과 같이 표시됩니다.

genkit start -- go run .

개발자 UI는 로직이 완료되더라도 계속 실행되는 Go 앱을 사용합니다. 이제 막 시작했고 Genkit이 더 큰 앱의 일부가 아닌 경우 select {}를 main() 마지막 줄에 추가하여 앱이 종료되지 않도록 합니다. 그러면 UI에서 앱을 검사할 수 있습니다.

명령어를 실행하면 다음과 같은 출력이 표시됩니다.

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

브라우저에서 Genkit 개발자 UI의 로컬 호스트 주소를 열어 확인합니다. VS Code 간단한 브라우저에서 열어 코드와 함께 볼 수도 있습니다.

또는 시작 명령어에 -o 옵션을 추가하여 기본 브라우저 탭에서 개발자 UI를 자동으로 열 수 있습니다.

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

Genkit 개발자 UI에 오신 것을 환영합니다

개발자 UI에는 코드에서 정의한 구성요소를 기반으로 Flow, Prompt, Model, Tool, Retriever, Indexer, Embedder, Evaluator의 작업 실행기가 있습니다.

다음은 고양이가 등장하는 GIF를 간단히 둘러봅니다.

Genkit 개발자 UI 개요 GIF

애널리틱스

Genkit CLI 및 개발자 UI는 서비스 제공 및 품질 개선, 사용 분석을 위해 Google의 쿠키 및 유사 기술을 사용합니다. 자세히 알아보기

애널리틱스를 선택 해제하려면 다음 명령어를 실행합니다.

genkit config set analyticsOptOut true

다음을 실행하여 현재 설정을 확인할 수 있습니다.

genkit config get analyticsOptOut