البدء

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

المتطلبات الأساسية

يفترض هذا الدليل أنّك على دراية بإنشاء التطبيقات باستخدام Node.js.

لإكمال هذا الدليل السريع، تأكَّد من أنّ بيئة التطوير تستوفي المتطلبات التالية:

• الإصدار 20 من Node.js والإصدارات الأحدث
• npm

تثبيت تبعيات Genkit

ثبِّت التبعيات التالية لـ Genkit لاستخدام Genkit في مشروعك:

• يوفّر genkit إمكانات Genkit الأساسية.
• @genkit-ai/googleai يتيح الوصول إلى نماذج Google AI Gemini.

npm install genkit @genkit-ai/googleai

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

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

الحصول على مفتاح واجهة برمجة التطبيقات من Google AI Studio

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

export GOOGLE_GENAI_API_KEY=<your API key>

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

يمكنك البدء باستخدام Genkit ببضع أسطر من الرموز البرمجية البسيطة.

// import the Genkit and Google AI plugin libraries
import { gemini15Flash, googleAI } from '@genkit-ai/googleai';
import { genkit } from 'genkit';

// configure a Genkit instance
const ai = genkit({
  plugins: [googleAI()],
  model: gemini15Flash, // set default model
});

(async () => {
  // make a generation request
  const { text } = await ai.generate('Hello, Gemini!');
  console.log(text);
})();

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

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

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