بدء استخدام Genkit باستخدام Go

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

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

تقديم طلبك الأول

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

  2. يمكنك إعداد دليل مشروع Go جديد باستخدام حزمة Genkit:

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

  3. أنشئ ملف main.go باستخدام نموذج التعليمة البرمجية التالي:

    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 Genkit with the Google AI plugin and Gemini 2.0 Flash.
    g, err := genkit.Init(ctx,
        genkit.WithPlugins(&googlegenai.GoogleAI{}),
        genkit.WithDefaultModel("googleai/gemini-2.0-flash"),
    )
    if err != nil {
        log.Fatalf("could not initialize Genkit: %w", err)
    }

    resp, err := genkit.Generate(ctx, g, ai.WithPrompt("What is the meaning of life?"))
    if err != nil {
        log.Fatal("could not generate model response: %w", err)
    }

    log.Println(resp.Text())
}

  4. يمكنك ضبط مفتاح Gemini API من خلال ضبط متغيّر GEMINI_API_KEY في البيئة:

    export GEMINI_API_KEY=<your API key>

    إذا لم يكن لديك مفتاح، يمكنك إنشاء مفتاح في Google AI Studio. توفّر تكنولوجيات الذكاء الاصطناعي من Google فئة مجانية سخية ولا تتطلّب استخدام بطاقة ائتمان للبدء.

  5. شغِّل التطبيق للاطّلاع على استجابة النموذج:

    go run .
There is no single universally agreed-upon meaning of life; it's a deeply
personal question. Many find meaning through connection, growth,
contribution, happiness, or discovering their own purpose.

الخطوات التالية

بعد أن تم إعدادك لتقديم طلبات النماذج باستخدام Genkit، تعرَّف على كيفية استخدام المزيد من إمكانات Genkit لإنشاء تطبيقات ومسارات عمل مستندة إلى الذكاء الاصطناعي. للبدء، يُرجى الاطّلاع على الأدلة التالية لبدء استخدام ميزات Genkit الإضافية:

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