با استفاده از Go (بتا) با Genkit شروع کنید
bookmark_border با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

این راهنما به شما نشان می دهد که چگونه با Genkit در برنامه Go شروع کنید.

اگر مشکلاتی را در مورد کتابخانه ها یا این اسناد کشف کردید، لطفاً آنها را در مخزن GitHub ما گزارش دهید.

الزامات

برو 1.24 یا بالاتر. به دانلود و نصب در اسناد رسمی Go مراجعه کنید.
Node.js 20 یا جدیدتر (برای Genkit CLI و UI). برای راهنمایی مختصر در مورد نصب Node به بخش بعدی مراجعه کنید.

Genkit را نصب کنید

اگر در حال حاضر Node 20 یا جدیدتر را روی سیستم خود ندارید، همین الان آن را نصب کنید.
توصیه: ابزارهای nvm و nvm-windows راه مناسبی برای نصب نسخه‌های خاصی از Node هستند، اگر قبلاً روی سیستم شما نصب نشده باشد. این ابزارها Node را بر اساس هر کاربر نصب می کنند، بنابراین نیازی به ایجاد تغییرات در سطح سیستم ندارید.
برای نصب nvm :
لینوکس، macOS و غیره ویندوز
دستور زیر را اجرا کنید:
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
همانطور که در اسناد nvm-windows توضیح داده شده است، نصب کننده را دانلود و اجرا کنید.
سپس برای نصب Node و npm یک پوسته جدید باز کنید و دستور زیر را اجرا کنید:
```
nvm install 20
```
Genkit CLI را با اجرای دستور زیر نصب کنید:
```
npm i -g genkit-cli
```
این دستور Genkit CLI را در دایرکتوری نصب Node شما نصب می کند تا بتوان از آن در خارج از پروژه Node استفاده کرد.

یک پروژه نمونه ایجاد و کاوش کنید

یک فهرست پروژه جدید ایجاد کنید:
```
mkdir genkit-intro && cd genkit-intro
```
ماژول Go را راه اندازی کنید و بسته Genkit را دریافت کنید:
```
go mod init example/genkit-intro
go get github.com/firebase/genkit/go
```

کلید API مدل خود را پیکربندی کنید

برای این راهنما، نحوه استفاده از Gemini API را به شما نشان خواهیم داد که یک ردیف رایگان سخاوتمندانه ارائه می دهد و برای شروع به کارت اعتباری نیاز ندارد. برای استفاده از Gemini API، به یک کلید API نیاز دارید. اگر قبلاً یکی ندارید، یک کلید در Google AI Studio ایجاد کنید .

پس از ایجاد یک کلید API، متغیر محیطی GEMINI_API_KEY را با دستور زیر روی کلید خود تنظیم کنید:

export GEMINI_API_KEY=<your API key>

اولین درخواست خود را مطرح کنید

با Genkit فقط در چند خط کد شروع کنید.

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

مراحل بعدی

اکنون که برای ایجاد درخواست‌های مدل با Genkit آماده شده‌اید، یاد بگیرید که چگونه از قابلیت‌های Genkit بیشتر برای ایجاد برنامه‌ها و گردش‌های کاری مبتنی بر هوش مصنوعی خود استفاده کنید. برای شروع کار با قابلیت های اضافی Genkit، به راهنماهای زیر مراجعه کنید:

ابزارهای برنامه‌نویس : نحوه راه‌اندازی و استفاده از Genkit's CLI و UI توسعه‌دهنده را بیاموزید تا به شما کمک کند برنامه خود را به صورت محلی آزمایش و اشکال‌زدایی کنید.
تولید محتوا : یاد بگیرید که چگونه از API نسل یکپارچه Genkit برای تولید متن و داده های ساختاریافته از هر مدل پشتیبانی شده استفاده کنید.
ایجاد جریان : نحوه استفاده از توابع ویژه Genkit به نام جریان ها را بیاموزید که قابلیت مشاهده سرتاسر برای گردش کار و اشکال زدایی غنی از ابزار Genkit را فراهم می کند.
مدیریت درخواست‌ها : بیاموزید که چگونه Genkit به شما کمک می‌کند اعلان‌ها و پیکربندی خود را با هم به عنوان کد مدیریت کنید.

با استفاده از Go (بتا) با Genkit شروع کنید bookmark_borderbookmark با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.