開始學習

本指南說明如何在 Node.js 應用程式開始使用 Genkit。

事前準備

本指南假設您已熟悉如何使用 Node.js 建構應用程式。

如要完成這份快速入門指南，請確保開發環境符合下列要求：

  • Node.js 20 以上版本
  • npm

安裝 Genkit 依附元件

安裝下列 Genkit 依附元件，以便在專案使用 Genkit：

  • genkit 提供 Genkit 核心功能。
  • @genkit-ai/googleai 可讓您使用 Google AI Gemini 模型。
npm install genkit @genkit-ai/googleai

設定模型 API 金鑰

這份指南說明如何使用 Gemini API，這個 API 提供大量免費方案配額，不需要信用卡即可開始使用。須有 API 金鑰，才能使用 Gemini 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 的特殊函式「flow」，透過 Genkit 工具為工作流程提供端對端監控，並使用豐富的偵錯功能。
  • 管理提示：瞭解 Genkit 如何協助您以程式碼形式管理提示和設定。