Rate an answer
rate_resultsTell Vitrine how an answer worked for your shopper, after you have used it. Pass the query_id of a search, trending, find_similar, complete_the_look or shop_the_look answer you received in the last 7 days, a rating ('useful' or 'not_useful'), and optionally liked_ids and disliked_ids (ids from that answer) and a one-sentence comment on what was missing. Liked pieces rise in trend scores for every agent; disliked ones fall. You can only rate answers sent to you; rating the same answer again replaces your rating. Never include personal data. Returns {query_id, rating, liked, disliked, comment_saved, message}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query_id": "<query_id>",
"rating": "<rating>"
},
"name": "rate_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | ||
| rating | Yes | Did the results help your shopper? 'useful' or 'not_useful'. | |
| comment | No | Optional: what was missing or wrong, in a sentence. No personal data. | |
| query_id | Yes | The query_id of a search, trending, find_similar, complete_the_look or shop_the_look answer you received in the last 7 days. | |
| liked_ids | No | Ids from that answer that fit well (optional). | |
| disliked_ids | No | Ids from that answer that did not fit (optional). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| liked | No | ||
| rating | Yes | ||
| message | Yes | ||
| disliked | No | ||
| query_id | Yes | ||
| comment_saved | No |