このガイドでは、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 Studio でキーを作成します。
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 でプロンプト テンプレートを関数として扱い、モデル構成と入出力スキーマをカプセル化する方法について学びます。