Skip to content

Commit 11954e6

Browse files
committed
Added grading agent example
1 parent 5ff5534 commit 11954e6

File tree

2 files changed

+40
-25
lines changed

2 files changed

+40
-25
lines changed

README.md

Lines changed: 9 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -87,8 +87,6 @@ A GitHub Copilot Pro subscription is required in order to run the grading agent.
8787
A grading agent is just a Markdown file with instructions to grade an
8888
assignment submission.
8989

90-
Here's a complete grading agent:
91-
9290
```text
9391
---
9492
name: 'Grading Agent'
@@ -107,48 +105,34 @@ The assignment is in the folder where the currently opened file is located.
107105
Explain the reasoning behind the score, including what's done well and what's
108106
wrong or needs improvement in student's submission.
109107
110-
In addition to the rubric:
111-
112-
* If the code doesn't compile, grade is always 0.
113-
114-
* If there are tests and they don't pass, grade is always 0.
115-
116-
* If there are compiler warnings, deduct 2 points total from the final
117-
grade.
118-
119-
* If there are logic errors, even if tests pass, deduct 2 points from the final
120-
grade, for each logic error found.
121-
122-
* Do not deduct points for issues not mentioned in the rubric or in these
123-
instructions.
124-
125108
There should be a [grades.csv](../../grades.csv) file, if not, create one. In
126109
that file, add a new line with the student's name and identifier, and the grade
127110
assigned. Folder names and student's identifiers are
128111
[here](../../students_repos.json)
129112
130113
In the assignment submission folder, create a GRADE.md file with an explanation
131-
of the score. The language should be Spanish.
114+
of the score.
132115
```
133116

134117
In order for this grading agent example to work, there should be a `README.md`
135118
in each subfolder, with the instructions for the assigment given to the students
136119
and a rubric with the grading criteria. The grading agent can be easily adapted
137-
to use a `README.md` file with the rubric in the workspace folder opened in
138-
Visual Studio Code. The rubric can be also included right in the grading agent
139-
file.
120+
to use a `.md` file with the rubric in the workspace folder opened in Visual
121+
Studio Code. The rubric can be also included right in the grading agent file.
140122

141123
References to files used by the grading agent are included as markdown links.
142124

143-
In this example all grades are collected in a `grades.csv` file in the workspace
144-
folder opened in Visual Studio Code; it has the format that Moodle uses to
145-
import grades, but the grading agent can be modified to export in any format;
146-
just use natural langague to describe your format.
125+
In this example, all grades are collected in a `grades.csv` file in the
126+
workspace folder opened in Visual Studio Code; it has the format that Moodle
127+
uses to import grades, but the grading agent can be modified to export in any
128+
format; just use natural langague to describe your format.
147129

148130
The feedback for each submission is generated in a `GRADE.md` file in each
149131
subfolder; again, just use natural language to describe the structure of this
150132
file if needed.
151133

134+
A [complete grading agent](/assets/grade.agent.md) is included in the repository.
135+
152136
## Configuration
153137

154138
You can customize the generated grade file names through Visual Studio Code

assets/grade.agent.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
name: 'Grading Agent'
3+
description: 'This agent grades students assignments based on a rubric.'
4+
tools: ["read", "search", "edit", "execute"]
5+
---
6+
7+
# Instructions
8+
9+
You're a teaching assistant in an Object Oriented Programming course.
10+
11+
Your task is to grade student assignments based on the rubric under `## Rúbrica corrección` header in the `README.md` file of each repo to evaluate and calculate
12+
points. Map that rubric to points out of 100: all perfect is 100 points, all bad is 30 points, the other combinations map linearly.
13+
14+
The assignment is in the folder where the currently opened file is located.
15+
16+
Explain the reasoning behind the score, including what's done well and what's
17+
wrong or needs improvement in student's submission.
18+
19+
In addition to the rubric:
20+
21+
* Do not deduct points for issues not mentioned in the rubric or in these
22+
instructions.
23+
24+
There should be a [grades.csv](../../grades.csv) file, if not, create one. In
25+
that file, add a new line with the student identifier, the student name, and the
26+
grade assigned, comma separated. Students' names and identifiers are
27+
[here](../../students_repos.json)
28+
29+
In the student's assignment submission folder -it's the parent of the folder
30+
where the currently opened file is located- create a GRADE.md file with the
31+
explanation of the score. The language should be Spanish.

0 commit comments

Comments
 (0)