使用 Go 开始使用 Genkit（Beta 版）

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

如果您发现库或本文档存在问题，请在我们的 GitHub 代码库中报告这些问题。

要求

  • Go 1.24 或更高版本。请参阅官方 Go 文档中的下载并安装部分。

  • Node.js 20 或更高版本（适用于 Genkit CLI 和界面）。请参阅下一部分，了解有关安装 Node 的简要指南。

安装 Genkit

  1. 如果您的系统上尚未安装 Node 20 或更高版本，请立即安装。

    建议：如果您的系统上尚未安装特定版本的 Node，可使用 nvm 和 nvm-windows 工具轻松进行安装。这些工具会按用户安装 Node，因此您无需进行系统范围的更改。

    如需安装 nvm，请执行以下步骤：

    Linux、macOS 等

    运行以下命令：

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    Windows

    按照 nvm-windows 文档中的说明下载并运行安装程序。

    然后，如需安装 Node 和 npm，请打开一个新的 shell 并运行以下命令：

    nvm install 20

  2. 运行以下命令来安装 Genkit CLI：

    npm i -g genkit-cli

    此命令会将 Genkit CLI 安装到您的 Node 安装目录中，以便在 Node 项目外部使用。

创建和探索示例项目

  1. 创建新的项目目录：

    mkdir genkit-intro && cd genkit-intro

  2. 初始化 Go 模块并获取 Genkit 软件包：

    go mod init example/genkit-intro
go get github.com/firebase/genkit/go

配置模型 API 密钥

在本指南中，我们将介绍如何使用 Gemini API。该 API 提供较大的免费使用额度，开通时无需信用卡。如需使用 Gemini API，您需要一个 API 密钥。如果您还没有 API 密钥，请在 Google AI Studio 中创建密钥。

创建 API 密钥后，使用以下命令将 GEMINI_API_KEY 环境变量设置为您的密钥：

export GEMINI_API_KEY=<your API key>

提交第一个请求

只需编写几行代码，即可开始使用 Genkit。

package main

import (
    "context"
    "log"

    "github.com/firebase/genkit/go/ai"
    "github.com/firebase/genkit/go/genkit"
    "github.com/firebase/genkit/go/plugins/googlegenai"
)

func main() {
    ctx := context.Background()

    // Initialize a Genkit instance.
    g, err := genkit.Init(ctx,
        // Install the Google AI plugin which provides Gemini models.
        genkit.WithPlugins(&googlegenai.GoogleAI{}),
        // Set the default model to use for generate calls.
        genkit.WithDefaultModel("googleai/gemini-2.0-flash"),
    )
    if err != nil {
        log.Fatal(err)
    }

    // Generate a model response.
    resp, err := genkit.Generate(ctx, g, ai.WithPrompt("Hello, Gemini!"))
    if err != nil {
        log.Fatal(err)
    }

    log.Println(resp.Text())
}

后续步骤

现在您已完成配置，可以使用 Genkit 发起模型请求；接下来，您可以进一步了解如何利用 Genkit 的更多功能来构建 AI 赋能的应用和工作流。如需开始使用其他 Genkit 功能，请参阅以下指南：

  • 开发者工具：了解如何设置和使用 Genkit 的 CLI 和开发者界面，以便在本地测试和调试您的应用。
  • 生成内容：了解如何使用 Genkit 的统一生成 API 从任何受支持的模型生成文本和结构化数据。
  • 创建 flow：了解如何使用名为“flow”的特殊 Genkit 函数，这些函数可为工作流提供端到端的可观测性，并通过 Genkit 工具提供丰富的调试功能。
  • 管理提示：了解 Genkit 如何帮助您将提示和配置作为代码一起管理。