دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

بني محرّك سير العمل Jev وLLM متعدد المستخدمين باستعمال Liveblocks

تعلّم كيفاش تثبّت العرض التجريبي ديال محرّك سير العمل Jev، وتضبط بيانات اعتماد Liveblocks وTypesafe وVercel AI Gateway، وتشغّل خادم التطوير، وتبني سيرورات عمل كتوصل Jev بنماذج LLM، وتعاين التشغيلات التجريبية، وتستدعي سيرورات العمل عبر REST API، وتستكشف الحضور ومؤشرات الفأرة ديال المستخدمين المتعددين.

حوالي 10 دقايق ديال القراية
بني محرّك سير العمل Jev وLLM متعدد المستخدمين باستعمال Liveblocks

شنو كيدير Jev Workflow Builder

Jev workflow builder هو تطبيق تجريبي باش تنشئ workflows ديال الذكاء الاصطناعي متعددة المستخدمين. كيجمع بين Jev ونماذج اللغة الكبيرة، وكيستعمل Liveblocks باش يوفر الحالة المشتركة والمؤشرات التعاونية.

من بعد ما تشغل التطبيق، تقدر تربط بين Jev وLLMs، وتعاين تجارب تشغيل الـworkflow، وتستدعي workflow عبر REST API، وتراقب المشاركين الآخرين وهما خدامين فـنفس البيئة التعاونية.

المميزات الرئيسية

  • بناء بصري للـworkflow: ربط مكونات Jev وLLM داخل workflow.
  • تعاون متعدد المستخدمين: شوف حالة التطبيق المشتركة ومؤشرات المستخدمين الآخرين عبر Liveblocks.
  • اختبار الـworkflow: عاين تجارب التشغيل قبل ما تستدعي workflow من الخارج.
  • الولوج لـREST API: استدعي الـworkflows المهيأة بشكل برمجي.
  • دمج خدمات الذكاء الاصطناعي: استعمل Typesafe وVercel AI Gateway باستعمال بيانات الولوج الخاصة بكل خدمة.

المتطلبات المسبقة

قبل ما تهيّأ المشروع، تأكد بلي Node.js وnpm متوفرين فالجهاز ديالك. غادي تحتاج حتى لحسابات فـ3 خدمات خارجية كيستعملها التطبيق التجريبي:

التثبيت والإعداد

1. ثبّت التبعيات

حلّ terminal فالجذر ديال المشروع وثبّت جميع الحزم المطلوبة:

npm install

2. جيب المفتاح السري ديال Liveblocks

  1. أنشئ حساب أو دخل للحساب ديالك فـلوحة تحكم Liveblocks.
  2. حلّ صفحة مفاتيح API.
  3. نسخ المفتاح السري ديالك.

3. جيب مفتاح API ديال Typesafe

  1. أنشئ حساب أو دخل لحساب فـtypesafe.ai.
  2. حلّ وحدة تحكم مفاتيح Typesafe.
  3. نسخ مفتاح API ديالك.

4. جيب مفتاح Vercel AI Gateway

  1. أنشئ حساب أو دخل لحساب فـVercel.
  2. حلّ لوحة تحكم Vercel AI Gateway.
  3. نسخ مفتاح AI Gateway ديالك.

5. هيّأ متغيرات البيئة

أنشئ ملف سميتو .env فالجذر ديال المشروع. زِد بيانات الولوج الثلاثة باستعمال أسماء متغيرات البيئة اللي كيتوقعها التطبيق:

LIVEBLOCKS_SECRET_KEY=your_liveblocks_secret_key
TYPESAFE_API_KEY=your_typesafe_api_key
AI_GATEWAY_API_KEY=your_vercel_ai_gateway_key

بدّل كل قيمة تجريبية بالمفتاح المناسب ديالها. خَلّي هاد الملف خاص حيث فيه بيانات الولوج اللي تقدر تعطي الولوج لخدمات خارجية.

