خروجی ساخت‌یافته

System One

شکل بومی System One برای مدل‌های تصمیم‌گیری: پرسش‌ها یک شیء با شناسه‌اند و پاسخ‌ها هم شیئی با همان شناسه‌ها برمی‌گردند.

POST/v1/systemone

این مسیر همان کار /v1/decisions را با طرح بومی System One انجام می‌دهد. تفاوت‌ها:

  • شواهد در state می‌آید (رشته، شیء یا آرایه).
  • questions شیئی است که کلید هر پرسش شناسه‌ی آن است (حروف، رقم و _ . -، تا ۱۰۰ نویسه) و بین ۱ تا ۶۴ پرسش دارد.
  • نوع گزاره noul نام دارد، نه predicate.
  • گزینه‌های choice در criteria به‌صورت شیء { گزینه: توضیح } می‌آیند و سطح‌های score به‌صورت آرایه‌ی مرتب توضیح‌ها.
  • پاسخ هم شیئی با همان شناسه‌هاست، نه آرایه.

فقط مدل‌های دسته‌ی تصمیم‌گیری پذیرفته می‌شوند؛ مدل چت (مثل openai/gpt-6-luna) اینجا کار نمی‌کند و باید از /v1/decisions استفاده کند. این مسیر استریم ندارد.

نمونه‌ها

curl https://1ai.ir/v1/systemone \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "typesafe/jev-latest",
  "state": "My order was charged twice and it still has not arrived.",
  "questions": {
    "urgent": {
      "type": "noul",
      "instructions": "Is this request urgent?"
    },
    "team": {
      "type": "choice",
      "instructions": "Which team should answer?",
      "criteria": {
        "billing": "Payments and refunds",
        "shipping": "Delivery and tracking",
        "other": null
      }
    },
    "anger": {
      "type": "score",
      "instructions": "How unhappy is the customer?",
      "criteria": [
        "calm",
        "unhappy",
        "furious"
      ]
    }
  }
}'
200پاسخ
{
  "model": "typesafe/jev-latest",
  "answers": {
    "urgent": {
      "type": "noul",
      "noul": 0.96
    },
    "team": {
      "type": "choice",
      "choice": "billing",
      "confidence": 0.77,
      "probabilities": {
        "billing": 0.9
      }
    },
    "anger": {
      "type": "score",
      "score": 1.6,
      "confidence": 0.52,
      "probabilities": {
        "0": 0.08,
        "1": 0.24,
        "2": 0.68
      }
    }
  },
  "usage": {
    "input_tokens": 199,
    "output_tokens": 0,
    "total_tokens": 199
  }
}

بدنه‌ی درخواست

  • modelstringالزامی

    شناسه‌ی مدل تصمیم‌گیری.

  • statestring | object | arrayالزامی

    شواهدی که پرسش‌ها درباره‌ی آن‌اند. رشته تا ۵۰۰٬۰۰۰ نویسه، یا شیء، یا آرایه تا ۱۰۰۰ عنصر.

  • questionsobjectالزامی

    شیء پرسش‌ها، با ۱ تا ۶۴ کلید. هر مقدار یک پرسش است با فیلدهای زیر.

    ویژگی‌های داخلی
    • typestringالزامی

      نوع پرسش.

      مقادیر مجاز:choicescorenoul
    • instructionsstring | object | array

      متن پرسش. می‌تواند null هم باشد.

    • criteriaobject | array

      برای choice شیء { گزینه: توضیح یا null }، برای score آرایه‌ی مرتب توضیح سطح‌ها (۱ تا ۱۰ مورد).

  • streamboolean

    فقط false پذیرفته می‌شود.

خطاها

  • invalid_request400

    بدنه معتبر نیست؛ مثلاً شناسه‌ی پرسش نامعتبر، choices به‌جای criteria، یا شکل اشتباه criteria.

  • model_kind_mismatch400

    مدل از دسته‌ی تصمیم‌گیری نیست.

  • insufficient_credits402

    اعتبار برای این درخواست کافی نیست.

  • model_not_found404

    مدل وجود ندارد یا به آن دسترسی ندارید.

صفحه‌های مرتبط