يوفّر 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 eval:flow <flowName>
: تقييم عملية تدفق معيّنة
للحصول على قائمة كاملة بالأوامر، استخدِم:
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>
تحتوي واجهة المستخدم للمطوّر على مشغّلات إجراءات لـ flow
وprompt
وmodel
وtool
وretriever
وindexer
وembedder
وevaluator
استنادًا إلى المكوّنات التي حدّدتها في الرمز البرمجي.
إليك جولة سريعة في صور GIF تتضمّن قططًا.
إحصاءات Google
يستخدم واجهة برمجة التطبيقات Genkit وواجهة مستخدم المطوّر ملفات تعريف الارتباط والتكنولوجيات المشابهة من Google لتقديم خدماتها وتحسين جودتها وتحليل الاستخدام. مزيد من المعلومات
لإيقاف ميزة الإحصاءات، يمكنك تنفيذ الأمر التالي:
npx genkit config set analyticsOptOut true
يمكنك الاطّلاع على الإعداد الحالي من خلال تنفيذ:
npx genkit config get analyticsOptOut