Pour commencer

Démarrage rapide

La boucle complète — search, preflight, appel, signalement — en quatre commandes curl. Votre agent effectue l'appel tiers réel ; le réseau ne le relaie jamais.

0. Vérifier le service

Le point de terminaison de santé ne requiert aucune authentification et confirme la version à laquelle vous vous adressez.

healthz.sh

curl http://101.32.68.30/healthz

1. Rechercher des capacités

Décrivez la tâche en langage naturel. La réponse sépare les candidats recommended, fallbacks et blocked, chacun avec des scores, des niveaux de preuve et des codes de motif.

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. Prévérifier avant l'appel

La préparation se dégrade. Une vérification de preflight répond à la question « est-ce toujours valable en ce moment ? » et inclut une fenêtre de validité ainsi que des solutions de repli.

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. Invoquer, puis signaler le résultat

Votre agent appelle la capacité via sa propre interface (MCP, CLI, API). Ensuite, indiquez si le résultat était réellement exploitable — c'est ce qui calibre les scores pour tous les autres agents.

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

Les rapports de résultats ne doivent jamais contenir de prompts, de fichiers utilisateur ni d'identifiants. L'API rejette les charges utiles qui violent le contrat de confidentialité.