Source: https://ailoot.ai/docs/ar/api/systemone/
Canonical: https://ailoot.ai/docs/ar/api/systemone/
Language: ar

[API](https://ailoot.ai/docs/ar/) 

# Jev — نموذج لاتخاذ القرارات

[Markdown](https://ailoot.ai/docs/ar/api/systemone/index.md)

يجيب نموذج القرارات Jev من TypeSafe عن أسئلة ذات أنواع محددة حول نص أو JSON: اختيار بديل، أو تقييم على مقياس، أو «نعم/لا» مع احتمالات. لا يقدم دردشة ولا يولّد نصوصاً.

POST`https://api.ailoot.ai/v1/systemone`

Jev — نموذج لاتخاذ القرارات

```bash
curl https://api.ailoot.ai/v1/systemone \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "النجدة! تفشل عمليات الصرف لدي منذ 3 أيام.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "هل يدل هذا على وجود حاجة ملحّة؟"
      }
    }
  }' 
```

```python
import json, os, urllib.request

body = {
    "model": "jev-latest",
    "state": "النجدة! تفشل عمليات الصرف لدي منذ 3 أيام.",
    "questions": {
        "is_urgent": {"type": "noul", "instructions": "هل يدل هذا على وجود حاجة ملحّة؟"},
    },
}
req = urllib.request.Request(
    "https://api.ailoot.ai/v1/systemone",
    data=json.dumps(body).encode(),
    headers={"Authorization": "Bearer " + os.environ["AILOOT_API_KEY"],
             "Content-Type": "application/json"},
)
with urllib.request.urlopen(req, timeout=60) as resp:
    result = json.load(resp)
print(result["answers"]["is_urgent"]["noul"])  # 0.95
```

```js
const resp = await fetch("https://api.ailoot.ai/v1/systemone", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AILOOT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "jev-latest",
    state: "النجدة! تفشل عمليات الصرف لدي منذ 3 أيام.",
    questions: {
      is_urgent: { type: "noul", instructions: "هل يدل هذا على وجود حاجة ملحّة؟" },
    },
  }),
});
const result = await resp.json();
if (!resp.ok) throw new Error(`${resp.status} ${JSON.stringify(result)}`);
console.log(result.answers.is_urgent.noul); // 0.95
```

200 OK

```json
{
  "model": "jev-1.13.0",
  "answers": {
    "is_urgent": {
      "type": "noul",
      "noul": 0.95
    }
  },
  "usage": { "input_tokens": 296, "output_tokens": 20 }
}
```

Jev نموذج لاتخاذ القرارات من فئة System One، من TypeSafe. لا يكتب نصوصاً ولا يجري محادثات: ترسل إليه **الحالة** (`state`) — كنص أو JSON — ومجموعة من **الأسئلة**، وتتلقى قيماً ذات أنواع محددة مع احتمالات. يستند الكود إليها مباشرةً للتفرّع والفرز والتوجيه، دون الحاجة إلى تحليل نص حر.

تُقيّم جميع أسئلة الطلب الواحد بالتوازي وباستقلال عن بعضها، بالاستناد إلى `state`نفسه. بحسب TypeSafe، لا تؤثر إضافة الأسئلة تقريباً في زمن الرد، ولا تتداخل الأسئلة مع بعضها.

| العنصر | باختصار |
| --- | --- |
| النموذج | `jev-latest` — اسم بديل لأحدث إصدار مستقر من Jev؛ [بطاقة النموذج في الكتالوج](https://ailoot.ai/models/ar/#m=jev-latest) |
| الطريقة | `POST /v1/systemone`. ليست هذه دردشة: صيغ OpenAI وAnthropic وGemini لا تصلح لـJev. يصل الرد كاملاً في كائن JSON واحد |
| المدخلات المقبولة | النص فقط: سلسلة نصية أو كائن JSON أو مصفوفة نصوص. حوّل الصور والصوت والفيديو إلى نص أولاً |
| السياق | 64K توكن لكل طلب — state وجميع الأسئلة معاً؛ وstate مع أطول سؤال حتى 32K |
| اللغة | بحسب TypeSafe، يعمل النموذج بأعلى دقة باللغة الإنجليزية؛ ويقبل لغات أخرى بدقة أقل — اختبره على بياناتك |
| السعر | الإدخال $0.084 لكل مليون توكن، والمخرجات مجانية |

## [](https://ailoot.ai/docs/ar/api/systemone/#request)طلب

### المصادقة

| المعامل | النوع | مطلوب | الوصف |
| --- | --- | --- | --- |
| `Authorization` | header | مطلوب | مفتاح Ailoot بصيغة `Bearer sk-…`. |

### جسم الطلب

| المعامل | النوع | مطلوب | الوصف |
| --- | --- | --- | --- |
| `model` | string | مطلوب | `jev-latest`. |
| `state` | string \| object \| array | مطلوب | المحتوى المراد تقييمه: سلسلة نصية أو JSON، مثل طلب العميل أو سجل من قاعدة بيانات أو مراسلات أو الحالة الحالية لتطبيقك. يكون الكائن ذو أسماء الحقول الواضحة عادةً أنسب من سلسلة واحدة. |
| `questions` | object | مطلوب | الأسئلة. تختار المفاتيح بنفسك وتأتي الإجابات تحت المفاتيح نفسها؛ ولا يؤثر المفتاح في الإجابة، فالسؤال نفسه يُحدَّد في `instructions`. |
| `questions.*.type` | string | مطلوب | `noul`, `choice` أو `score` — انظر أدناه. |
| `questions.*.instructions` | string \| object \| array | مطلوب | السؤال نفسه. يمكن إرسال السؤال الطويل مع بياناته ككائن: السؤال في حقل والبيانات في حقول أخرى؛ أشر إلى أسماء الحقول باستخدام علامات الاقتباس الخلفية. |
| `questions.*.criteria` | object \| array |  | خيارات الإجابة تختلف بحسب النوع: وصفا «نعم» و«لا» في noul (اختياريان)، وقاموس خيارات في choice، وقائمة مرتبة من المستويات في score. |

## [](https://ailoot.ai/docs/ar/api/systemone/#question-types)أنواع الأسئلة

| النوع | ما الذي يسأل عنه | ما الذي يعيده |
| --- | --- | --- |
| `noul` | هل العبارة صحيحة: نعم أم لا | `noul` — احتمال «نعم» من 0 إلى 1 |
| `choice` | أي خيار من الخيارات المحددة مناسب | `choice`, `probabilities`, `confidence` |
| `score` | موضع state على مقياس مستوياتك | `score`, `legend`, `probabilities`, `confidence` |

يمكن الجمع بين الأنواع في طلب واحد.

### noul — نعم أم لا

الحقل `criteria` اختياري: يمكن فيه توضيح معنى «نعم» (`true`) و«لا» (`false`). قيمة الرد `noul` — عدد من 0 (لا) إلى 1 (نعم).

```json
"is_urgent": {
  "type": "noul",
  "instructions": "هل يدل هذا على وجود حاجة ملحّة؟",
  "criteria": {
    "true": "الإلحاح الزمني مذكور صراحةً",
    "false": "لم يُعبَّر عن استعجال"
  }
}
```

```json
"is_urgent": {
  "type": "noul",
  "noul": 0.95
}
```

### choice — اختيار بديل

`criteria` — قاموس «الخيار ← الوصف»؛ إذا لم تكن بحاجة إلى وصف، استخدم `null`. حتى 255 خياراً. في الرد، `choice` — الخيار الأكثر احتمالاً، و `probabilities` — احتمال كل خيار (مجموعها 1)، و `confidence` — درجة الثقة من 0 إلى 1.

```json
"department": {
  "type": "choice",
  "instructions": "أي فريق ينبغي أن يتولى هذا؟",
  "criteria": {
    "billing": "المدفوعات وإصدار الفواتير وردّ المبالغ",
    "technical": "الأخطاء وانقطاعات الخدمة والتكاملات",
    "sales": "الأسعار والترقيات والعملاء الجدد"
  }
}
```

```json
"department": {
  "type": "choice",
  "choice": "billing",
  "probabilities": { "billing": 0.88, "technical": 0.12, "sales": 0.0 },
  "confidence": 0.81
}
```

### score — تقييم على مقياس

`criteria` — مستويات مرتبة من الأدنى إلى الأعلى، بحد أقصى 10 (توصي TypeSafe بمستويين على الأقل). في الرد، `score` — قيمة مرجّحة باحتمالات المستويات (قد تقع بين مستويين)، و `legend` — رقم المستوى ووصفه، و `probabilities` و `confidence`. بحسب TypeSafe، `score` مناسب للمقارنة مع عتبة، لكنه غير مناسب لتحديد رقم دقيق بين المستويات.

```json
"frustration": {
  "type": "score",
  "instructions": "ما مدى استياء العميل؟",
  "criteria": ["هادئ", "مستاء", "غاضب جدًا"]
}
```

```json
"frustration": {
  "type": "score",
  "score": 1.05,
  "legend": { "0": "هادئ", "1": "مستاء", "2": "غاضب جدًا" },
  "probabilities": { "0": 0.0, "1": 0.95, "2": 0.05 },
  "confidence": 0.92
}
```

## [](https://ailoot.ai/docs/ar/api/systemone/#response)الرد

| المعامل | النوع | مطلوب | الوصف |
| --- | --- | --- | --- |
| `model` | string |  | إصدار النموذج الذي أجاب. ينتقل الاسم البديل jev-latest مع الوقت إلى إصدارات جديدة: إذا ضبطت عتبات `confidence` لإصدار محدد، فراقب هذا الحقل. |
| `answers` | object |  | إجابة واحدة لكل سؤال، تحت المفاتيح نفسها. تحتوي كل إجابة على `type`، وفي choice وscore تحتوي أيضاً على `confidence`. |
| `usage` | object |  | `input_tokens` و `output_tokens`. تُحسب تكلفة توكنات الإدخال فقط. |

`confidence` مناسب للاستخدام كعتبة: عند إجابة عالية الثقة، تصرف تلقائياً؛ وعند إجابة منخفضة الثقة، أحلها إلى شخص أو نموذج كبير للمراجعة. تحدد الإجابة ما تختاره، وتحدد `confidence` ما إذا كان ينبغي التصرف.

## [](https://ailoot.ai/docs/ar/api/systemone/#many-questions)عدة أسئلة في طلب واحد

اجمع كل الأسئلة المتعلقة بـstate واحد في طلب واحد: تُقيّم بالتوازي ويُرسل state مرة واحدة. بحسب TypeSafe، كان الطلب الموحّد في مثالهم ذي 13 سؤالاً أرخص بـ12,2 مرة وأسرع بـ10 مرات من إرسال 13 طلباً منفصلاً بالتتابع، مع الإجابات نفسها.

يُفضّل تقسيم الحكم المعقّد إلى أسئلة بسيطة وتجميع الإجابات في الكود: مثلاً بدلاً من «قيّم الطلب»، قيّم السوق وقابلية التنفيذ والاختلاف عن المنافسين كلّاً على حدة. عندئذ تتغير الأوزان في الكود بدلاً من نص السؤال.

```json
{
  "model": "jev-latest",
  "state": "النجدة! تفشل عمليات الصرف لدي منذ 3 أيام.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "أي فريق ينبغي أن يتولى هذا؟",
      "criteria": {
        "billing": "المدفوعات وإصدار الفواتير وردّ المبالغ",
        "technical": "الأخطاء وانقطاعات الخدمة والتكاملات",
        "sales": "الأسعار والترقيات والعملاء الجدد"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "ما مدى استياء العميل؟",
      "criteria": ["هادئ", "مستاء", "غاضب جدًا"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "هل يدل هذا على وجود حاجة ملحّة؟"
    }
  }
}
```

## [](https://ailoot.ai/docs/ar/api/systemone/#use-cases)حالات الاستخدام المناسبة

- **التوجيه.** إرسال طلب العميل إلى القسم المناسب، وإرسال الطلب إلى المعالج المناسب: كود بسيط أو نموذج كبير أو شخص.
- **الفرز وتحديد الأولويات.** درجة الاستعجال والنبرة والمخاطر — على مقياس، مع عتبات في الكود.
- **الإشراف والفحص.** التحقق مما إذا كانت الرسالة تخالف القواعد، أو المصدر يؤيد الاقتباس، أو المستند يتضمن إجابة السؤال، قبل تمرير النص إلى المرحلة التالية.
- **التقييم والترتيب.** تقييم المستندات أو المرشحين أو المقاطع المسترجعة وفق معاييرك، ثم تحديد ما ينتقل إلى المرحلة التالية في الكود.
- **بديل للتعليمة غير الموثوقة «أعد JSON».** استدعاء يعيد قيماً ذات أنواع محددة بحكم تصميمه، بدلاً من نص يحتاج إلى تحليل.

## [](https://ailoot.ai/docs/ar/api/systemone/#not-for)حالات الاستخدام غير المناسبة

- **الدردشة والردود للمستخدم وتوليد النصوص أو الكود.** لا يكتب Jev نصوصاً؛ ولهذا تتوفر [النماذج النصية](https://ailoot.ai/models/ar/?kind=text).
- **نموذج لـClaude Code وCursor وغيرهما من الوكلاء.** لا يمكنك وضع jev-latest بدلاً من نموذج الوكيل: يحتاج الوكيل إلى نموذج يكتب نصوصاً ويستدعي أدوات. يمكن استدعاء Jev من الكود الذي يكتبه الوكيل لك.
- **الحساب والعدّ ومقارنة التواريخ.** بحسب TypeSafe، من الأوثق تنفيذ ذلك في الكود، وسؤال النموذج عن الجانب الدلالي فقط؛ مثلاً استخراج أجزاء التاريخ عبر choice.
- **الصور والصوت والفيديو.** يقبل النموذج النص فقط؛ حوّل هذه البيانات إلى نص مسبقاً.

يعمل النموذج أفضل عندما يتناول كل سؤال حكماً واحداً محدداً وضيق النطاق. اكتب الشرط مباشرةً: بحسب TypeSafe، يفهم النموذج السؤال حرفياً، وتقل الدقة مع state كبير يتضمن بيانات زائدة؛ صفِّ هذه البيانات في الكود.

## [](https://ailoot.ai/docs/ar/api/systemone/#price)السعر

تُحسب تكلفة توكنات الإدخال فقط — الحقل `usage.input_tokens` في الرد: **$0.084 لكل مليون**. توكنات المخرجات مجانية.

تكلفة الطلب في مثال هذه الصفحة (296 توكن إدخال) أقل من $0.0001.

يحجز Ailoot مبلغاً من الرصيد قبل الطلب، وبعد الرد يخصم مرة واحدة بحسب الاستخدام الفعلي — [آلية العمل](https://ailoot.ai/docs/ar/billing/reserve/).

## [](https://ailoot.ai/docs/ar/api/systemone/#limits)الحدود

| العنصر | الحد |
| --- | --- |
| الطلب بأكمله: state وجميع الأسئلة | 64K توكن |
| state مع أطول سؤال | 32K توكن |
| خيارات choice الواحد | حتى 255 |
| مستويات score الواحد | من 2 إلى 10 |
| الإدخال | نص فقط: سلسلة نصية أو كائن JSON أو مصفوفة نصوص |

حدود النموذج بحسب TypeSafe. تسري قيود مفتاحك ورصيدك كما في أي نموذج Ailoot: [الأخطاء والحدود](https://ailoot.ai/docs/ar/errors/).

## [](https://ailoot.ai/docs/ar/api/systemone/#errors)الأخطاء

تأتي الأخطاء بالصيغة العامة لـAiloot API: رمز ونص مفهوم وRequest ID. أكثر الأخطاء شيوعاً في هذه الطريقة:

| الرمز | متى يحدث | الإجراء المطلوب |
| --- | --- | --- |
| **400** `invalid_request` | فشل التحقق من جسم الطلب: state أوmodel أوquestions مفقود، أوtype غير معروف، أو أكثر من 255 خياراً في choice، أو أكثر من 10 مستويات في score | صحح الطلب وفق نص الخطأ: سيفشل مرة أخرى دون تصحيح |
| **400** `context_length_exceeded` | يتجاوز state والأسئلة معاً حد النموذج | صفِّ state في الكود وأبقِ ما تحتاجه الأسئلة |
| **401** `invalid_api_key` | المفتاح مفقود أو غير صحيح | أرسل المفتاح في ترويسة Authorization |
| **402** `insufficient_balance` | الرصيد المتاح غير كافٍ للحجز | اشحن الرصيد |
| **404** `model_not_found`, `unsupported_endpoint` | معرّف ID غير صحيح أو استُدعي النموذج بطريقة غير مناسبة، مثل /v1/chat/completions | استدعِ jev-latest عبر POST /v1/systemone فقط |
| **429** `rate_limit_exceeded` | عدد الطلبات كبير جداً | انتظر عدد الثواني المحدد في ترويسة Retry-After ثم أعد المحاولة |
| **503** `model_overloaded`, `model_unavailable` | النموذج مثقل مؤقتاً أو غير متاح | إذا كانت X-Should-Retry: true، فأعد المحاولة بعد عدد الثواني في Retry-After؛ وإذا كانت false، فتحقق أولاً من Request ID في السجل |
| **504** `model_timeout` | لم يرد النموذج في الوقت المحدد | لا تُعد إرسال الطلب حتى تتحقق من Request ID في السجل |

القائمة الكاملة للرموز متاحة في صفحة [الأخطاء والحدود](https://ailoot.ai/docs/ar/errors/).

هل لديك أسئلة أخرى؟ أرسل Request ID ووصفاً للمشكلة وسنساعدك على فهمها.[مراسلة الدعم](mailto:support@ailoot.ai)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.