Tutor_Task
1. Description
This Agent Action provides the Agentforce Tutor with the ability to retrieve the following graded assessment data for a particular student:
Individual score for all questions in an assessment.
Individual feedback for all questions in an assessment.
Individual pedagogy-aligned instructional feedback for all questions in an assessment.
Individual pedagogy-aligned instructional feedback to improve by one grade for all questions in an assessment.
2. Reference Action
Apex Class: Tutor_Task.cls
3. Configuration Details
When adding a new Agent Action, copy the exact details into each Agent Action section as outlined below. Ensure to capture the exact formatting including all bullet points and settings.
Agent Action Label
Tutor_Task
Agent Action Instructions
Your job is to retrieve the student's scores and feedback for individual questions on the formative assessment. You must follow the below order when using this action:
This job should only be ran after running the 'TutorForLearning_Mark' action. Therefore, you should already have the assessmentName input value.
ALWAYS start by asking the student: 'Would you like to see your scores and feedback for individual questions?'- format this in bold. UNLESS, the student has already asked to see their scores for a question.
If they answer yes to the question, then ALWAYS ask: 'Please provide a question number, or do you want to see all questions?' - format this in bold.
Then run the 'Tutor_Task' Action by passing in the assessmentName, contactEmail, and then either the taskNumber or the allTasks flag.
Then return back ONLY the score and scoreReason for all questions. Follow this up by asking if the student wants to see their instructional feedback.
If yes, return the scorePersonalInstruction for all tasks if it's not empty, else return the scoreInstruction. Follow this up by asking if the student wants to see how to improve their mark by 1 criterion in the rubric for each question.
If yes, return the scorePersonalInstructionPlus1 for each question if it's not empty, else return the scoreInstructionPlus1. Then finish this Action.
Inputs
1. allTasks (Label: Flag to fetch all tasks)
Instructions: Flag to fetch all tasks. If a student asks to see a break down for all questions, this should be set to 'Yes'. If they provide a specific question number, this should be set to 'No'.
Advanced Settings:
Require input: Enable this setting
Collect data from user: Enable this setting
2. assessmentName (Label: Name of the Learning Assessment)
Instructions: The assessmentName. This should already be available from the previously ran 'Tutor_Mark' Action.
Advanced Settings:
Require input: Enable this setting
Collect data from user: Disable
3. contactEmail (Label: Email of the Contact)
Instructions: The contactEmail. This should already be available from the previously ran 'Tutor_Mark' Action.
Advanced Settings:
Require input: Enable this setting
Collect data from user: Disable
4. taskNumber (Label: Sequence number of the task)
Instructions: Sequence number of the task. This should be the question number provided by the student. If they have requested all questions, ignore this input.
Advanced Settings:
Require input: Enable this setting
Collect data from user: Enable this setting
Outputs
1. message (Label: Result message)
Instructions: Result message
Advanced Settings:
Filter from agent action: Enable this setting
Show in conversation: Disable
Output Rendering: Text
2. score (Label: Score)
Instructions:
ALWAYS return the 'Score' in your first response.
You must ALWAYS format your response as: 'Your score for {Question {taskNumber} - all in bold} was: {Score - in bold}.
The 'Question taskNumber' and 'Score' injects should be in bold.
The 'Score' should be a rounded number with no decimal places.
Advanced Settings:
Filter from agent action: Disable
Show in conversation: Enable this setting
Output Rendering: Rich Text
3. scoreInstruction (Label: Score Instruction)
Instructions:
NEVER show this output initially.
ONLY show this output if the student replies 'Yes' (or similar) to the question - 'Would you like to see your instructional feedback?' AND if the 'Score Instruction Personal' output is empty.
You must ALWAYS format your response as: 'Your overall instructional feedback is: {Score Instruction - in italic}.
ALWAYS follow up the 'Score Instruction' output by asking: 'Would you like to see how to improve your mark by 1?'. Format this in bold.
There should ALWAYS be a new paragraph between 'Score Instruction' and the follow up question.
Advanced Settings:
Filter from agent action: Disable
Show in conversation: Enable this setting
Output Rendering: Rich Text
4. scoreInstructionPlus1 (Label: Score Instruction Plus 1)
Instructions:
NEVER show this output initially.
You must ALWAYS format your response as: 'To improve by one grade: {Score Instruction Plus 1 - in italic}.
ONLY show this output if the student replies 'Yes' (or similar) to the question - 'Would you like to see how to improve your mark by 1 criterion in the rubric?' AND if the 'Score Personal Instruction Plus 1' output is empty.
Advanced Settings:
Filter from agent action: Disable
Show in conversation: Enable this setting
Output Rendering: Rich Text
5. scorePersonalInstruction (Label: Score Personal Instruction)
Instructions:
NEVER show this output initially.
ONLY show this output if the student replies 'Yes' (or similar) to the question - 'Would you like to see your instructional feedback?'
If this output is empty, use the 'Score Instruction' as output.
You must ALWAYS format your response as: 'Your instructional feedback is: {Score Personal Instruction - in italic}.
ALWAYS follow up the 'Score Personal Instruction' output by asking: 'Would you like to see how to improve your mark by 1?'. Format this in bold.
There should ALWAYS be a new paragraph between 'Score Personal Instruction' and the follow up question.
Advanced Settings:
Filter from agent action: Disable
Show in conversation: Enable this setting
Output Rendering: Rich Text
6. scorePersonalInstructionPlus1 (Label: Score Personal Instruction Plus 1)
Instructions:
NEVER show this output initially.
ONLY show this output if the student replies 'Yes' (or similar) to the question - 'Would you like to see how to improve your mark by 1 criterion in the rubric?'
You must ALWAYS format your response as: 'To improve by one grade: {Score Personal Instruction Plus 1 - in italic}.
If this output is empty, use the 'Score Instruction Plus 1' as output.
Advanced Settings:
Filter from agent action: Disable
Show in conversation: Enable this setting
Output Rendering: Rich Text
7. scoreReason (Label: Score Reason)
Instructions:
ALWAYS return the 'Score Reason' in your first response after the 'Score'.
You must ALWAYS format your response as: 'Your feedback is: {Score Reason - in italic}.
ALWAYS follow up the 'Score Reason' by asking: 'Would you like to see your instructional feedback?'. Format this in bold.
There should ALWAYS be a new paragraph between 'Score', 'Score Reason', and the follow up question.
Advanced Settings:
Filter from agent action: Disable
Show in conversation: Enable this setting
Output Rendering: Rich Text
Last updated