使用 Go 開始使用 Genkit (Beta 版)

本指南說明如何在 Go 應用程式中開始使用 Genkit。

如果您發現程式庫或本說明文件的問題，請在我們的 GitHub 存放區中回報。

需求條件

Go 1.24 以上版本。請參閱官方 Go 說明文件中的「下載及安裝」一節。
Node.js 20 以上版本 (適用於 Genkit CLI 和 UI)。請參閱下一節，瞭解如何安裝 Node。

安裝 Genkit

如果系統尚未安裝 Node 20 以上版本，請立即安裝。

建議：如果系統尚未安裝 Node，您可以使用 nvm 和 nvm-windows 工具，輕鬆安裝特定版本的 Node。這些工具會針對個別使用者安裝 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
```
執行下列指令，安裝 Genkit CLI：
```
npm i -g genkit-cli
```
這個指令會將 Genkit CLI 安裝到 Node 安裝目錄中，以便在 Node 專案外使用。

建立及探索範例專案

建立新的專案目錄：
```
mkdir genkit-intro && cd genkit-intro
```

初始化 Go 模組並取得 Genkit 套件：

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

設定模型 API 金鑰

這份指南說明如何使用 Gemini API，這個 API 提供大量免費方案配額，不需要信用卡即可開始使用。您必須具備 API 金鑰，才能使用 Gemini 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 和開發人員 UI，以便在本機測試應用程式及進行偵錯。
生成內容：瞭解如何使用 Genkit 的整合式生成 API，從任何支援的模型生成文字和結構化資料。
建立流程：瞭解如何使用 Genkit 的特殊函式「flow」，透過 Genkit 工具為工作流程提供端對端監控，並使用豐富的偵錯功能。
管理提示：瞭解 Genkit 如何協助您以程式碼形式管理提示和設定。