本指南說明如何在 Node.js 應用程式中開始使用 Genkit。
事前準備
本指南假設您已熟悉如何使用 Node.js 建構應用程式。
如要完成本快速入門課程,請確認您的開發環境符合下列需求:
- Node.js v20 以上
- npm
安裝 Genkit 依附元件
安裝下列 Genkit 依附元件,即可在專案中使用 Genkit:
@genkit-ai/ai
和@genkit-ai/core
提供 Genkit 核心功能。@genkit-ai/googleai
提供 Google AI Gemini 模型的存取權。genkit
提供 Genkit CLI 和工具,方便您日後測試及偵錯解決方案。
npm install @genkit-ai/ai @genkit-ai/core @genkit-ai/googleai
npm install -g genkit
設定模型 API 金鑰
本指南將說明如何使用 Gemini API,這個 API 提供豐富的免費方案,而且無須使用信用卡即可開始使用。如要使用 Gemini API,您需要 API 金鑰。如果您還沒有金鑰,請在 Google AI 工作室中建立金鑰。
建立 API 金鑰後,請使用下列指令將 GOOGLE_GENAI_API_KEY
環境變數設為金鑰:
export GOOGLE_GENAI_API_KEY=<your API key>
匯入程式庫
匯入 Genkit 核心程式庫和 Google AI Gemini API 外掛程式。
import { generate } from '@genkit-ai/ai';
import { configureGenkit } from '@genkit-ai/core';
import { googleAI, gemini15Flash } from '@genkit-ai/googleai';
提出第一個要求
使用 generate
方法產生文字回應。
configureGenkit({ plugins: [googleAI()] });
const result = await generate({
model: gemini15Flash,
prompt: 'Tell me a heroic story about a software developer.',
});
console.log(result.text())
後續步驟
現在您已經學會透過 Genkit 提出模型要求了,接著就來瞭解如何透過更多 Genkit 功能建構 AI 技術輔助應用程式與工作流程。如要開始使用其他 Genkit 功能,請參閱下列指南:
- 開發人員工具:瞭解如何設定及使用 Genkit 的 CLI 和開發人員 UI,以便在本機測試及偵錯應用程式。
- 產生內容:瞭解如何使用 Genkit 的整合式產生 API,透過任何支援的模型產生文字和結構化資料。
- 建立流程:瞭解如何使用特殊的 Genkit 函式 (稱為「流程」),為工作流程提供端對端的可觀察性,並透過 Genkit 工具進行詳細偵錯。
- 提示模型:瞭解 Genkit 如何將提示範本視為函式,封裝模型設定和輸入/輸出結構定義。