تصمیم‌ها

تصمیم‌های تایپ‌دار از Jev: احتمال بله یا خیر، انتخاب گزینه، امتیاز و کادر در تصویر.

گرفتن تصمیم

POST

https://api.hoosha.com/v1

/decisions

state و questions نام‌گذاری‌شده را به Jev می‌فرستد و برای هر سؤال یک پاسخ تایپ‌دار برمی‌گرداند که با نام همان سؤال مشخص می‌شود.

گرفتن تصمیم › body درخواست

فیلدهایی که اینجا فهرست نشده‌اند با 400 unsupported_parameter رد می‌شوند، به‌جز فیلدهایی که با مقدار null فرستاده شوند.

DecisionRequest

model

string · enum · الزامی

آیدی یک مدل تصمیم.

مقادیر مجاز:

jev-1.14

الزامی

محتوایی که باید ارزیابی شود، به صورت string یا آبجکت یا آرایه JSON.

object · minProps: 1 · maxProps: 64 · الزامی

سؤال‌ها با نامی که خودتان انتخاب می‌کنید، 1 تا 128 کاراکتر. هر پاسخ با همان نام برمی‌گردد.

object · minProps: 1 · maxProps: 16

تصویرها با string رفرنس که هر جا تصویر لازم است در state، instructions یا criteria می‌نویسید. به هر asset باید دست‌کم یک بار رفرنس داده شود.

user

string · maxLength: 256

آیدی‌ای برای کاربر نهایی شما. پیش از رسیدن به پرووایدر مدل هش می‌شود.

گرفتن تصمیم › پاسخ‌ها

یک پاسخ تایپ‌دار برای هر سؤال، با نام همان سؤال.

Decision

id

string · الزامی

model

string · الزامی

object · الزامی

یک پاسخ برای هر سؤال، با نام همان سؤال.

object · الزامی

POST/decisions

curl https://api.hoosha.com/v1/decisions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "model": "jev-1.14",
  "state": "I was charged twice for my subscription. Please refund the extra charge.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    },
    "team": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Charges and refunds",
        "technical": "Bugs and outages"
      }
    },
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this message?",
      "criteria": [
        "Can wait",
        "Needs attention this week",
        "Needs attention today"
      ]
    }
  }
}'

نمونه body درخواست

{
  "model": "jev-1.14",
  "state": "I was charged twice for my subscription. Please refund the extra charge.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    },
    "team": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Charges and refunds",
        "technical": "Bugs and outages"
      }
    },
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this message?",
      "criteria": [
        "Can wait",
        "Needs attention this week",
        "Needs attention today"
      ]
    }
  }
}

json

application/json

نمونه پاسخ‌ها

{
  "id": "dec-3c1f0f6e2a444f6e9c2b8a1d5e77b901",
  "model": "jev-1.14",
  "answers": {
    "refund": {
      "type": "noul",
      "noul": 0.98
    },
    "team": {
      "type": "choice",
      "choice": "billing",
      "confidence": 0.9,
      "probabilities": {
        "billing": 0.95,
        "technical": 0.05
      }
    },
    "urgency": {
      "type": "score",
      "score": 1.7,
      "confidence": 0.55,
      "legend": {
        "0": "Can wait",
        "1": "Needs attention this week",
        "2": "Needs attention today"
      },
      "probabilities": {
        "0": 0.1,
        "1": 0.1,
        "2": 0.8
      }
    }
  },
  "usage": {
    "input_tokens": 412,
    "output_tokens": 30,
    "cost_credits": 0.0021
  }
}

json

application/json

مدل‌ها

گرفتن تصمیم

POST

https://api.hoosha.com/v1

/decisions

گرفتن تصمیم › body درخواست

فیلدهایی که اینجا فهرست نشده‌اند با 400 unsupported_parameter رد می‌شوند، به‌جز فیلدهایی که با مقدار null فرستاده شوند.

DecisionRequest

model

string · enum · الزامی

آیدی یک مدل تصمیم.

مقادیر مجاز:

jev-1.14

الزامی

محتوایی که باید ارزیابی شود، به صورت string یا آبجکت یا آرایه JSON.

object · minProps: 1 · maxProps: 64 · الزامی

سؤال‌ها با نامی که خودتان انتخاب می‌کنید، 1 تا 128 کاراکتر. هر پاسخ با همان نام برمی‌گردد.

object · minProps: 1 · maxProps: 16

user

string · maxLength: 256

آیدی‌ای برای کاربر نهایی شما. پیش از رسیدن به پرووایدر مدل هش می‌شود.

گرفتن تصمیم › پاسخ‌ها

یک پاسخ تایپ‌دار برای هر سؤال، با نام همان سؤال.

Decision

id

string · الزامی

model

string · الزامی

object · الزامی

یک پاسخ برای هر سؤال، با نام همان سؤال.

object · الزامی