Skip to main content
Exam Evaluation grades answer sheets and stores the marks and the written feedback for every answer. The Action Plan API finds the answers that lost marks and writes the next steps from the feedback on them: what one student should work on, or what a teacher should reteach to the class. The two are separate API calls. Evaluating an exam does not create an action plan. Your platform decides when to ask for one.

​
What has to happen first?

The exam must have been evaluated by CrazyGoldFish Exam Evaluation. Action plans read what evaluation stored, so they work only for exams and answer sheets that exist in CrazyGoldFish. You cannot send in scores from your own grading, and there is no field for them. Two limits follow from how a plan is built:
  • Only answers that lost marks are looked at. An answer with full marks is not part of the plan, so a plan is never a report on the whole paper.
  • Only the written feedback reaches the AI. For each of those answers, the AI gets the question number and the marking feedback. It does not get the question wording, the introduction text, the sub-question wording, the model answer, or the marks. The quality of a plan follows the quality of the marking feedback.
Action plans are built from exam evaluation. Results from Assignment Evaluation are stored separately and cannot be used to create an action plan.

​
How does your platform connect the two?

1

Evaluate the answer sheets

Upload the question paper, the model answers, and the students’ answer sheets, and let evaluation finish. See the Evaluation Layer.
2

Ask for a plan

Send one ID. For a single student, send the answer sheet ID. For the class, send the exam ID. You get a confirmation straight away, not the plan.
3

Wait for it to finish

Writing a plan runs in the background, so check its status until it is ready. If the API user making the call has registered the matching webhook, CrazyGoldFish also calls your server when the plan ends. A webhook is a message sent to an address you registered, and it is registered per API user rather than per account. It says the job finished but does not carry the plan.
4

Fetch the plan

Read it back with the same ID you sent, using the same API user that created it. A plan is In Progress, Completed, or Failed. A teacher plan can also be Partial, when some questions were written up and others were not. A student plan is never Partial.

​
Which plan should you ask for?

​
What is in a student action plan?

The plan also comes with the student’s ID and name as they were recorded on the answer sheet.

​
What is in a teacher action plan?

One entry for each numbered question that students lost marks on. The parts of a question are pooled together, so question 5 gets one entry rather than one for each of 5(a), 5(b), and 5(c). This is the grouping teachers usually want: not a list of marks, but a list of who needs the same reteaching.

​
What does this hand-off not do?

  • It does not start on its own. Evaluating an exam never creates a plan.
  • It does not produce a parent plan. There are two action plans, for students and for teachers.
  • It does not track a student across exams. Each plan covers one exam, and nothing is carried forward.
  • It does not write lesson plans or worksheets. See Action plans to content for what your platform does next.
  • It does not give marks or percentages. The plan is written advice. Scores stay in the evaluation result.

​
Frequently asked questions

No. The request takes only the ID of an exam or an answer sheet that CrazyGoldFish evaluated. The marks and feedback are read from that evaluation.
Twenty a day for each account by default, counted across student and teacher plans. The count resets shortly after midnight on the server. Over the limit, the API answers 429.
No. A plan can be read back only by the API user who created it. If several of your services need it, create it with the same API user, or store the result on your side.
The plan was written for some questions but not all. Read the plan you have. The entries that are there are complete.
Yes. Each request writes a new plan, and reading it back gives you the most recent one for that exam or answer sheet.
Not from this API. Assignment Evaluation returns its own scores and feedback, and ClassTrack returns its own suggestions for the teacher. Both are separate results your platform reads directly.

​
Next steps

Action plans to content

What your platform does with a plan once it has one.

Personalization Layer

What student and teacher action plans are for.

Evaluation Layer

How exams and assignments are graded.

Action Plan API

Request and response fields.