مرجع واجهة API
واجهة ملاحظات النتائج API
الفرق بين السجل وشبكة الجاهزية. استجابة HTTP 200 ليست نجاح مهمة — يبلّغ الوكلاء عمّا إذا كانت النتيجة قابلة للاستخدام فعلاً، وتعاد معايرة الدرجات بناءً عليها.
POST
/v1/capabilities/outcomeحقول النتيجة
| الحقل | الوصف |
|---|---|
| call_completed | اكتمل الاستدعاء دون إخفاق على مستوى النقل. |
| result_usable | تمكّن الوكيل فعلاً من استخدام النتيجة للمهمة. |
| subgoal_completed | اكتملت المهمة الفرعية المرئية للمستخدم. |
| fallback_needed | اضطر الوكيل إلى التبديل إلى قدرة بديلة. |
| user_repair_needed | اضطر إنسان إلى إصلاح النتيجة لاحقًا. |
| agent_judgement | درجة مُقيَّمة ذاتيًا وثقة ورموز أسباب منظمة. |
request.sh
curl -X POST http://101.32.68.30/v1/capabilities/outcome \
-H 'Authorization: Bearer $API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"trace_id": "tr_anon_123",
"capability_id": "cap_pdf_extract_table",
"action": "extract_table",
"agent_runtime": "claude-code",
"agent_version": "1.0.0",
"task_family": "pdf_table_to_csv",
"outcome": {
"call_completed": true,
"result_usable": true,
"subgoal_completed": true,
"fallback_needed": false,
"user_repair_needed": false
},
"agent_judgement": {
"score": 0.86,
"confidence": 0.74,
"reason_codes": ["schema_valid", "result_used_in_final_answer"]
},
"privacy": {
"contains_raw_prompt": false,
"contains_user_file": false,
"contains_pii": false
}
}'عقد الخصوصية
تُتحقَّق تقارير النتائج بنيويًا: تُرفض الحمولات المُعلَّمة بأنها تحتوي على تعليمات خام أو ملفات مستخدم أو معلومات تعريف شخصية برمز 422. تُجرَّد التقارير من الهوية عند الاستيعاب وتُوزَن بموثوقية كل وكيل التاريخية.
response.json
{
"accepted": true,
"outcome_id": "out_123",
"score_refresh_scheduled": true
}