افزودن مدل‌های تصمیم‌گیری Jev از TYPESAFE AI

Date: ۱۴۰۵-۰۸-۰۱ / (2026-10-23)

خلاصه

AvalAI اکنون مدل‌های تصمیم‌گیری Jev از TYPESAFE AI را از طریق /v1/decisions و /v1/systemone ارائه می‌دهد. این مدل‌ها برای مسیریابی، امتیازدهی و دسته‌بندی، پاسخ‌هایی با نوع مشخص برمی‌گردانند. هر دو نام مستعار قیمت یکسان دارند و راهنماها و مثال‌های دوزبانه برای ساخت گردش‌کارهای تصمیم‌گیری آماده شده‌اند.

---

جزئیات

TYPESAFE AI و Jev

Jev مدل پرچم‌دار System One از TYPESAFE AI است. این مدل به‌جای تولید پاسخ گفت‌وگویی، اطلاعات دریافتی را با پرسش‌هایی محدود و مشخص ارزیابی می‌کند و مقدارهایی برمی‌گرداند که کد برنامه می‌تواند از آن‌ها استفاده کند. مسیریابی درخواست‌های پشتیبانی، سنجش ارتباط قطعه‌های متن، بررسی استنادها، غربال محتوا و انتخاب از میان گزینه‌های مشخص از کاربردهای مناسب آن هستند.

برای آشنایی کامل، راهنمای ارائه‌دهنده TYPESAFE AI را بخوانید. نگاشت نام‌های مستعار AvalAI در این خبر به‌صورت زیر است:

نام مستعار AvalAI	نسخه پایه	نقاط پایانی
jev-preview	jev-1.13.0	/v1/decisions, /v1/systemone
jev-latest	jev-1.14.0	/v1/decisions, /v1/systemone

نام مستعار AvalAI را ارسال کنید؛ از نام نسخه پایه نمی‌توان نتیجه گرفت که همان شناسه مستقیماً در API پذیرفته می‌شود. این نگاشت‌ها ویژه AvalAI هستند و نام‌های مستعار خود TYPESAFE AI ممکن است به نسخه‌های دیگری اشاره کنند. پس از تغییر نام مستعار یا معیار ارزیابی، گردش‌کار خود را دوباره بسنجید.

دو قالب برای نقاط پایانی

رابط	فیلد اطلاعات	پرسش‌ها	نام انواع پرسش
Decisions	input	آرایه؛ هر پرسش می‌تواند name داشته باشد	predicate, choice, score
System One بومی	state	شیء با کلیدهایی برابر نام پرسش‌ها	noul, choice, score

پرسش Choice در قالب OpenAI از choices استفاده می‌کند و در قالب بومی از criteria. مثال کامل نقطه پایانی انتخاب‌شده را بردارید؛ تغییر نشانی به‌تنهایی کافی نیست. هر دو نقطه پایانی AvalAI از Authorization: Bearer $AVALAI_API_KEY در https://api.avalai.ir استفاده می‌کنند.

قالب Decisions رابطی مشترک برای مدل‌های تصمیم‌گیری فراهم می‌کند. این انتشار دو نام مستعار Jev را اضافه می‌کند. افزودن microsoft-decision-1 در آینده برنامه‌ریزی شده است؛ در این خبر دسترسی فعلی، قیمت یا پشتیبانی از نقطه پایانی برای آن اعلام نمی‌شود.

قیمت‌گذاری

قیمت‌ها به دلار آمریکا برای هر یک میلیون توکن هستند و برای هر دو نسخه یکسان‌اند:

مدل	ورودی	ورودی از حافظه نهان	خروجی
jev-preview	$0.042	$0.00	$0.00
jev-latest	$0.042	$0.00	$0.00

قیمت صفر خروجی به معنی رایگان بودن کل درخواست نیست. درخواست بومی ثبت‌شده در ادامه، ۳۳۳ توکن ورودی و هزینه دلاری $0.0000139860 را گزارش کرد. نرخ ورودی از حافظه نهان، شیوه محاسبه هزینه توکن‌هایی را مشخص می‌کند که واقعاً در این گروه حساب شده‌اند؛ این نرخ تضمین نمی‌کند که درخواست از حافظه نهان استفاده می‌کند یا پارامتر خاصی برای کنترل آن پشتیبانی می‌شود.

مثال درخواست و پاسخ API

System One بومی

این درخواست کوچک Choice در ۱ آبان ۱۴۰۵ (2026-10-23) با هر دو نام jev-latest و jev-preview از طریق AvalAI پاسخ HTTP 200 گرفت. برای استفاده از نام مستعار دیگر، مقدار model را به jev-preview تغییر دهید.

Bash

curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 30 \
  https://api.avalai.ir/v1/systemone \
  -H "Authorization: Bearer $AVALAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "jev-latest",
    "state": "I was charged twice. Please help.",
    "questions": {
      "route": {
        "type": "choice",
        "instructions": "Which team should handle this message?",
        "criteria": {
          "billing": "Payments or invoices",
          "technical": "Software or API problems",
          "other": "Anything else"
        }
      }
    }
  }'

پاسخ کامل JSON ثبت‌شده برای jev-latest:

