بدء استخدام Genkit باستخدام Go (إصدار تجريبي)

يوضّح لك هذا الدليل كيفية بدء استخدام Genkit في تطبيق Go.

إذا رصدت مشاكل في المكتبات أو في هذه المستندات، يُرجى الإبلاغ عنها في مستودع GitHub.

المتطلّبات

• الإصدار 1.24 من Go أو إصدار أحدث اطّلِع على التنزيل والتثبيت في مستندات Go الرسمية.

• ‫Node.js 20 أو إصدار أحدث (لواجهة مستخدم 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. ثبِّت Genkit CLI من خلال تنفيذ الأمر التالي:

   npm i -g genkit-cli

   يعمل هذا الأمر على تثبيت Genkit CLI في دليل تثبيت 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

ضبط مفتاح واجهة برمجة التطبيقات للنموذج

في هذا الدليل، سنوضّح لك كيفية استخدام Gemini API التي توفّر خطة مجانية سخية ولا تتطلّب بطاقة ائتمان للبدء. لاستخدام Gemini API، ستحتاج إلى مفتاح واجهة برمجة التطبيقات. إذا لم يكن لديك مفتاح، أنشئ مفتاحًا في Google AI Studio.

بعد إنشاء مفتاح واجهة برمجة التطبيقات، اضبط متغيّر GEMINI_API_KEY environment على مفتاحك باستخدام الأمر التالي:

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 لمساعدتك في اختبار تطبيقك وتصحيح أخطاءه على الجهاز.
• إنشاء المحتوى: تعرَّف على كيفية استخدام واجهة برمجة التطبيقات الموحدة لإنشاء المحتوى في Genkit لإنشاء نص وبيانات منظَّمة من أي نموذج متوافق.
• إنشاء مسارات: تعرَّف على كيفية استخدام دوال Genkit الخاصة، التي تُعرف باسم "المسارات"، والتي توفّر إمكانية مراقبة شاملة لسير العمل وتصحيح أخطاء مفصّل من خلال أدوات Genkit.
• إدارة الطلبات: تعرَّف على كيفية مساعدة Genkit في إدارة طلباتك وإعداداتك معًا كرمز برمجي.