Overview

When a session is submitted for scoring using Feedback Aide, the session status is set to Pending Scoring while responses are queued for evaluation. As each response is evaluated by Feedback Aide, a feedbackaide_session_uuid is created and associated with that response. Once all responses in the session have been scored, the session status is updated to Completed.

This article explains how to work with Feedback Aide-scored sessions using the Data API.

Session Status: Pending Scoring

When a session is submitted for scoring via Feedback Aide, the session status transitions to Pending Scoring. This status indicates that the session contains responses that are queued and waiting to be scored by Feedback Aide. Once all responses in the session have been scored, the session status is updated to Completed.

Data Storage: Scores vs Feedback

When using Feedback Aide, different types of data are stored in different systems.

• Scores: The score assigned by Feedback Aide is stored with the response in the Learnosity Data API. You can retrieve scores using the /sessions/responses or /sessions/scores endpoints.
• Feedback and Evaluations: Detailed feedback, rubric evaluations, annotations, and other Feedback Aide-specific data are stored separately in the Feedback Aide system. This data is not accessible via the Data API and must be retrieved using the Feedback Aide API.

Retrieving the Feedback Aide Session UUID

To access Feedback Aide feedback or load the Feedback Aide UI for a grader, you need the feedbackaide_session_uuid. This UUID is returned in the response data when you query sessions that have been scored with Feedback Aide.

Use the /sessions/responses endpoint to retrieve the feedbackaide_session_uuid:

{
    "session_id": ["your-session-id"]
}

The response includes the feedbackaide_session_uuid for each response that was scored with Feedback Aide:

{
    "data": [{
        "session_id": "your-session-id",
        "status": "Completed",
        "responses": [{
            "response_id": "response-123",
            "feedbackaide_session_uuid": "fa-uuid-456",
            "score": 3,
            "max_score": 5
        }]
    }]
}

Initializing the Feedback Aide UI

Once you have retrieved the feedbackaide_session_uuid from the Data API, you can use it to initialize the Feedback Aide UI for human graders to review and modify feedback.

For more information on initializing a feedback session with the UUID, see the feedbackSession() method documentation.

const feedbackSession = await feedbackApp.feedbackSession(
    { /* security token */ },
    {
        state: 'review',
        session_uuid: 'fa-uuid-456', // The feedbackaide_session_uuid from Data API
        // ... other options
    }
);

Important: Score Synchronization

When a grader modifies scores in the Feedback Aide UI, those changes are not automatically synchronized to the Learnosity Data API. They are saved only in the Feedback Aide system.

This can create two sources of truth for scores:

• The score stored in the Data API (from the initial Feedback Aide evaluation).
• The updated score in Feedback Aide (after human review).

To maintain score consistency, call the Data API /sessions/responses/scores update endpoint when a grader clicks "Submit to Student" in the Feedback Aide UI. This ensures that the score in the Data API reflects the final graded score.

Example workflow:

1. Retrieve the session and feedbackaide_session_uuid from Data API.

2. Initialize Feedback Aide UI with the UUID for human review.

3. When the grader submits the final score, capture the updated score.

4. Use UPDATE Response Scores endpoint to synchronize the score with the Data API.

{
    "sessions": [{
        "session_id": "your-session-id",
        "user_id": "learner-user-id",
        "responses": [{
            "response_id": "response-123",
            "score": 4,
            "max_score": 5
        }]
    }]
}