瞭解詳情

本指南說明如何在 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 工作室中建立金鑰。

從 Google AI Studio 取得 API 金鑰

建立 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 如何將提示範本視為函式,封裝模型設定和輸入/輸出結構定義。