Memulai Genkit menggunakan Go (beta)

Panduan ini menunjukkan cara memulai Genkit di aplikasi Go.

Jika Anda menemukan masalah terkait library atau dokumentasi ini, laporkan di repositori GitHub kami.

Persyaratan

  • Go versi 1.24 atau yang lebih baru. Lihat Mendownload dan menginstal di dokumen Go resmi.

  • Node.js 20 atau yang lebih baru (untuk Genkit CLI dan UI). Lihat bagian berikutnya untuk melihat panduan singkat tentang cara menginstal Node.

Menginstal Genkit

  1. Jika Anda belum memiliki Node 20 atau versi yang lebih baru di sistem, instal sekarang.

    Rekomendasi: Alat nvm dan nvm-windows merupakan cara mudah untuk menginstal versi Node tertentu jika belum diinstal di sistem Anda. Alat-alat ini akan menginstal Node per pengguna, sehingga Anda tidak perlu membuat perubahan di seluruh sistem.

    Untuk menginstal nvm:

    Linux, macOS, dll.

    Jalankan perintah berikut:

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    Windows

    Download dan jalankan penginstal seperti yang dijelaskan di dokumen nvm-windows.

    Kemudian, untuk menginstal Node dan npm, buka shell baru dan jalankan perintah berikut:

    nvm install 20

  2. Instal Genkit CLI dengan menjalankan perintah berikut:

    npm i -g genkit-cli

    Perintah ini menginstal Genkit CLI ke direktori penginstalan Node Anda, sehingga dapat digunakan di luar project Node.

Membuat dan menjelajahi project contoh

  1. Buat direktori project baru:

    mkdir genkit-intro && cd genkit-intro

  2. Lakukan inisialisasi modul Go dan dapatkan paket Genkit:

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

Konfigurasi kunci API model

Untuk panduan ini, kami akan menunjukkan cara menggunakan Gemini API yang menyediakan paket gratis yang melimpah dan tidak memerlukan kartu kredit untuk memulai. Untuk menggunakan Gemini API, Anda memerlukan kunci API. Jika Anda belum memilikinya, buat kunci di Google AI Studio.

Setelah membuat kunci API, tetapkan variabel lingkungan GEMINI_API_KEY ke kunci Anda dengan perintah berikut:

export GEMINI_API_KEY=<your API key>

Membuat permintaan pertama Anda

Mulai Genkit hanya dengan beberapa baris kode.

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

Langkah berikutnya

Setelah Anda siap membuat permintaan model dengan Genkit, pelajari cara menggunakan lebih banyak kemampuan Genkit untuk membangun aplikasi dan alur kerja yang didukung teknologi AI. Untuk mulai menggunakan kemampuan Genkit tambahan, lihat panduan berikut:

  • Alat developer: Pelajari cara menyiapkan dan menggunakan CLI dan UI developer Genkit untuk membantu Anda menguji dan men-debug aplikasi secara lokal.
  • Membuat konten: Pelajari cara menggunakan API pembuatan terpadu Genkit untuk membuat teks dan data terstruktur dari berbagai model yang didukung.
  • Membuat flow: Pelajari cara menggunakan fungsi Genkit khusus, yang disebut flow, yang memberikan visibilitas menyeluruh untuk alur kerja dan proses debug yang lengkap dari alat Genkit.
  • Mengelola prompt: Pelajari cara Genkit membantu Anda mengelola prompt dan konfigurasi sebagai kode.