本指南說明如何在 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 工作室中建立金鑰。
建立 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 如何將提示範本視為函式，封裝模型設定和輸入/輸出結構定義。