الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

نظرة عامة

استخدم هذه النقطة النهائية للإبلاغ عن استجابة مخزنة مؤقتًا كانت غير صحيحة أو قديمة أو غير ذات صلة أو غير آمنة لإعادة الاستخدام. عندما تتراكم على إدخال ما ملاحظات سلبية كافية، يمكن لـ TokenLab إبطاله تلقائيًا.

ملاحظات

  • تتطلب المصادقة مفتاحًا قياسيًا من واجهة API الخاصة بالاستدلال.
  • يجب أن يكون cache_entry_id معرّف request/cache entry ناتجًا عن cache hit ومملوكًا لمؤسسة مفتاح API الحالي. المعرّفات العشوائية تُرجع 404، ومعرّفات مؤسسة أخرى تُرجع 403.
  • يقبل feedback_type القيم wrong_answer وoutdated وirrelevant وother.
  • request_id اختياري؛ عند إرساله يجب أن يطابق cache_entry_id.
  • description سياق حر اختياري للمشغلين وعمليات التدقيق.

الطلب / الاستجابة

استخدم لوحة OpenAPI التفاعلية أعلاه لمعرفة المخطط الدقيق وحقول الاستجابة.

مثال

curl -X POST "https://api.tokenlab.sh/v1/cache/feedback" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "cache_entry_id": "req_1234567890",
    "feedback_type": "wrong_answer",
    "request_id": "req_1234567890",
    "description": "كانت الإجابة المخزنة مؤقتًا تشير إلى جدول أسعار قديم."
  }'
{
  "object": "cache.feedback",
  "recorded": true,
  "invalidated": false,
  "stats": {
    "negative_feedback_count": 1,
    "total_hit_count": 18,
    "negative_feedback_rate": 0.0556
  }
}