Pierwsze kroki z Genkit za pomocą Go (beta)

Z tego przewodnika dowiesz się, jak zacząć korzystać z Genkit w aplikacji Go.

Jeśli zauważysz problemy z bibliotekami lub tą dokumentacją, zgłoś je w naszym repozytorium GitHub.

Wymagania

Go w wersji 1.24 lub nowszej. Więcej informacji znajdziesz w artykule Pobieranie i instalowanie w oficjalnych dokumentach Go.
Node.js w wersji 20 lub nowszej (w przypadku interfejsu wiersza poleceń i interfejsu użytkownika Genkit). W następnej sekcji znajdziesz krótki przewodnik po instalacji Node.

Instalowanie Genkit

Jeśli nie masz jeszcze w systemie Node 20 lub nowszej wersji, zainstaluj ją teraz.

Rekomendacja: narzędzia nvm i nvm-windows to wygodny sposób na zainstalowanie określonych wersji Node, jeśli nie są one jeszcze zainstalowane w Twoim systemie. Te narzędzia instalują Node na poziomie użytkownika, więc nie musisz wprowadzać zmian w całym systemie.

Aby zainstalować nvm:
Linux, macOS itp.Windows
Uruchom to polecenie:
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
Pobierz i uruchom instalator zgodnie z opisem w dokumentacji nvm-windows.
Następnie, aby zainstalować Node i npm, otwórz nową powłokę i uruchom to polecenie:
```
nvm install 20
```
Zainstaluj interfejs wiersza poleceń Genkit, uruchamiając to polecenie:
```
npm i -g genkit-cli
```
To polecenie instaluje Genkit CLI w katalogu instalacji Node, aby można było go używać poza projektem Node.

Tworzenie i poznawanie przykładowego projektu

Utwórz nowy katalog projektu:
```
mkdir genkit-intro && cd genkit-intro
```

Zainicjuj moduł Go i pobierz pakiet Genkit:

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

Konfigurowanie klucza interfejsu API modelu

W tym przewodniku pokażemy Ci, jak korzystać z interfejsu Gemini API, który oferuje obfity bezpłatny poziom usług i nie wymaga karty kredytowej, aby rozpocząć korzystanie z usługi. Aby korzystać z interfejsu Gemini API, musisz mieć klucz interfejsu API. Jeśli nie masz jeszcze klucza, utwórz go w Google AI Studio.

Po utworzeniu klucza interfejsu API ustaw zmienną środowiskową GEMINI_API_KEY na klucz, używając tego polecenia:

export GEMINI_API_KEY=<your API key>

Przesyłanie pierwszej prośby

Zacznij korzystać z Genkit za pomocą kilku linii kodu.

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

Dalsze kroki

Gdy już skonfigurujesz przesyłanie żądań do Genkit, dowiesz się, jak korzystać z większej liczby funkcji Genkit do tworzenia aplikacji i przepływów pracy opartych na AI. Aby rozpocząć korzystanie z dodatkowych funkcji Genkit, zapoznaj się z tymi przewodnikami:

Narzędzia dla programistów: dowiedz się, jak skonfigurować i użyć interfejsu wiersza poleceń oraz interfejsu dla programistów Genkit, aby testować i debugować aplikację lokalnie.
Generowanie treści: dowiedz się, jak używać zintegrowanego interfejsu API do generowania treści w Genkit, aby generować tekst i uporządkowane dane z dowolnego obsługiwanego modelu.
Tworzenie przepływów: dowiedz się, jak używać specjalnych funkcji Genkit, zwanych przepływami, które zapewniają kompleksową obserwowalność przepływów pracy i zaawansowane debugowanie za pomocą narzędzi Genkit.
Zarządzanie promptami: dowiedz się, jak Genkit pomaga zarządzać promptami i konfiguracją w kodzie.