الخدمة 5
الإبلاغ عن نتيجة خاطئة
POST
/insaf/prompts/improveإذا كانت نتيجة أي خدمة غير مضبوطة، أرسلها هنا كما هي مع توضيح ما الخطأ. يُخزَّن التقرير ويُستخدم لتصحيح الخدمة، فتُعالج الطلبات اللاحقة على نفس الحالة بشكل صحيح. لا يلزم أي deploy أو version أو config من جهتكم.
متاح لكل الخدمات: knowledge-answer و violation-classification و description-refinement و complaint-recommendation (ويمكن بإضافة insaf/ قبلها).
- •feedback مفيد: سمِّ الحقل (summary, scorecard, recommendations)، وأشر إلى العنصر الخاطئ، وقل ما المتوقع. مشكلة واحدة في كل تقرير. الكلام العام مثل "النتيجة سيئة" لا يحسّن شيئاً.
- •التقرير يُخزن فور وصوله فلا يضيع. نتيجته (طُبّق، لا تغيير، رُفض) تُسجل عندنا ولا ترجع في الـ API. duplicate معناها أن نفس الـ feedback طُبّق من قبل على نفس الخدمة.
- •لا يتغير بالـ feedback: شكل الـ response (الـ parsing عندكم آمن)، قائمة قرارات الهيئة، قواعد المرحلة الإجرائية، وكون الـ evidence حرفية من الملف.
جرّب الطلب
المفتاح يُحفظ في متصفحك فقط ويُرسل مع الطلب عند التجربة.
POSThttps://inbound-api-gateway.velents.ai
Request
| الحقل | النوع | مطلوب | الشرح |
|---|---|---|---|
service | string | إجباري | اسم الخدمة، مثلاً "complaint-recommendation". |
feedback | string | إجباري | ما الخطأ، من 10 إلى 20,000 حرف. |
response | any | إجباري | الـ body الذي رجع كما هو، دون قص أو تعديل. |
force | boolean | اختياري | الافتراضي false. لإعادة تطبيق تقرير أُرسل من قبل. |
activate | boolean | اختياري | الافتراضي true. إذا كان false يُحفظ التصحيح كـ version جديدة دون تفعيل. |
request
{
"service": "complaint-recommendation",
"feedback": "Every rule that scored zero came back with the same one-line reason. A rule that scores low should name the requirement that failed.",
"response": { "...": "the exact body returned by complaint-recommendation" }
}response
// 202 — يرجع فوراً والتصحيح يحدث في الخلفية. احتفظ بـ feedbackId
{
"status": "accepted",
"message": "Feedback stored. The prompt is being improved in the background.",
"feedbackId": 41,
"promptKey": "...",
"serviceName": "complaint-recommendation",
"basedOnVersion": 7
}
// أُرسل من قبل — يُسجل فقط ولا يضاعف التأثير
{
"status": "duplicate",
"message": "This feedback was already applied as #41. Send \"force\": true to run it again.",
"feedbackId": 42,
"duplicateOf": 41,
"promptKey": "...",
"serviceName": "complaint-recommendation",
"basedOnVersion": 7
}Errors
| Status | Code | السبب |
|---|---|---|
| 400 | INVALID_INPUT | حقل ناقص أو نوع خاطئ. |
| 400 | UNKNOWN_SERVICE | service غير معروف (retryable = false). |
| 403 | UNKNOWN_CLIENT | الـ key غير مرتبطة بعميل معروف. |
| 403 | PROMPT_NOT_OWNED | service تابع لشركة أخرى. |
| 503 | PROMPT_UNAVAILABLE / SCHEMA_OUT_OF_DATE | غير متاح مؤقتاً. أعد بعد قليل. |