check_grades
ChatGPTUse this when the student asks what they got on a quiz or assignment, or how they are doing in a course. Returns each grade item of the course: the grade, the instructor's comment, and the release and update dates. grade is null until the instructor releases it. Brightspace sets releasedAt only on a final grade, so a null releasedAt does not mean that a grade is hidden. Read-only.
check_quizzes
ChatGPTList every quiz in a course with whether you have taken it (from the student quiz-list attempt count, not gated by grade release), how many attempts you used of those allowed, and your score if released. Read-only.
check_submission
ChatGPTCheck whether you (or your group, for group folders) have submitted to a dropbox/assignment folder. Read-only. folderId comes from list_assignments.
delete_course_material
ChatGPTUse this when the student asks to delete or forget one saved document: a note, a discussion thread or a course file. It deletes the text and the search chunks of that document from Zen. docId comes from read_course_material. A course file or a thread comes back if the student reads it again. It never deletes anything in Brightspace.
get_assignment
ChatGPTUse this before you draft or review work for an assignment, to follow its rubric. Returns the instructions, the due date, the end date, whether it is a group assignment, the attachment file names, the links, the submission type, and each rubric that the student can see: its criteria, its levels with their points, and the description of each level. cells has one cell for each level, in the order of levels. A cell can have its own points. Points are null when the rubric has no points or the instructor hides the scores: then do not give the student a number. The student reviews each draft and submits it. Zen never submits anything. folderId comes from list_assignments.
get_content_toc
ChatGPTGet the full content module/topic tree for a course.
get_discussion_reply_context
ChatGPTUse this when the student wants help to write a reply to a discussion thread. Returns the context for the reply: the thread and its posts, the course guide (the rubric and the format rules), and related course material. Write the draft from it; the student reviews and posts it. It never posts anything. forumId and topicId come from list_forums and list_threads.
get_topic
ChatGPTUse this when the student wants one content topic, for example to read or summarize a lecture PDF, slide deck or handout. Returns the title, type and url, and for a file (PDF, Word, PowerPoint, Excel or image) its full text, including scans and handwriting. A link or a quicklink to a file in the course works too. When Zen cannot read a topic, note says why and what the student can do. Zen saves the text, so later questions can use search_course_materials. topicId comes from get_content_toc. Zen cannot read a video. For a video, ask the student to paste or attach its transcript, then save it with save_note.
ingest_course
ChatGPTUse this when the student wants a whole course ready for study, e.g. before an exam: 'load all of ENVIRSC'. Saves the text of each course file (PDFs, slides, handouts), also when a topic links to a file in the course, and the assignment instructions, so search_course_materials finds them. skipped lists the files and links that Zen could not read, with the reason. It skips the files that are saved already. It works for about 40 seconds; when remaining is more than 0, call it again. It does not save discussions: a thread is saved when the student reads it. It does not save videos: to add a video, ask the student to paste or attach its transcript, then save it with save_note.
list_announcements
ChatGPTUse this when the student asks what the instructor announced, or what is new in a course. Returns the announcements of the course: title, text, start date, whether it is pinned, and the names of its attachments. Read-only.
list_assignments
ChatGPTList assignment (dropbox) folders with due dates for a course.
list_calendar
ChatGPTList calendar events (deadlines, quizzes, lectures) for a course.
list_courses
ChatGPTList all course offerings the user is enrolled in (id, code, name).
list_forums
ChatGPTList discussion forums for a course.
list_threads
ChatGPTList discussion threads (topics) within a forum.
read_course_guide
ChatGPTRead the saved course guides. Without orgUnit: list the courses that have a guide. With orgUnit: return that course's guide (markdown). Read the guide before you work on a course.
read_course_material
ChatGPTUse this when the student wants a list of what Zen saved for a course, or the full text of one saved document, e.g. 'what notes do I have for ENVIRSC?' or 'show me the whole syllabus'. Without docId: lists the saved documents of the course (id, kind: content, discussion, assignment or note; title; size). With docId: returns the full text of that document. Do not use it to find a topic: use search_course_materials.
read_thread
ChatGPTUse this when the student wants to read a discussion thread in full, with its current posts. Zen also saves the thread, so later questions about it can use search_course_materials. Needs forumId from list_forums and topicId from list_threads.
save_course_guide
ChatGPTUse this when you built a course guide: the rubrics, the format rules and the ids of a course, in markdown. Later conversations read it with read_course_guide. A second save replaces the guide. It writes to Zen only. It never writes to Brightspace. Do not use it for study notes: use save_note.
save_note
ChatGPTUse this when the student asks to save, keep or remember something from this conversation for later, e.g. a summary, study notes, practice answers or the transcript of a lecture video. It saves a note in the course. search_course_materials and read_course_material find it in later conversations. A note with the same title is replaced. It writes to Zen only. It never writes to Brightspace. Do not use it for the course guide: use save_course_guide.
search_course_materials
ChatGPTUse this when the student asks about course content, or about a discussion, an assignment or a note from before, e.g. 'what did my classmates say about latent heat?' or 'what is in my week 3 summary?'. It searches everything Zen saved for this student: course files, the discussion threads and assignments they read before, and their saved notes. Returns the best passages with their titles and links. Use it before you read Brightspace again. Do not use it for due dates or submission status: use list_assignments, list_calendar or check_submission.
send_feedback
ChatGPTUse this when the student wants to report a problem with Zen or suggest a change, e.g. 'tell Zen that search misses my slides'. It sends the message and the email of the student's Zen account to the Zen team, who can reply by email. Write the message from what the student said, with the details: what they did, what they expected, what happened. Show the message to the student and send it only after they agree. Do not add course content that the student did not ask to include.