get_candidate_profile
ChatGPTReturn the authenticated PrepSim candidate's display name for use in the conversation. Call this when the user asks which candidate, account, or profile is connected. Does not return email, username, account ID, or credentials.
get_due_mistakes
ChatGPTRetrieve questions from the candidate's spaced-repetition mistake queue on PrepSim that are due for review today.
get_exam_catalog
ChatGPTList all supported competitive and language exams on PrepSim (JEE Main, JEE Advanced, NEET, BITSAT, UGC NET, IELTS, PTE, UPSC, etc.) with format, rules, durations, practiceMode ('question_by_question' for single-question AI chat practice vs 'full_timed_simulation' for website tests), and test links.
get_exam_syllabus
ChatGPTRetrieve official syllabus breakdown, units, chapters, exam pattern, marking scheme, and topic guidance for competitive exams on PrepSim (JEE Main, JEE Advanced, NEET, BITSAT, UGC NET Paper 1 & Paper 2 subjects, UPSC Prelims GS & CSAT, NDA). Call this when a student asks 'what is the syllabus for...', 'what topics are in...', 'how is the exam structured', or wants help planning a study schedule.
get_practice_questions
ChatGPTFetch authentic, verified practice questions from PrepSim for interactive quizzing (JEE Main, JEE Advanced, NEET, BITSAT, UGC NET, UPSC). Note: Standardized tests (IELTS, PTE, TOEFL, CELPIP, TOEIC) require full audio/reading simulations on https://aynadhillon.com and redirect to their full simulation URL.
get_profile
ChatGPTReturn the authenticated candidate's stable PrepSim profile ID, display name, and human-readable connection label. Does not return email or account credentials.
get_recent_performance
ChatGPTRetrieve candidate's recent test attempts, performance diagnostics (scores, accuracy, penalties lost to wrong guesses, weak topic alerts), and detailed question-by-question mistake review from their latest test attempt on PrepSim. Call this when the student asks how they performed, asks for test history, or wants an overview of their test results.
get_recommended_drill
ChatGPTGenerate a targeted practice drill focusing on the candidate's weakest topics and chapters based on their recent mock test performance on PrepSim. Analyzes low-accuracy topics (<60% accuracy or missed questions) from their latest completed test (or a specified resultId), selects authentic verified practice questions targeting those exact topics, withholds official answers for blind recall, and provides pedagogical context explaining why each question was selected. Call this automatically when the student asks for 'practice questions on my weak topics', 'a drill on what I got wrong', 'targeted practice on my mistakes', or asks what to study next.
get_test_review
ChatGPTReview a candidate's completed test attempt and mistakes. Call this automatically whenever the student asks to 'review my test', 'review my mistakes', 'see what I got wrong', 'go over my previous test', or wants a question-by-question breakdown of their test performance. Retrieves the candidate's actual question prompt, options A-D, their chosen answer, the correct answer, and step-by-step explanations.
save_to_mistake_queue
ChatGPTBookmark an approved UGC NET Paper 1 or JEE Advanced question into the candidate's personal spaced-repetition mistake queue on PrepSim directly from chat. Automatically schedules the question for spaced recall reviews (1, 3, 7, and 14 days). Candidates can review these saved questions on https://aynadhillon.com or via 'get_due_mistakes'. Call this when the student asks to 'save this question', 'add this to my mistakes', 'bookmark this for revision', or when reviewing mistakes.
submit_practice_answer
ChatGPTSubmit and grade a candidate's answer for a question ID. Returns whether the answer was correct, the official answer key, and the step-by-step LaTeX explanation.