תחילת העבודה עם Genkit באמצעות Go (בטא)

במדריך הזה מוסבר איך להתחיל להשתמש ב-Genkit באפליקציה של Go.

אם נתקלתם בבעיות בספריות או במסמכי התיעוד, תוכלו לדווח עליהן במאגר שלנו ב-GitHub.

דרישות

• Go מגרסה 1.24 ואילך. מידע נוסף זמין במאמר הורדה והתקנה במסמכי העזרה הרשמיים של Go.

• Node.js 20 ואילך (ל-CLI ולממשק המשתמש של Genkit). בקטע הבא מופיע מדריך קצר להתקנת Node.

התקנת Genkit

1. אם עדיין לא התקנתם את Node 20 ואילך במערכת, כדאי לעשות זאת עכשיו.

   המלצה: הכלים nvm ו-nvm-windows הם דרך נוחה להתקין גרסאות ספציפיות של Node, אם הוא עדיין לא מותקן במערכת. הכלים האלה מתקינים את Node לכל משתמש בנפרד, כך שאין צורך לבצע שינויים ברמת המערכת.

   כדי להתקין את nvm:

   Linux,‏ macOS וכו'

   מריצים את הפקודה הבאה:

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

   Windows

   מורידים ומפעילים את מנהל ההתקנה כפי שמתואר במסמכי nvm-windows.

   לאחר מכן, כדי להתקין את Node ו-npm, פותחים מעטפת חדשה ומריצים את הפקודה הבאה:

   nvm install 20

2. כדי להתקין את ה-CLI של Genkit, מריצים את הפקודה הבאה:

   npm i -g genkit-cli

   הפקודה הזו מתקינה את ה-CLI של Genkit בספריית ההתקנה של Node, כדי שאפשר יהיה להשתמש בו מחוץ לפרויקט Node.

יצירת פרויקט לדוגמה וחקר שלו

1. יוצרים ספריית פרויקט חדשה:

   mkdir genkit-intro && cd genkit-intro

2. מאתחלים את מודול 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 כדי ליצור אפליקציות ותהליכי עבודה מבוססי-AI. כדי להתחיל להשתמש ביכולות נוספות של Genkit, תוכלו לעיין במדריכים הבאים:

• כלים למפתחים: מידע על הגדרה ושימוש בממשק המשתמש למפתחים וב-CLI של Genkit, שיעזרו לכם לבדוק ולפתור באגים באפליקציה באופן מקומי.
• יצירת תוכן: איך משתמשים ב-Genkit's Unified Generation API כדי ליצור טקסט ונתונים מובְנים מכל מודל נתמך.
• יצירת תהליכים: איך משתמשים בפונקציות מיוחדות של Genkit שנקראות תהליכים, שמספקות יכולת תצפית מקצה לקצה לתהליכי עבודה וניפוי באגים עשיר באמצעות הכלים של Genkit.
• ניהול הנחיות: איך Genkit עוזר לכם לנהל את ההנחיות וההגדרות יחד כקוד.