submit_feedback
ActiveTool of Kifly — Agentic Commerce & Payments
declared in 1.0.0
Send structured feedback to the Kifly team. **Call after a confusing response, a dead-end, or a successful workaround you had to invent** — it's how we improve the agent surface. Fire-and-forget: returns 202 immediately, no blocking, safe to skip if it would add latency to a user-facing flow. `category` and `severity` are required enums (don't free-form them). Include `context` with what you were doing (tool called, query used, response shape, what you expected). Add `suggested_fix` only if you have a concrete idea. Rate-limited to 10/min per agent token; everything is reviewed before influencing anything.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"category",
"severity",
"message"
],
"properties": {
"context": {
"type": "object",
"description": "Reproducible signal: { tool, query, response_snippet, expected }. Auto-fill from what you just did.",
"additionalProperties": {}
},
"message": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "Plain-language description. Be specific about what happened and why it's a problem."
},
"category": {
"enum": [
"discoverability",
"response_shape",
"tool_description",
"latency",
"error_handling",
"missing_capability",
"other"
],
"type": "string",
"description": "What kind of issue. Pick the closest match — don't invent new categories."
},
"severity": {
"enum": [
"blocker",
"friction",
"nice_to_have"
],
"type": "string",
"description": "blocker = can't complete the task. friction = degraded UX. nice_to_have = improvement idea."
},
"suggested_fix": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "Optional. Only include if you have a concrete idea. Leave blank if you only have a complaint."
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Kifly — Agentic Commerce & Payments
1/7 registries