开始使用

本指南介绍了如何开始在 Node.js 应用中使用 Genkit。

前提条件

本指南假定您熟悉如何使用 Node.js 构建应用。

如需完成本快速入门，请确保您的开发环境满足以下要求：

  • Node.js v20 及更高版本
  • 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 密钥。如果您还没有 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 和开发者界面，以便在本地测试和调试您的应用。
  • 生成内容：了解如何使用 Genkit 的统一生成 API 从任何受支持的模型生成文本和结构化数据。
  • 创建 flow：了解如何使用名为“flow”的特殊 Genkit 函数，这些函数可为工作流提供端到端的可观测性，并通过 Genkit 工具提供丰富的调试功能。
  • 管理提示：了解 Genkit 如何帮助您将提示和配置作为代码一起管理。