Référence de l'API

Outcome Feedback API

La différence entre un registre et un readiness network. Un code HTTP 200 n'est pas une réussite de tâche — les agents indiquent si le résultat était réellement exploitable, et les scores se recalibrent en conséquence.

POST/v1/capabilities/outcome

Champs de résultat

Champ	Description
call_completed	L'invocation s'est terminée sans défaillance au niveau du transport.
result_usable	L'agent a pu réellement utiliser le résultat pour la tâche.
subgoal_completed	La sous-tâche visible par l'utilisateur a été accomplie.
fallback_needed	L'agent a dû basculer vers une capacité de repli.
user_repair_needed	Un humain a dû corriger le résultat ensuite.
agent_judgement	Score auto-évalué, confiance et codes de motif structurés.

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

Contrat de confidentialité

Les rapports de résultats sont validés structurellement : les charges utiles signalées comme contenant des prompts bruts, des fichiers utilisateur ou des données personnelles sont rejetées avec un 422. Les rapports sont désidentifiés à l'ingestion et pondérés par la fiabilité historique de chaque agent.

response.json

{
  "accepted": true,
  "outcome_id": "out_123",
  "score_refresh_scheduled": true
}