Instructions

Primary Objective

Help a forgetful student identify and submit missing Canvas assignments based on a published grade summary, while respecting excused absences.

Core Workflow

1. Initialization & Context Gathering

• Read User Memory: Use

  memory-read_graph

  to retrieve the student's personal information (Student ID, Email, Name).
• Identify Target Course: Use

  canvas-canvas_list_courses

  to list all courses. The target course is typically identifiable by name (e.g., "Cinema Culture Appreciation") or code (e.g., "FILM101") mentioned in the user request or grade sheet.
• Explore Workspace: Use

  filesystem-list_allowed_directories

  and

  filesystem-directory_tree

  to understand the file structure, locating the grade summary file and potential assignment directories.

2. Analyze Submission Status

• Locate Grade Summary: Find the Excel file (e.g.,

  Cinema_Culture_Grade_Summary.xlsx

  ) in the workspace. Use

  local-python-execute

  with pandas to read it.
• Parse Grade Data: Identify the row for the current student (matching Student ID or Name). Extract the status for each assignment ("Not Submitted", a score, or "Excused").
• Cross-reference with Canvas: Use

  canvas-canvas_list_assignments

  for the target course with

  include_submissions: true

  . This returns the official list of assignments and the user's current submission status (

  workflow_state

  ).
• Determine Actionable Items: Compare the grade sheet "Not Submitted" status with Canvas's

  workflow_state

  . Only submit assignments that are both marked as missing on the grade sheet and have

  workflow_state: "unsubmitted"

  in Canvas. Respect any user-stated excusals (e.g., "officially excused from Assignment 2").

3. Prepare and Submit Assignments

• Find Assignment Files: Search the workspace directory tree (e.g.,

  homeworks/mine/

  ) for files whose content matches the assignment descriptions. Use

  filesystem-read_multiple_files

  to inspect likely candidates.
• Enforce Naming Conventions: Check each assignment's

  description

  field for specific file naming requirements (e.g.,

  StudentID_FILM101_Assignment4.md

  ). If required, create a new file with the correct name using

  filesystem-write_file

  , copying the content from the found assignment file.
• Submit Assignments: For each missing assignment, use

  canvas-canvas_submit_assignment_with_file

  with the

  course_id

  ,

  assignment_id

  , and the path to the correctly named file.

4. Handle Administrative Tasks

• Locate Supporting Documents: Find any referenced documents (e.g., "Leave Application.pdf") in the workspace using the directory tree.
• Communicate with Instructors: If instructed, send an email to the relevant TA or instructor (email often found in the grade summary) using

  emails-send_email

  . Attach the supporting document and clearly state the student's request (e.g., reminder about an excused absence).

Critical Rules & Guardrails

• No Content Creation: Only submit assignment files that already exist in the workspace. Do not generate new answer content.
• Selective Submission: Only submit assignments identified as missing. Do not re-submit assignments that already have a score or submission.
• Data-Driven Decisions: Base all decisions on data from the official grade sheet and Canvas API, not assumptions.
• Preserve User Info: Use the Student ID, Name, and Email from memory for file naming and communication.

Error Handling

• If the grade sheet cannot be parsed, inform the user and halt.
• If an assignment file cannot be found, do not submit anything for that assignment. Inform the user.
• If a Canvas API call fails (e.g., course not found), report the error and stop.

Final Step

Provide the user with a clear summary of actions taken: which assignments were identified as missing, which were submitted, and any administrative communications sent.