أدوات المطوّرين Genkit في Firebase

يوفّر Firebase Genkit أداتَين رئيسيتين للمطوّرين:

  • واجهة سطر أوامر Node.js لإجراء عمليات سطر الأوامر
  • تطبيق ويب اختياري على الجهاز، يُعرف باسم واجهة مستخدم المطوّر، ويتفاعل مع إعدادات Genkit للاختبار والتطوير التفاعليَين

واجهة سطر الأوامر (CLI)

ثبِّت واجهة سطر الأوامر في مشروعك باستخدام:

npm install -D genkit-cli

تتيح لك واجهة برمجة التطبيقات (CLI) تنفيذ أوامر مختلفة لتسهيل العمل مع مشاريع Genkit:

  • genkit start -- <command to run your code>: ابدأ واجهة مستخدم المطوّر وصِّلها بعملية رمز برمجي جارية.
  • genkit flow:run <flowName>: تشغيل عملية مُحدّدة يجب أن يكون وقت التشغيل قيد التشغيل في محطة طرفية منفصلة مع ضبط متغيّر GENKIT_ENV=dev للبيئة.
  • genkit eval:flow <flowName>: تقييم عملية تدفق معيّنة يجب أن يكون وقت التشغيل قيد التشغيل في محطة طرفية منفصلة مع ضبط المتغيّرGENKIT_ENV=dev للبيئة.

للحصول على قائمة كاملة بالأوامر، استخدِم:

npx genkit --help

واجهة مستخدم مطوّر Genkit

واجهة مستخدم مطوّري Genkit هي تطبيق ويب محلي يتيح لك التفاعل مع النماذج ومسارات المستخدمين والطلبات والعناصر الأخرى في مشروعك على Genkit.

يمكن لواجهة مستخدم المطوّر تحديد مكونات Genkit التي حدّدتها في الرمز البرمجي من خلال الربط بعملية رمز برمجي جارية.

لبدء واجهة المستخدم، شغِّل الأمر التالي:

npx genkit start -- <command to run your code>

سيختلف <command to run your code> استنادًا إلى إعداد مشروعك والملف الذي تريد تنفيذه. وإليك بعض الأمثلة:

# Running a typical development server
npx genkit start -- npm run dev
# Running a TypeScript file directly
npx genkit start -- npx tsx --watch src/index.ts
# Running a JavaScript file directly
npx genkit start -- node --watch src/index.js

سيؤدي تضمين خيار --watch إلى تمكّن واجهة مستخدم المطوّر من ملاحظة التغييرات المحفوظة في الرمز البرمجي و تطبيقها بدون الحاجة إلى إعادة تشغيله.

بعد تنفيذ الأمر، ستظهر لك نتيجة مماثلة لما يلي:

Telemetry API running on http://localhost:4033
Genkit Developer UI: http://localhost:4000

افتح عنوان المضيف المحلي لواجهة مستخدم مطوّري Genkit في المتصفّح لاطلاعك على الواجهة. يمكنك أيضًا فتحه في متصفّح VS Code البسيط لعرضه بجانب الرمز البرمجي.

بدلاً من ذلك، يمكنك استخدام الخيار -o مع الأمر start لفتح واجهة مستخدم المطوّر تلقائيًا في علامة التبويب التلقائية للمتصفّح.

npx genkit start -o -- <command to run your code>

مرحبًا بك في واجهة مستخدم المطوّر في Genkit

تحتوي واجهة المستخدم للمطوّر على مشغّلات إجراءات لـ flow وprompt وmodel وtool وretriever وindexer وembedder وevaluator استنادًا إلى المكوّنات التي حدّدتها في الرمز البرمجي.

إليك جولة سريعة في صور GIF تتضمّن قططًا.

نظرة عامة على ملف GIF لواجهة مستخدم المطوّر في Genkit

إحصاءات Google

يستخدم واجهة برمجة التطبيقات Genkit وواجهة مستخدم المطوّر ملفات تعريف الارتباط والتكنولوجيات المشابهة من Google لتقديم خدماتها وتحسين جودتها وتحليل الاستخدام. مزيد من المعلومات

لإيقاف ميزة الإحصاءات، يمكنك تنفيذ الأمر التالي:

npx genkit config set analyticsOptOut true

يمكنك الاطّلاع على الإعداد الحالي من خلال تنفيذ:

npx genkit config get analyticsOptOut