Bắt đầu sử dụng Genkit bằng Go (thử nghiệm)

Hướng dẫn này cho bạn biết cách bắt đầu sử dụng Genkit trong ứng dụng Go.

Nếu bạn phát hiện vấn đề với các thư viện hoặc tài liệu này, vui lòng báo cáo vấn đề trong kho lưu trữ GitHub của chúng tôi.

Yêu cầu

Go 1.24 trở lên. Xem phần Tải xuống và cài đặt trong tài liệu chính thức về Go.
Node.js 20 trở lên (dành cho giao diện người dùng và CLI của Genkit). Hãy xem phần tiếp theo để biết hướng dẫn ngắn gọn về cách cài đặt Node.

Cài đặt Genkit

Nếu bạn chưa cài đặt Node 20 trở lên trên hệ thống, hãy cài đặt ngay.

Đề xuất: Các công cụ nvm và nvm-windows là một cách thuận tiện để cài đặt các phiên bản cụ thể của Node nếu bạn chưa cài đặt Node trên hệ thống. Các công cụ này cài đặt Node trên cơ sở mỗi người dùng, vì vậy, bạn không cần thực hiện thay đổi trên toàn hệ thống.

Cách cài đặt nvm:
Linux, macOS, v.v.Windows
Chạy lệnh sau:
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
Tải xuống và chạy trình cài đặt như mô tả trong tài liệu về nvm-windows.
Sau đó, để cài đặt Node và npm, hãy mở một shell mới và chạy lệnh sau:
```
nvm install 20
```
Cài đặt Genkit CLI bằng cách chạy lệnh sau:
```
npm i -g genkit-cli
```
Lệnh này sẽ cài đặt Genkit CLI vào thư mục cài đặt Node để bạn có thể sử dụng bên ngoài dự án Node.

Tạo và khám phá dự án mẫu

Tạo thư mục dự án mới:
```
mkdir genkit-intro && cd genkit-intro
```

Khởi chạy mô-đun Go và lấy gói Genkit:

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

Định cấu hình khoá API mô hình

Trong hướng dẫn này, chúng tôi sẽ hướng dẫn bạn cách sử dụng Gemini API. API này cung cấp một cấp miễn phí hào phóng và không yêu cầu thẻ tín dụng để bắt đầu. Để sử dụng Gemini API, bạn cần có khoá API. Nếu bạn chưa có, hãy tạo khoá trong Google AI Studio.

Sau khi bạn tạo khoá API, hãy đặt biến môi trường GEMINI_API_KEY thành khoá của bạn bằng lệnh sau:

export GEMINI_API_KEY=<your API key>

Tạo yêu cầu đầu tiên

Bắt đầu sử dụng Genkit chỉ với vài dòng mã.

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())
}

Các bước tiếp theo

Giờ đây, bạn đã thiết lập xong để tạo yêu cầu mô hình bằng Genkit, hãy tìm hiểu cách sử dụng thêm các tính năng của Genkit để xây dựng các ứng dụng và quy trình làm việc dựa trên AI. Để bắt đầu sử dụng các tính năng khác của Genkit, hãy xem các hướng dẫn sau:

Công cụ dành cho nhà phát triển: Tìm hiểu cách thiết lập và sử dụng CLI cũng như giao diện người dùng dành cho nhà phát triển của Genkit để giúp bạn kiểm thử và gỡ lỗi ứng dụng trên máy.
Tạo nội dung: Tìm hiểu cách sử dụng API tạo thống nhất của Genkit để tạo văn bản và dữ liệu có cấu trúc từ bất kỳ mô hình nào được hỗ trợ.
Tạo flow: Tìm hiểu cách sử dụng các hàm Genkit đặc biệt, được gọi là flow, cung cấp khả năng quan sát toàn diện cho quy trình công việc và gỡ lỗi phong phú từ công cụ Genkit.
Quản lý lời nhắc: Tìm hiểu cách Genkit giúp bạn quản lý lời nhắc và cấu hình cùng nhau dưới dạng mã.