6. شغّل خادم التطوير

شغّل الأمر المحلي ديال التطوير:

npm run dev

ملي يكون الخادم واجد، حلّ http://localhost:3000 فالمتصفح ديالك.

الاستعمال الأساسي

بني Workflow

استعمل واجهة البناء باش تربط Jev بمكونات LLM. رتّب وربط عناصر الـworkflow المتاحة حسب السلوك اللي بغيتي تختبر.

عاين تجربة التشغيل

استعمل وظيفة معاينة الـworkflow باش تشغّل اختبار من داخل التطبيق. المعاينة كتخليك تفحص سلوك الـworkflow وانت مستمر فالخدمة داخل أداة البناء.

استدعي الـWorkflow عبر REST API

التطبيق التجريبي كيدعم استدعاء workflow عبر REST API. استعمل معلومات API اللي كيعرضها المشروع ملي كتبعث الطلب ديالك. ملف README ما كيحددش endpoint ثابت، ولا طريقة HTTP، ولا schema ثابت للطلب، لذلك استعمل المسار والبيانات المطلوبة من التطبيق اللي خدام، وما تفترضش صيغة عامة.

جرّب التعاون متعدد المستخدمين

حلّ التطبيق عند عدة مشاركين باش تراقب المميزات التعاونية ديالو. Liveblocks كيزامن الحالة متعددة المستخدمين وكيعرض المؤشرات، وهادشي كيخليك تشوف النشاط ديال المستخدمين الآخرين فبيئة الـworkflow المشتركة.

نصائح متقدمة

حمي بيانات الولوج ديالك

ما تحطش القيم السرية مباشرة فملفات المصدر، وما تكشفهاش فالأمثلة اللي خدامة فجهة العميل. خزّنها فـ.env، وتجنب مشاركة هاد الملف، وبدّل المفتاح من لوحة تحكم المزوّد ديالو إلا تكشف بالخطأ.

تحقق من الإعدادات ديال كل خدمة بوحدها

إلا بدا التطبيق ولكن شي ميزة ما خداماش، تأكد بلي كل متغير ديال البيئة موجود وفيه بيانات الولوج الصحيحة. Liveblocks كيتكلف بالسلوك متعدد المستخدمين، بينما مفاتيح Typesafe وVercel AI Gateway كيدعمو عمليات الدمج المرتبطة بالذكاء الاصطناعي فالمشروع.

عاود التشغيل من بعد تعديل متغيرات البيئة

إلا زدتي أو بدّلتي مفتاح والخادم ديال التطوير خدام، وقّف وعاود شغّل npm run dev باش يعاود التطبيق يحمّل إعدادات البيئة.

اختبر التعاون بوحدو على تنفيذ الـworkflow

فاللول تأكد بلي الحالة المشتركة والمؤشرات كيبانو عند عدة مشاركين. من بعد اختبر معاينات الـworkflow والاستدعاء عبر REST API. فحص هاد الجوانب بشكل مستقل يقدر يسهل عزل مشاكل الإعداد.

طوّر بالتجارب المعاينة

استعمل تجارب المعاينة وانت كتعدّل كيفاش كيتربطو مكوّنات Jev وLLM. منين كتولي الخدمة خدامة كيف متوقّع فالباني، دوز لتنفيذها عبر REST API.

الخلاصة

كيبيّن باني سير العمل ديال Jev كيفاش تجمع بين إنشاء سير العمل بالذكاء الاصطناعي، والتنفيذ المعتمد على REST، وتجارب المعاينة، والتعاون فالحين فـ تطبيق واحد. من بعد ما تثبّت التبعيات وتهيّأ مفاتيح الخدمات الثلاثة المطلوبة، تقدر تشغّل المشروع محلياً، وتركّب سير العمل ديال Jev وLLM، وتستكشف الحالة المتزامنة ومؤشرات الفأرة ديال المستخدمين المتعدّدين.