시작하기

이 가이드에서는 Node.js 앱에서 Genkit을 시작하는 방법을 보여줍니다.

기본 요건

이 가이드에서는 개발자가 Node.js로 애플리케이션을 빌드하는 데 익숙하다고 가정합니다.

이 빠른 시작을 완료하려면 개발 환경이 다음 요구사항을 충족하는지 확인하세요.

  • Node.js v20 이상
  • npm

Genkit 종속 항목 설치

프로젝트에서 Genkit를 사용하려면 다음 Genkit 종속 항목을 설치합니다.

  • genkit는 Genkit 핵심 기능을 제공합니다.
  • @genkit-ai/googleai는 Google AI Gemini 모델에 대한 액세스를 제공합니다.
npm install genkit @genkit-ai/googleai

모델 API 키 구성

이 가이드에서는 Gemini API를 사용하는 방법을 보여줍니다. Gemini API는 넉넉한 무료 등급을 제공하며 시작하는 데 신용카드가 필요하지 않습니다. Gemini API를 사용하려면 API 키가 필요합니다. 키가 아직 없다면 Google AI 스튜디오에서 키를 만듭니다.

Google AI Studio에서 API 키 가져오기

API 키를 만든 후 다음 명령어를 사용하여 GOOGLE_GENAI_API_KEY 환경 변수를 키로 설정합니다.

export GOOGLE_GENAI_API_KEY=<your API key>

첫 번째 요청하기

간단한 코드 몇 줄로 Genkit을 시작해 보세요.

// import the Genkit and Google AI plugin libraries
import { gemini15Flash, googleAI } from '@genkit-ai/googleai';
import { genkit } from 'genkit';

// configure a Genkit instance
const ai = genkit({
  plugins: [googleAI()],
  model: gemini15Flash, // set default model
});

(async () => {
  // make a generation request
  const { text } = await ai.generate('Hello, Gemini!');
  console.log(text);
})();

다음 단계

이제 Genkit으로 모델을 요청할 준비가 되었습니다. 더 많은 Genkit 기능을 사용하여 AI 기반 앱과 워크플로를 빌드하는 방법을 알아보세요. 추가 Genkit 기능을 시작하려면 다음 가이드를 참고하세요.

  • 개발자 도구: 로컬에서 앱을 테스트하고 디버그하는 데 도움이 되는 Genkit의 CLI 및 개발자 UI를 설정하고 사용하는 방법을 알아봅니다.
  • 콘텐츠 생성: Genkit의 통합 생성 API를 사용하여 지원되는 모든 모델에서 텍스트와 구조화된 데이터를 생성하는 방법을 알아봅니다.
  • 흐름 만들기: 흐름이라는 특수 Genkit 함수를 사용하여 워크플로의 엔드 투 엔드 관찰 가능성을 제공하고 Genkit 도구에서 풍부한 디버깅을 실행하는 방법을 알아봅니다.
  • 메시지 관리): Genkit을 사용하여 메시지를 관리하는 방법을 알아봅니다.
  • 프롬프트와 구성을 함께 코드로