Jev: اترك القرارات الصغيرة مثل "أيّ خيار تختار" للنموذج
يتلقى نظام خدمة العملاء الرسائل دون توقف. هل هذه الرسالة شكوى أم استفسار أم إعلان مزعج؟ هل نحوّلها إلى موظف بشري؟ هذا النوع من القرارات الصغيرة، "اختيار خيار من بين عدة خيارات"، كبير الحجم، ويحتاج إلى سرعة، ويجب أن يكون النتيجة متطابقة في كل مرة.
Jev هو نموذج مخصص لهذا النوع من القرارات. ستأخذك هذه المحطة للحصول على مفتاح API وإرسال أول طلب محليًا.
أولًا، ألقِ نظرة على كيفية عمله:
- 1احصل على API Key
- 2أرسل أول طلب
- 3أكمل الـ Agent العملية
ماذا نفعل في هذه المحطة
- الحصول على مفتاح TypeSafe API وتخزينه في متغير البيئة
TYPESAFE_API_KEY - تشغيل أول طلب Jev محليًا: نص تذكرة واحدة، والحصول على ثلاث إجابات دفعة واحدة — التصنيف والتقييم ونعم/لا
- القدرة على تحديد المشكلة بمقارنة رموز الحالة عند وقوع أخطاء: 401 تحقّق من المفتاح، 429 يعني تحديد المعدل، 400 تحقّق من تنسيق الطلب
دروس هذه المحطة
| الدرس | المحتوى |
|---|---|
| 1.1 Jev ما هو | نموذج القرار System One، والفرق بينه وبين LLM، وأنواع الأسئلة الثلاثة Choice / Score / Noul؛ باستخدام Playground الرسمي طوال الوقت دون كتابة أي كود |
| 1.2 التسجيل ومفتاح API | الحصول على المفتاح من وحدة تحكم TypeSafe، وتخزينه في متغير البيئة TYPESAFE_API_KEY، وأين تبحث عن حدود المعدل |
| 1.3 التثبيت وأول طلب | تثبيت typesafe-sdk عبر venv + pip، وتشغيل مثال الأسئلة الثلاثة الرسمي للتذاكر |
| ↳ 1.3b طرق التثبيت البديلة | uv وnpm (JavaScript / TypeScript SDK) وcurl للاتصال المباشر بواجهة API |
| 1.4 استكشاف أخطاء البدء وإصلاحها | مقارنة رموز الحالة مثل 401 / 429 / 400، وإعادة المحاولة التلقائية في SDK، والأخطاء الشائعة |
ما يجب تحضيره قبل البدء
- حاسوب يتصل بالإنترنت ويمكنه فتح الطرفية (أوامر البدء السريع الرسمية مكتوبة لـ Bash على macOS / Linux / Windows WSL)
- Python 3.10 أو أحدث (المسار الرئيسي يستخدم Python SDK؛ مسار Node.js 22+ مشروح في الدرس 1.3b)
- شبكة قادرة على الوصول إلى
console.typesafe.ai(للحصول على المفتاح) وapi.typesafe.ai(لإرسال الطلبات)
الخطوة التالية
ابدأ من الدرس الأول.