开始使用

本指南介绍了如何在 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 从任何受支持的模型生成文本和结构化数据。
  • 创建流：了解如何使用特殊的 Genkit 函数（称为“流”），这些函数可为工作流提供端到端可观察性，并通过 Genkit 工具提供丰富的调试功能。
  • 提示模型：了解如何使用 Genkit 将提示模板视为函数，封装模型配置和输入/输出架构。