submit_feedback
Rate served decisions (1-10) to improve future recommendations and report missing conventions for human curation.
Instructions
Report how helpful the served decisions were, and what was missing.
Call this after a task where you used Metatron's decisions. Reference the
`query_id` from the get_decisions_for_context output, then — most useful of all
— **rate each served decision 1-10 by its [index]** in `ratings`, where 10 means
it was exactly right and 1 means it was misleading. Also state any convention
Metatron should have known but didn't, in `what_was_missing`.
Behavior: ratings are 1-based indices into the decisions the named query served
(they map to real decision ids locally, so you never echo a UUID; unknown indices
and out-of-range scores are dropped). The graded scores feed a time-decayed,
shrunk helpfulness signal that reorders which decisions get served first next
time — helpful ones rise, misleading ones sink. A `what_was_missing` report is
stored as a gap for a human-gated refiner to later reshape into a CANDIDATE
decision. Nothing you send here promotes, demotes, or rejects a decision, or changes
its wording — crossing the canonical set is always a human's call.
Returns a short text confirmation that the feedback was recorded (and notes
when a gap was captured for curation).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query_id | No | The `query_id` token from the get_decisions_for_context output you are responding to. | |
| helpful | No | Optional shorthand: 1-based indices of decisions that helped. Usually derived from `ratings`, so prefer `ratings`. | |
| unhelpful | No | Optional shorthand: 1-based indices of decisions that were noise or misleading. | |
| ratings | No | The main signal: map of 1-based decision index (as a string) to a helpfulness score 1-10, where 10 = exactly right and 1 = misleading (e.g. {"1": 9, "2": 3}). | |
| what_was_missing | No | A convention Metatron should have known for this task but didn't. Captured as a candidate for human curation. | |
| missing_scope | No | Optional file path or area the missing convention applies to. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |