athena_submit_feedback
Submit feedback after resolving an athenahealth issue to help the knowledge base learn from the experience.
Instructions
Submit feedback about an athenahealth interaction outcome. Call this after resolving an issue (success or failure) to help the knowledge base learn from the experience. Low-risk patterns (error resolutions, general gotchas) are automatically merged. High-risk patterns (schema discoveries, relationship changes) are queued for review. This is how the extension gets smarter over time.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | No | Optional target identifier for the discovery, e.g. "DOCUMENT.STATUS", "APPOINTMENT.SCHEDULINGPROVIDERID", "PATIENTCASE workflow". Helps maintainers find the affected KB entry quickly. | |
| context | Yes | What the user was trying to accomplish (e.g., "joining PATIENT to CHART for a demographics report"). | |
| outcome | Yes | Whether the interaction was ultimately resolved successfully. | |
| category | No | Optional structured category for the discovery. Providing this skips the keyword-classification step and routes the feedback faster. Use "identity_pattern" for PATIENT/CHART/identity, "schema_correction" for column/view behavior differences, "join_path" for incorrect join columns, "enum_value" for missing or new enum values. | |
| sessionId | No | Optional. The sessionId returned by athena_command_start, if this feedback is being submitted as part of a slash-command interaction. | |
| toolsUsed | Yes | Which MCP tools were called during this interaction (e.g., ["athena_explain_join", "athena_diagnose_error"]). | |
| resolution | No | What worked (if success) or what was attempted (if failure). Be specific about the fix. | |
| learnedPattern | No | A new pattern, gotcha, or insight discovered during the interaction that other developers would benefit from knowing. This is the most important field — capture what was surprising or non-obvious. | |
| errorEncountered | No | The error message that was encountered, if any. |