開始使用

本指南說明如何在 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 提供豐富的免費方案，而且無須使用信用卡即可開始使用。如要使用 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 如何協助您管理
  • 提示和設定以程式碼的形式整合。