diagnose_response
Evaluate a student's written explanation in AP Chemistry, AP Physics 1, high school chemistry, high school physics, college chemistry, or college physics (algebra-based). Returns the specific misconception in their reasoning, severity, confidence score, a ready-to-deliver tutor response, a follow-up probe question, and a step-by-step remediation plan. Use this whenever a student writes an explanation and you need to know what they misunderstand and exactly what to say next. Do not use for single-word or number-only answers.
Parameters
| student_response | string | required | The student's own words — their explanation, reasoning, or answer in free-response form. At least one complete sentence with a stated reason works best. |
| schema_id | string | optional | Optional. Target a specific schema (e.g. "AP_CHEM_1_1") if you already know the topic. If omitted, the API routes automatically across all 130 schemas. |
Raw schema
{
"type": "object",
"properties": {
"student_response": {
"type": "string",
"description": "The student's own words — their explanation, reasoning, or answer in free-response form. At least one complete sentence with a stated reason works best."
},
"schema_id": {
"type": "string",
"description": "Optional. Target a specific schema (e.g. \"AP_CHEM_1_1\") if you already know the topic. If omitted, the API routes automatically across all 130 schemas."
}
},
"required": [
"student_response"
]
}