كيف تبدأ باستخدام Jev

ابدأ دون كتابة كود

يمكنك تجربة نصك وسؤالك في التجربة المجانية المستقلة لهذا الموقع دون تقديم مفتاح API. حدّد قاعدة نعم/لا أو من خيارين إلى 6 خيارات. لربط Jev بتطبيقك، اتبع مسار الوصول الرسمي المنفصل إلى حساب TypeSafe وواجهة API الموضح أدناه.

تسمح التجربة بإجمالي يصل إلى 10,000 محرف للنص والسؤال والقواعد والخيارات، محسوبة كنقاط ترميز Unicode. هذا هو حد الموقع وليس نافذة سياق Jev. قد تتطلب الاختبارات المباشرة التحقق من أنك إنسان وتتوقف عند حدود الاستخدام أو الميزانية. تحميل القالب لا يشغّله ولا يقدم نتيجة نموذج مسبقة.

افتح المحرر المخصص · حمّل قالب تصنيف الملاحظات

1. ابدأ بمسار الوصول المناسب

حتى 17 سبتمبر 2026، يعرض موقع TypeSafe العام قائمة انتظار. ويقدّم دليل البدء السريع الرسمي إرشادات لبيئة Playground وواجهة API. إتاحة صفحة التوثيق للقراءة لا تعني أن كل حساب يستطيع الوصول إلى النموذج.

• إذا لم تتوفر لك إمكانية الوصول: استخدم قائمة الانتظار في موقع TypeSafe الرسمي. لا يستطيع هذا الموقع اعتماد الحسابات أو إصدار مفاتيح API.
• إذا كان حسابك يملك إمكانية الوصول: افتح لوحة تحكم TypeSafe، واتبع خطوات Playground أو إنشاء مفتاح API.

قد تتغير إتاحة الحسابات وخطوات التهيئة. لوحة التحكم الرسمية هي المكان المناسب للتحقق من حالة حسابك.

2. جرّب سؤالًا واحدًا محدد النطاق

في Playground، استخدم رسالة خيالية قصيرة كمدخل، واطرح سؤال Noul واحدًا. يمكنك مثلًا استخدام رسالة تطلب معاودة الاتصال، والسؤال عما إذا كانت تطلب ذلك صراحةً. ثم استبدل المدخل بطلب مساعدة مبهم، ولاحظ ما إذا كانت النتيجة تتغير.

هذا تمرين للاستكشاف وليس اختبار دقة. يساعدك البدء بمثالين متباينين على معرفة ما إذا كان سؤالك يعبّر عن التمييز الذي تقصده.

يسمّي Jev المعلومات التي تزوّده بها state، أي السياق المُقدَّم. وقد تكون سلسلة نصية أو كائن JSON أو مصفوفة. في المهام الأكثر تفصيلًا، استخدم حقولًا مسمّاة للفصل بين الرسالة والسجلات الداعمة والسياسة ذات الصلة. صيغ المدخلات

curl --fail-with-body --silent --show-error \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "jev-latest",
  "state": "Please call me tomorrow morning to discuss the setup.",
  "questions": {
    "callback_requested": {
      "type": "noul",
      "instructions": "Does the sender explicitly ask for a phone call?"
    }
  }
}
JSON

4. أضف البنية حين تحتاجها المهمة فقط

استخدم Choice عندما تعتمد الخطوة التالية على فئة، وScore عندما تكون لديك مستويات مرتبة ذات معنى، وNoul عندما تحتاج إلى احتمال لسؤال إجابته نعم أو لا. اجمع الأسئلة المستقلة عن السياق نفسه في طلب واحد، وتعامل مع نتائجها داخل تطبيقك.

للانتقال إلى خطوة عملية، اتبع مثال تذكرة الدعم. يوضح المثال كيف تتحول نتيجة موثقة إلى اقتراح للتوجيه.

5. عالج مشكلات الوصول والطلب كلًا على حدة

إذا لم يكتمل تسجيل الدخول إلى لوحة التحكم، فافتحها مجددًا من مدخلها الرسمي المعتاد، وتحقق من استخدام الحساب الذي يملك إمكانية الوصول. تجنّب تغيير طلب API مرارًا لحل مشكلة تسجيل دخول في المتصفح. كما أن نجاح تسجيل الدخول لا يثبت أن مفتاح API قد صدر. إن احتجت إلى مساعدة في الحساب، فاستخدم مسار الدعم الرسمي لدى TypeSafe؛ ولا تُدرج مفتاحًا أو رابط تسجيل دخول في تقرير عام.

بالنسبة إلى طلب HTTP، افحص رمز الحالة ومحتوى الخطأ قبل تغيير السؤال:

هذه الرموز موثقة في مرجع API. عند ظهور 429 أو 529، زِد فترات الانتظار بين المحاولات زيادةً أسّية. تعيد الإعدادات الافتراضية لحزمة SDK المحاولة بالفعل؛ ضع تلك المحاولات في الحسبان قبل إضافة حلقة إعادة محاولة خارجية.

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

6. استقصِ سبب الإجابة غير المتوقعة

هذه خطوات استقصاء نقترحها تحريريًا. يشرح دليل Score القيم الكسرية، وتربط صفحة الحدود بتحفظات المورّد الحالية وملاحظات المجتمع المصنّفة بصورة منفصلة.

يمكن أن يشير الاسم المستعار jev-latest لاحقًا إلى نموذج أحدث. سجّل معرّف النموذج الذي تعيده الاستجابة أثناء الاختبار؛ وعندما تهم قابلية إعادة إنتاج النتائج، استخدم معرّف إصدار يدعمه حسابك. الأسماء المستعارة للنماذج

7. حدّد ما إذا كان سير العمل الأول جاهزًا

قبل تفعيل الإجراءات الآلية، احتفظ بمجموعة صغيرة من القرارات المتوقعة، وراجع الأخطاء، واختر العتبات المناسبة لسير عملك. استخدم حاسبة الأسعار لتقدير الإنفاق على رموز الإدخال، ودليل المقارنة لتحديد الأجزاء التي ينبغي أن تبقى مع أدوات أخرى.