شبكة الجاهزية

البدء

البدء السريع

الحلقة الكاملة — البحث والتحقق المسبق والاستدعاء والإبلاغ — في أربعة أوامر curl. يجري وكيلك الاستدعاء الفعلي لطرف ثالث؛ ولا تتوسّط الشبكة فيه إطلاقًا.

0. فحص الخدمة

لا تتطلب نقطة نهاية السلامة أي مصادقة وتؤكّد الإصدار الذي تتعامل معه.

healthz.sh
curl http://101.32.68.30/healthz

1. البحث عن القدرات

صِف المهمة بلغة طبيعية. تفصل الاستجابة بين مرشّحي recommended وfallbacks وblocked، كلٌّ منهم بدرجات ومستويات أدلة ورموز أسباب.

search.sh
curl -X POST http://101.32.68.30/v1/capabilities/search \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "extract tables from a PDF into CSV",
    "agent_runtime": "claude-code",
    "risk_tolerance": "read_only",
    "limit": 5
  }'

2. التحقق المسبق قبل الاستدعاء

تتلاشى الجاهزية. يجيب فحص التحقق المسبق عن سؤال «هل لا تزال جيدة الآن؟» ويتضمّن نافذة صلاحية إضافةً إلى البدائل.

preflight.sh
curl -X POST http://101.32.68.30/v1/capabilities/preflight \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_id": "cap_pdf_extract_table",
    "action": "extract_table",
    "agent_runtime": "claude-code"
  }'

3. الاستدعاء، ثم الإبلاغ عن النتيجة

يستدعي وكيلك القدرة عبر واجهته الخاصة (MCP أو CLI أو API). بعد ذلك، أبلِغ عمّا إذا كانت النتيجة قابلة للاستخدام فعلاً — وهذا ما يعاير الدرجات لكل وكيل آخر.

outcome.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",
    "task_family": "pdf_table_to_csv",
    "outcome": {
      "call_completed": true,
      "result_usable": true,
      "subgoal_completed": true,
      "fallback_needed": false
    },
    "agent_judgement": {
      "score": 0.86,
      "confidence": 0.74,
      "reason_codes": ["schema_valid", "result_used_in_final_answer"]
    }
  }'

يجب ألا تحتوي تقارير النتائج إطلاقًا على تعليمات أو ملفات المستخدم أو بيانات اعتماد. ترفض واجهة API الحمولات التي تنتهك عقد الخصوصية.