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

مرجع واجهة API

واجهة التحقق المسبق API

تتقادم نتائج البحث. يعيد التحقق المسبق التحقق من إجراء محدّد قبل أن يستدعيه وكيلك بأجزاء من الثانية: الحالة المباشرة والسعة والكمون المتوقع ونافذة صلاحية محدودة.

POST/v1/capabilities/preflight

متن الطلب

الحقلالوصف
capability_idالقدرة المراد فحصها، من نتيجة بحث.
actionالإجراء المحدّد المراد استدعاؤه. الدرجات لكل إجراء، لا لكل خدمة.
agent_runtimeمعرّف بيئة تشغيل المُستدعِي.
task_familyعائلة المهام للتقييم المدرك للمهمة، مثل pdf_table_to_csv.
timeout_budget_msميزانيتك الزمنية؛ يُوسَم إذا تجاوز الكمون المتوقع لها.
risk_levelالمخاطرة التي تقبلها لهذا الاستدعاء.
request.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",
    "task_family": "pdf_table_to_csv",
    "timeout_budget_ms": 10000,
    "risk_level": "read_only"
  }'

الاستجابة

status واحد من ready أو degraded أو blocked. عامِل valid_for_seconds كانتهاء صارم: بعده، تحقّق مسبقًا من جديد بدلاً من الوثوق بإجابة قديمة.

response.json
{
  "status": "ready",
  "invoke_now_score": 0.91,
  "confidence": 0.83,
  "valid_for_seconds": 45,
  "expected_p95_latency_ms": 3200,
  "capacity_state": "ok",
  "auth_state": "not_required",
  "warnings": [],
  "fallbacks": [
    {
      "capability_id": "cap_slow_but_local_cli",
      "reason": "local_execution_available"
    }
  ]
}