通过 Go 开始使用 Genkit

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

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

提交第一个请求

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

  2. 使用 Genkit 软件包初始化新的 Go 项目目录：

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

  3. 创建一个包含以下示例代码的 main.go 文件：

    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 Genkit with the Google AI plugin and Gemini 2.0 Flash.
    g, err := genkit.Init(ctx,
        genkit.WithPlugins(&googlegenai.GoogleAI{}),
        genkit.WithDefaultModel("googleai/gemini-2.0-flash"),
    )
    if err != nil {
        log.Fatalf("could not initialize Genkit: %w", err)
    }

    resp, err := genkit.Generate(ctx, g, ai.WithPrompt("What is the meaning of life?"))
    if err != nil {
        log.Fatal("could not generate model response: %w", err)
    }

    log.Println(resp.Text())
}

  4. 通过设置 GEMINI_API_KEY 环境变量来配置 Gemini API 密钥：

    export GEMINI_API_KEY=<your API key>

    如果您还没有 API 密钥，请在 Google AI Studio 中创建密钥。Google AI 提供较大的免费使用额度，开通时无需信用卡。

  5. 运行应用以查看模型回答：

    go run .
There is no single universally agreed-upon meaning of life; it's a deeply
personal question. Many find meaning through connection, growth,
contribution, happiness, or discovering their own purpose.

后续步骤

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

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