開始する

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