# Tutor\_Instruction

## 1. Description <a href="#id-1.-description" id="id-1.-description"></a>

This Agent Action provides the Agentforce Tutor with the ability to respond to student queries on course material covered by an assessment that also require instructional guidance. This is achieved by accessing grounded pedagogy-aligned Instructional data through Assess for Learning.

## 2. Reference Action <a href="#id-2.-reference-action" id="id-2.-reference-action"></a>

Apex Class: Tutor\_Instruction.cls

## 3. Configuration Details <a href="#id-3.-configuration-details" id="id-3.-configuration-details"></a>

{% hint style="warning" %}
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.
{% endhint %}

### Agent Action Label <a href="#agent-action-label" id="agent-action-label"></a>

`Tutor_Instruction`

### Agent Action Instructions <a href="#agent-action-instructions" id="agent-action-instructions"></a>

Your job is to retrieve a response from the AI learner tutor based on the student's query:

* You must then ALWAYS use this response to answer the student's question and continue your conversation.
* You must NEVER use knowledge outside of the response you retrieve unless it's highly related.
* NEVER make up course material sections or specific references.
* If helpful, propose follow-up questions to the student to help them further explore a topic or learning path.

### Inputs <a href="#inputs" id="inputs"></a>

**1. assessmentName (Label: Name of the Learning Assessment)**

* **Instructions:** The student's query. Pass in the exact query made by the student into the 'Tutor\_Instruction' Action.
* **Advanced Settings:**
  * Require input: <mark style="color:green;">**Enable this setting**</mark>
  * Collect data from use&#x72;**:** <mark style="color:red;">**Disable**</mark>

**2. query (Label: User Query)**

* **Instructions:** The name of the assessment. This should already be available from the previously ran 'Tutor\_Mark' Action.
* **Advanced Settings:**
  * Require input: <mark style="color:green;">**Enable this setting**</mark>
  * Collect data from use&#x72;**:** <mark style="color:red;">**Disable**</mark>

3. **queryType (Label: Query Type)**

* **Instructions:** The type of the query (optional, default "local")
* **Advanced Settings:**
  * Require inpu&#x74;**:** <mark style="color:red;">**Disable**</mark>
  * Collect data from use&#x72;**:** <mark style="color:red;">**Disable**</mark>

4. **responseSize (Label: Response Size)**

* **Instructions:** The size of the response (optional, default "medium")
* **Advanced Settings:**
  * Require inpu&#x74;**:** <mark style="color:red;">**Disable**</mark>
  * Collect data from use&#x72;**:** <mark style="color:red;">**Disable**</mark>

### Outputs <a href="#outputs" id="outputs"></a>

**1. message (Label: Message)**

* **Instructions:** Result message
* **Advanced Settings:**
  * Filter from agent action: <mark style="color:green;">**Enable this setting**</mark>
  * Show in conversatio&#x6E;**:** <mark style="color:red;">**Disable**</mark>
  * **Output Rendering:** Text

**2. response (Label: Response)**

* **Instructions:**
  * The AI learning tutor response.
  * You must ALWAYS format this response into your own conversational words. Don't just paste the response into the conversation directly.
* **Advanced Settings:**
  * Filter from agent actio&#x6E;**:** <mark style="color:red;">**Disable**</mark>
  * Show in conversation: <mark style="color:green;">**Enable this setting**</mark>
  * **Output Rendering:** Rich Text