POST /v1/feedback

Une observation de qualité sur une trace de contexte ou sur un fait. Chaque observation est stockée (table feedback, migration 0006).

string

requis

1 à 128 caractères.

uuid

Exactement un de trace_id / fact_id requis (validé par un model_validator Pydantic).

uuid

string

requis

"useful" · "irrelevant" · "incorrect".

string

Max 2000 caractères.

Un rating="incorrect" sur un fact_id fait transitionner le fait vers disputed (si la transition est légale depuis son statut courant — voir le graphe de transitions). Un fait disputed n’est plus jamais servi comme actif par le Context Assembler.

Réponse — `201 Created`

string

défaut:"recorded"

uuid

requis

string | null

Le statut résultant du fait, si la cible était un fact_id ; null sinon.

curl -X POST http://localhost:8100/v1/feedback \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer hk_..." \
  -d '{
    "project_id": "prj_support",
    "fact_id": "f8a1c9de-...",
    "rating": "incorrect",
    "comment": "La facture doit en fait partir en anglais."
  }'

client.feedback(
    project_id="prj_support",
    fact_id="f8a1c9de-...",
    rating="incorrect",
    comment="La facture doit en fait partir en anglais.",
)

{"status": "recorded", "feedback_id": "a3e4...", "fact_status": "disputed"}

Erreurs possibles

fact_not_found (404 — fact_id inconnu, ou d’un autre projet : même erreur, aucune fuite), invalid_payload (422 — ni ou les deux de trace_id/fact_id, ou rating hors énumération).

Demarrer

Memoire

Qualite et correction

Administration

Gateway et sante

POST /v1/feedback

Réponse — `201 Created`

Erreurs possibles

​Réponse — 201 Created

​Erreurs possibles

Réponse — `201 Created`

Erreurs possibles