پرامپت و بازخورد

ثبت بازخورد برای یک درخواست

برای یکی از درخواست‌های خودتان نمره و توضیح ثبت کنید تا کیفیت پاسخ‌ها را دنبال کنید. این مسیر هزینه‌ای ندارد.

POST/v1/feedback

بازخورد به یک درخواست پیشین شما وصل می‌شود. درخواست را یا با request_id مشخص کنید (همان مقدار هدر x-request-id پاسخ)، یا با trace_id که پیشتر در هدر x-1ai-trace-id همان درخواست فرستاده‌اید؛ در حالت دوم جدیدترین درخواست با آن trace_id انتخاب می‌شود. باید دست‌کم یکی از این دو را بدهید.

فقط به درخواست‌های حساب خودتان می‌توانید بازخورد بدهید؛ درخواست دیگران 404 request_not_found است.

value عدد صحیح از ۱۰- تا ۱۰ است و معنایش با شماست (مثلاً ۱ و ۱- برای خوب و بد). weight وزن این بازخورد را در جمع‌بندی می‌گذارد.

نمونه‌ها

curl https://1ai.ir/v1/feedback \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "request_id": "6f1d1c52-2a0e-4c3a-9a6e-0d2f6b7c9e11",
  "value": 1,
  "comment": "Correct and concise.",
  "metadata": {
    "ui": "web",
    "reviewer": "qa-team"
  }
}'
201پاسخ
{
  "id": "fbk_5RzKb8TwXq3NfYhG2mCeVu",
  "object": "feedback",
  "request_id": "6f1d1c52-2a0e-4c3a-9a6e-0d2f6b7c9e11",
  "value": 1,
  "weight": 1,
  "comment": "Correct and concise.",
  "metadata": {
    "ui": "web",
    "reviewer": "qa-team"
  },
  "created_at": "2026-11-08T10:15:30.000Z"
}

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

  • request_idstring

    شناسه‌ی درخواست، تا ۱۲۸ نویسه. اگر trace_id نباشد، لازم است.

  • trace_idstring

    شناسه‌ی ردیابی که در هدر x-1ai-trace-id فرستاده‌اید، تا ۱۲۸ نویسه. اگر request_id نباشد، لازم است.

  • valueintegerالزامی

    نمره، از ۱۰- تا ۱۰.

  • weightnumberپیش‌فرض: 1

    وزن بازخورد، از ۰ تا ۱۰۰.

  • commentstring

    توضیح آزاد، تا ۵۰۰۰ نویسه.

  • metadataobject

    داده‌های دلخواه شما که همراه بازخورد نگه‌داری و برگردانده می‌شود.

خطاها

  • invalid_request400

    value بیرون از بازه است، یا نه request_id آمده نه trace_id.

  • request_not_found404

    درخواستی از شما با این شناسه نیست.

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