Embedded Files
Best Practices for Effective AI Grading
To get the most accurate and nuanced results from VelociGrader, it's helpful to understand how the AI "thinks." It works by analyzing the complete context you provide. The clearer that context, the better the outcome. Here are the most impactful ways to maximize VelociGrader's grading ability.
1. The Golden Rule: Your Instructions are the AI's Reality
Your primary tool is the Assignment Instructions field in Google Classroom. VelociGrader sends these instructions directly to the AI as its core directive.
Be Explicit: Don't assume the AI knows the subtext. If you want students to cite sources, write "You must cite at least two sources in APA format." If you want a five-paragraph essay, specify "Your response must be a standard five-paragraph essay."
Define "Good": Clearly state what a successful submission looks like. For example, instead of "Analyze the causes of the war," write "Identify and explain three distinct causes of the war, providing at least one piece of evidence for each."
2. Structure Your Assignments for Success
The AI is programmed to look for distinct, gradable parts of an assignment. When you structure your assignment with clear, separable questions, you guide the AI to provide a more granular and accurate assessment.
Use Numbered Lists or Headings: Break down complex tasks into smaller, numbered questions or sections with clear headings. This allows the AI to generate a score for each part (e.g., Grade: [score_for_q1, score_for_q2, ...]) which leads to a more accurate and fair overall grade.
Avoid Single, Vague Paragraphs: An assignment that just says "Write about your trip" is much harder for the AI to grade consistently than one that says:
Describe where you went.
Explain your three favorite activities.
What did you learn from the experience?
3. Leverage the Power of Rubrics
This is one of the most powerful features at your disposal. When you attach a rubric to an assignment in Google Classroom and enable the "Utilize Classroom Rubric" option in VelociGrader, the AI's entire focus shifts.
The AI Grades Only to the Rubric: Instead of a holistic assessment, the AI is forced to evaluate the student's work against each specific criterion you've defined.
Write Descriptive Criteria: The text in your rubric's criteria and level descriptions is sent to the AI. A level described as "Excellent" is less helpful than "Analysis is insightful and supported by multiple, relevant examples from the text."
4. Use "Make a Copy for Each Student" for Templates
When you attach a Google Doc and select "Make a copy for each student," VelociGrader can identify this as the assignment template.
This gives the AI a perfect "before" and "after" picture. It can clearly see what you provided versus what the student added. This is especially effective for:
Worksheets & Guided Notes: The AI can easily check for completed sections.
Completion-Based Tasks: It provides a clear measure of how much of the template was filled out.
An Example: Poor vs. Excellent Setup
Imagine an assignment about the water cycle.
A Poorly-Defined Assignment:
Instructions: Please write about the water cycle and include a diagram.
Problem: This is too vague. What about the water cycle? What should the diagram include? The AI has to guess your intent, leading to inconsistent grades.
An Excellent, AI-Ready Assignment:
Instructions: In a Google Doc, please answer the following questions in complete sentences.
Define and describe the four main stages of the water cycle (Evaporation, Condensation, Precipitation, Collection).
Explain the role the sun plays in this process.
Why is the water cycle important for life on Earth?
Rubric Attached:
Criterion 1: Stage Descriptions: (4pts) All four stages are accurately described. (2pts) At least two stages are described. (0pts) Stages are missing or inaccurate.
Criterion 2: Sun's Role: (4pts) The sun's role as the energy source is clearly explained. (0pts) The sun's role is not explained.
Why it Works: The instructions are explicit and numbered. The rubric gives the AI precise, non-negotiable rules for scoring. This setup removes ambiguity and empowers VelociGrader to act as a reliable and consistent assistant.
By investing a few extra minutes in setting up your assignments with this level of clarity, you provide the AI with the high-quality context it needs to deliver the best possible results.
Trust, but Verify: The Teacher's Role in AI-Assisted Grading
VelociGrader is designed to be a powerful and time-saving assistant, but it's important to remember that it is a tool to assist your professional judgment, not replace it. The teacher is, and always should be, the final authority in the classroom. Here’s a guide to understanding the AI's limitations and how to best work with them.
Why the AI Isn't Perfect
Artificial intelligence is incredibly advanced, but it doesn't "understand" context in the same way a human teacher does. It excels at following patterns and explicit instructions, but it can sometimes falter.
Ambiguity is the Enemy: If assignment instructions are vague, the AI has to make its best guess at your intent, which can lead to inconsistent or unexpected results. (See our "Best Practices" guide for more on this).
Complex or Creative Work: The AI may struggle to fairly assess highly creative, abstract, or unconventional student responses that deviate significantly from the instructions.
Handwriting and Scans: While the AI is good at reading text from images, poor quality scans, messy handwriting, or complex diagrams can sometimes be misinterpreted.
AI "Hallucinations": Like all Large Language Models, the AI can occasionally make mistakes, misread a sentence, or generate feedback that seems slightly off-topic.
What Happens When VelociGrader Can't Assign a Grade?
Sometimes, you might see a result in the log that seems unusual. Here are the most common scenarios:
Scenario 1: The AI's response was un-parsable. Your system is built with a fallback mechanism. If the AI fails to provide a score in the strict Grade: [score] or Score: [score] format, VelociGrader will:
Check the AI's text feedback for error keywords (like "failed," "blocked," or "error"). If found, it will assign a grade of 0.
If no error is detected, it will generously default to assigning full points for the assignment.
What this means for you: If you see a student unexpectedly received full points, check the AI Feedback in the log. It may indicate that the AI couldn't parse the work, and you should review that submission manually.
Scenario 2: The grade is 0. This is often intentional and a feature of the system's pre-checks. VelociGrader automatically assigns a grade of 0 if it detects:
A Blank Submission: The student submitted no files, or the files contained no processable content.
An Unedited Template: The student submitted an exact copy of the template you provided via "Make a copy for each student," with no original work added.
Scenario 3: The AI response was blocked. The AI has built-in safety filters. If a student's submission contains content that violates the safety policy (e.g., hate speech, harassment, etc.), the AI will refuse to process it. The log will show a "content generation blocked" message, and the submission will be graded as a 0.
Your Role: The Final Check
Because of these limitations, we strongly recommend a "trust, but verify" approach.
Spot-Check the Results: For any new assignment, take a few minutes to review 3-5 of the AI-graded submissions. Read the AI's feedback and see if the assigned grade aligns with your professional assessment. This will give you confidence in the results and help you spot any potential issues quickly.
Use the Grading Report: The "AI VelociGrader Log" Google Sheet is your best tool for transparency. It shows you the Raw AI Score, the Final Grade after persona adjustments, and the complete AI Feedback. This makes it easy to see exactly how VelociGrader arrived at its conclusion.
You Have the Final Say: If you disagree with a grade, simply go into Google Classroom and change it. VelociGrader will not override a grade that you have set manually. You are always in control.
By using VelociGrader as a diligent but fallible teaching assistant, you can save countless hours while maintaining the high standards of quality and fairness that define your teaching.
Your Google Account is Your Key to VelociGrader
VelociGrader is deeply integrated with Google Classroom to provide a seamless experience. To make this work securely, the application uses your active Google account as the "key" that unlocks both your Classroom data and your VelociGrader subscription. Here’s what you need to know.
How Does VelociGrader Know Who You Are?
When you use the VelociGrader Web App or Chrome Extension, the application securely checks which Google account you are currently signed into in your browser. This is the standard, secure method used by all Google Workspace Add-ons.
This single sign-on serves two vital purposes:
Authorization for Google Classroom: It's how you grant VelociGrader permission to view your courses and grade assignments on your behalf. This is part of Google's secure OAuth protocol, which means VelociGrader never sees or stores your Google password.
Licensing and Subscription: Your Google email address (e.g., [email protected]) is used as your unique identifier in our licensing system. When you purchase a subscription or start a trial, that license is permanently linked to that specific Google email.
"I Have a Subscription, But It Says I'm Not Authorized."
This is the most common support question, and it almost always has a simple solution: you are likely signed into a different Google account in your browser than the one you used to subscribe.
For VelociGrader to work, the Google account you used to purchase your subscription must be the active account in the browser where you are using the app.
How to Troubleshoot Login and Subscription Issues
If you're facing an authorization error, follow these steps:
Identify Your Subscribed Account: Check your email for the subscription confirmation from our payment processor (Polar.sh). The email address that received that confirmation is your official VelociGrader account.
Check Your Active Google Account: Open a new tab and go to a Google service like gmail.com or myaccount.google.com. Look at the profile icon in the top-right corner to see which account is currently active.
Switch Accounts if Necessary: If the active account is not your subscribed account (e.g., it's a personal gmail.com account instead of your school account), you will need to switch to the correct one.
Pro Tip for Managing Multiple Accounts: Use Chrome Profiles
Many educators use multiple Google accounts (e.g., one for school, one for personal use). The best way to keep these separate and avoid conflicts is by using Chrome Profiles.
You can create a dedicated Chrome Profile for your schoolwork. When you sign into that profile, your school Google account will always be the default, ensuring VelociGrader and other school-related apps work without a hitch.
By ensuring your active Google login matches your subscription email, you guarantee that VelociGrader can securely connect to your Classroom and validate your license, giving you uninterrupted access to its features.
Page updated
Google Sites
Report abuse