开始

本指南介绍了如何在 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 Studio 中创建一个。

从 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 和开发者界面，以帮助您在本地测试和调试应用。
  • 生成内容：了解如何使用 Genkit 的统一生成 API 从任何受支持的模型生成文本和结构化数据。
  • 创建数据流：了解如何使用特殊的 Genkit 函数（称为 Flow），以便通过 Genkit 工具实现工作流的端到端可观测性和丰富的调试。
  • 提示模型：了解 Genkit 如何帮助您将提示模板视为函数，并封装模型配置和输入/输出架构。