Référence de l'API

Preflight API

Les résultats de recherche vieillissent. Le preflight revalide une action spécifique quelques millisecondes avant que votre agent ne l'appelle : état en direct, capacité, latence attendue et fenêtre de validité bornée.

POST/v1/capabilities/preflight

Corps de la requête

Champ	Description
capability_id	Capacité à vérifier, issue d'un résultat de recherche.
action	L'action spécifique à invoquer. Les scores sont établis par action, et non par service.
agent_runtime	Identifiant de l'environnement d'exécution appelant.
task_family	Famille de tâches pour une notation tenant compte de la tâche, par exemple pdf_table_to_csv.
timeout_budget_ms	Votre budget de temps ; signalé si la latence attendue le dépasse.
risk_level	Risque que vous êtes disposé à accepter pour cet appel.

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"
  }'

Réponse

status vaut ready, degraded ou blocked. Traitez valid_for_seconds comme une expiration stricte : au-delà, effectuez un nouveau preflight au lieu de vous fier à une réponse périmée.

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"
    }
  ]
}