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

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

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

تتطلّب كلتا الأداتَين استخدام الإصدار 20 من Node.js أو إصدار أحدث.

تثبيت

إذا لم يكن لديك Node 20 أو إصدار أحدث على نظامك، ثبِّته الآن.

اقتراح: تُعدّ أداتا nvm و nvm-windows طريقتَين مناسبتَين لتثبيت إصدارات محدّدة من Node إذا لم يكن مثبّتًا على نظامك. وتثبِّت هذه الأدوات Node لكل مستخدم على حدة، وبالتالي لست بحاجة إلى إجراء تغييرات على مستوى النظام.

لتثبيت nvm:
نظاما التشغيل Linux وmacOS وما إلى ذلكWindows
شغِّل الأمر التالي:
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
نزِّل أداة التثبيت وشغِّلها كما هو موضّح في مستندات nvm-windows.
بعد ذلك، لتثبيت Node وnpm، افتح وحدة تحكّم جديدة وشغِّل الأمر التالي:
```
nvm install 20
```
ثبِّت Genkit CLI من خلال تنفيذ الأمر التالي:
```
npm i -g genkit-cli
```
يعمل هذا الأمر على تثبيت Genkit CLI في دليل تثبيت Node كي يمكن استخدامه خارج مشروع Node.

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

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

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

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

genkit --help

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

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

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

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

genkit start -- <command to run your code>

سيختلف <command to run your code> استنادًا إلى إعداد مشروعك، ولكن سيظهر على النحو التالي في معظم التطبيقات:

genkit start -- go run .

تعتمد واجهة مستخدم المطوّر على استمرار تشغيل تطبيق Go، حتى إذا اكتمل المنطق. إذا كنت قد بدأت للتو ولم يكن Genkit جزءًا من تطبيق أوسع نطاقًا، أضِف select {} كآخر سطر من main() لمنع التطبيق من الإغلاق حتى تتمكّن من فحصه في واجهة المستخدم.

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

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

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

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

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

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

تحتوي واجهة المستخدم للمطوّر على مشغّلات إجراءات Flow وPrompt وModel وTool وRetriever وIndexer وEmbedder وEvaluator استنادًا إلى المكوّنات التي حدّدتها في الرمز البرمجي.

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

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

إحصاءات Google

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

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

genkit config set analyticsOptOut true

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

genkit config get analyticsOptOut