خروجی ساختیافته
System One
شکل بومی System One برای مدلهای تصمیمگیری: پرسشها یک شیء با شناسهاند و پاسخها هم شیئی با همان شناسهها برمیگردند.
/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"
]
}
}
}'{
"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الزامینوع پرسش.
مقادیر مجاز:choicescorenoulinstructionsstring | object | arrayمتن پرسش. میتواند
nullهم باشد.criteriaobject | arrayبرای
choiceشیء{ گزینه: توضیح یا null }، برایscoreآرایهی مرتب توضیح سطحها (۱ تا ۱۰ مورد).
streambooleanفقط
falseپذیرفته میشود.
خطاها
invalid_request400بدنه معتبر نیست؛ مثلاً شناسهی پرسش نامعتبر،
choicesبهجایcriteria، یا شکل اشتباهcriteria.model_kind_mismatch400مدل از دستهی تصمیمگیری نیست.
insufficient_credits402اعتبار برای این درخواست کافی نیست.
model_not_found404مدل وجود ندارد یا به آن دسترسی ندارید.