{
  "model": "jev-latest",
  "answers": {
    "route": {
      "type": "choice",
      "choice": "billing",
      "confidence": 1.0,
      "probabilities": {
        "technical": 0.0,
        "other": 0.0
      }
    }
  },
  "usage": {
    "input_tokens": 333,
    "output_tokens": 38
  },
  "estimated_cost": {
    "unit": "0.0000139860",
    "irt": 3.78,
    "exchange_rate": 270000
  }
}

ساختار این نمونه دقیقاً مانند پاسخ دریافتی است: کلید انتخاب‌شده billing در probabilities وجود ندارد. مقدار صریح choice را بخوانید؛ احتمال حذف‌شده را صفر در نظر نگیرید و فرض نکنید مجموع مقدارهای این نگاشت برابر یک است. مرجع System One اعتبارسنجی و محدوده رفتار مشاهده‌شده را توضیح می‌دهد. تعداد توکن، احتمال، اطمینان، نرخ تبدیل ارز و هزینه به همان پاسخ مربوط‌اند.

Decisions با قالب OpenAI

درخواست هم‌معنی از input، آرایه پرسش‌ها و choices استفاده می‌کند:

Bash

curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 30 \
  https://api.avalai.ir/v1/decisions \
  -H "Authorization: Bearer $AVALAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "jev-latest",
    "input": "I was charged twice. Please help.",
    "questions": [
      {
        "type": "choice",
        "name": "route",
        "instructions": "Which team should handle this message?",
        "choices": [
          {"value": "billing", "description": "Payments or invoices"},
          {"value": "technical", "description": "Software or API problems"},
          {"value": "other", "description": "Anything else"}
        ]
      }
    ]
  }'

این درخواست در ۱ آبان ۱۴۰۵ (2026-10-23) با هر دو نام مستعار پاسخ HTTP 200 گرفت. پاسخ کامل ثبت‌شده برای jev-latest:

{
  "model": "jev-latest",
  "answers": [
    {
      "type": "choice",
      "name": "route",
      "choice": "billing",
      "probabilities": [
        {
          "value": "billing",
          "probability": 1.0
        },
        {
          "value": "technical",
          "probability": 0.0
        },
        {
          "value": "other",
          "probability": 0.0
        }
      ],
      "confidence": 1.0
    }
  ],
  "usage": {
    "input_tokens": 333,
    "input_tokens_details": {
      "cached_tokens": 0,
      "cache_write_tokens": 0
    },
    "output_tokens": 38,
    "output_tokens_details": {
      "reasoning_tokens": 0
    },
    "total_tokens": 371
  },
  "estimated_cost": {
    "unit": "0.0000139860",
    "irt": 3.78,
    "exchange_rate": 270000
  }
}

برخلاف نگاشت بومی، Decisions آرایه مرتب‌شده answers را برمی‌گرداند و در این پاسخ ثبت‌شده، احتمال گزینه انتخاب‌شده billing نیز وجود دارد. مرجع Decisions فیلدهای پاسخ، اعتبارسنجی و تفاوت ساختارهای دو رابط را توضیح می‌دهد.

بررسی زنده، هشت حالت درخواست را با هر دو نام مستعار پوشش داد: ۱۶ درخواست که همگی پاسخ HTTP 200 و جواب‌های نوع‌دار معتبر داشتند. درخواست اصلاح‌شده Choice، پرسش‌های Predicate و Score، انواع بومی، وضعیت مشترک JSON و بدنه‌های مثال‌های کاربردی بررسی شدند. این نتیجه همان مثال‌های ساختگی را تأیید می‌کند و اندازه‌گیری دقت روی داده‌های برنامه شما نیست.

ساخت گردش‌کارهای تصمیم‌گیری

برای انتخاب ساختار، طراحی پرسش، شناخت احتمال و اطمینان، بهترین شیوه‌ها و عیب‌یابی، از راهنمای مدل‌های تصمیم‌گیری شروع کنید. مثال‌های Jev یک نمونه کامل مسیریابی پشتیبانی با curl، Python، JavaScript، Go و PHP و دستورکارهایی برای بازیابی اطلاعات، استنادها، محافظ‌های محتوا و ترکیب تصمیم‌ها ارائه می‌کنند.

هر پرسش را به یک داوری مشخص محدود کنید و پاسخ‌ها را در کد برنامه ترکیب کنید. آستانه‌ها را با مثال‌های برچسب‌خورده از گردش‌کار خود، از جمله ورودی‌های فارسی در صورت نیاز، بسنجید. اطمینان نشانه‌ای از عدم قطعیت است و درستی پاسخ یا مجوز انجام عمل را تضمین نمی‌کند. نتیجه مبهم یا نامعتبر را برای بازبینی بفرستید و فقط در خطاهای گذرای ارتباط یا سرویس، تلاش مجدد محدود انجام دهید.

قابلیت‌های تصویر، پرسش Box، زمینه گسترده و گزینه‌های SDK ارائه‌دهنده به بررسی سازگاری جداگانه با AvalAI نیاز دارند. وجود آن‌ها در مستندات TYPESAFE AI به معنی پشتیبانی در مثال‌های این انتشار نیست.

پیوندهای مرتبط

• ارائه‌دهنده TYPESAFE AI، نام‌های مستعار و قیمت‌ها
• مرجع API Decisions
• مرجع API بومی System One
• راهنمای مدل‌های تصمیم‌گیری و عیب‌یابی
• گردش‌کارهای تصمیم‌گیری با Jev