이 가이드에서는 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를 사용하려면 API 키가 필요합니다. 아직 키가 없다면 Google AI 스튜디오에서 키를 만드세요.
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이 프롬프트와 구성을 코드로서 함께 관리하는 데 어떤 도움이 되는지 알아봅니다.