通过 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 如何帮助您将提示和配置作为代码一起管理。