使用 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>

   如果還沒有金鑰，請在 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 和開發人員 UI，以便在本機測試應用程式及進行偵錯。
• 生成內容：瞭解如何使用 Genkit 的整合式生成 API，從任何支援的模型生成文字和結構化資料。
• 建立流程：瞭解如何使用 Genkit 的特殊函式「flow」，透過 Genkit 工具為工作流程提供端對端監控，並使用豐富的偵錯功能。
• 管理提示：瞭解 Genkit 如何協助您以程式碼形式管理提示和設定。