Go'yu kullanarak Genkit'i kullanmaya başlama (beta)

Bu kılavuzda, Go uygulamasında Genkit'i nasıl kullanmaya başlayabileceğiniz gösterilmektedir.

Kitaplıklar veya bu dokümanlarla ilgili sorun tespit ederseniz lütfen GitHub depomuzda bildirin.

Şartlar

1.24 veya sonraki bir sürümü kullanın. Resmi Go dokümanlarındaki İndir ve yükle bölümüne bakın.
Node.js 20 veya sonraki sürümler (Genkit komut satırı arayüzü ve kullanıcı arayüzü için). Node'u yüklemeyle ilgili kısa bir kılavuz için sonraki bölüme bakın.

Genkit'i yükleme

Sisteminizde Node 20 veya daha yeni bir sürüm yoksa hemen yükleyin.

Öneri: nvm ve nvm-windows araçları, sisteminizde yüklü değilse Node'un belirli sürümlerini yüklemenin kullanışlı bir yoludur. Bu araçlar Node'u kullanıcı başına yükler. Bu nedenle, sistem genelinde değişiklik yapmanız gerekmez.

nvm'ı yüklemek için:
Linux, macOS vb.Windows
Aşağıdaki komutu çalıştırın:
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
Yükleyiciyi nvm-windows dokümanlarındaki talimatları uygulayarak indirip çalıştırın.
Ardından, Node ve npm'ü yüklemek için yeni bir kabuk açıp aşağıdaki komutu çalıştırın:
```
nvm install 20
```
Aşağıdaki komutu çalıştırarak Genkit CLI'yi yükleyin:
```
npm i -g genkit-cli
```
Bu komut, Genkit CLI'yi bir Node projesinin dışında kullanılabilmesi için Node yükleme dizininize yükler.

Örnek proje oluşturma ve keşfetme

Yeni bir proje dizini oluşturun:
```
mkdir genkit-intro && cd genkit-intro
```

Go modülünü başlatın ve Genkit paketini alın:

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

Model API anahtarınızı yapılandırma

Bu kılavuzda, cömert bir ücretsiz katman sunan ve başlamak için kredi kartı gerektirmeyen Gemini API'yi nasıl kullanacağınızı göstereceğiz. Gemini API'yi kullanmak için bir API anahtarına ihtiyacınız vardır. Henüz bir anahtarınız yoksa Google AI Studio'da anahtar oluşturun.

API anahtarı oluşturduktan sonra aşağıdaki komutu kullanarak GEMINI_API_KEY ortam değişkenini anahtarınıza ayarlayın:

export GEMINI_API_KEY=<your API key>

İlk isteğinizi gönderin

Genkit'i yalnızca birkaç satır kodla kullanmaya başlayın.

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

Sonraki adımlar

Genkit ile model isteği göndermeye hazır olduğunuza göre, yapay zeka destekli uygulama ve iş akışlarınızı oluşturmak için Genkit'in diğer özelliklerini nasıl kullanacağınızı öğrenin. Genkit'in ek özelliklerini kullanmaya başlamak için aşağıdaki kılavuzları inceleyin:

Geliştirici araçları: Uygulamanızı yerel olarak test etmenize ve hata ayıklamanıza yardımcı olması için Genkit'in CLI'sini ve geliştirici kullanıcı arayüzünü nasıl ayarlayacağınızı ve kullanacağınızı öğrenin.
İçerik oluşturma: Desteklenen herhangi bir modelden metin ve yapılandırılmış veri oluşturmak için Genkit'in birleşik oluşturma API'sini nasıl kullanacağınızı öğrenin.
Akış oluşturma: İş akışları için uçtan uca gözlemlenebilirlik ve Genkit araçlarından zengin hata ayıklama sağlayan akışlar adı verilen özel Genkit işlevlerini nasıl kullanacağınızı öğrenin.
İstemleri yönetme: Genkit'in istemlerinizi ve yapılandırmanızı kod olarak birlikte yönetmenize nasıl yardımcı olduğunu öğrenin.