Add sentiment attribute and calculation to SurveyResponse

app/jobs/sentiment_analysis_job.rb

@@ -0,0 +1,14 @@
+# This background job hydrates the graph from a SurveyResponse.
+class SentimentAnalysisJob
+
+  include Sidekiq::Job
+
+  queue_as :default
+
+  def perform(id)
+    return unless record = SurveyResponse.find(id)
+    Rails.logger.info("SentimentAnalysisJob running with survey response ID #{id}")
+    record.classify_sentiment
+  end
+
+end

app/models/survey_response.rb

@@ -14,6 +14,19 @@ class SurveyResponse < ApplicationRecord
 
   REQUIRED_FIELDS = [:age_given]
 
+  # This is the prompt passed to the AI agent to serve as instructions for sentiment analysis.
+  SENTIMENT_PROMPT = %{
+    You are a social researcher doing textual analysis. Perform sentiment analysis against the provided text, classifying it as "positive", "negative", or "neutral". Return the classification encoded as JSON in the following format:
+
+    {
+      "sentiment" : "positive"
+    }
+
+    The text to perform sentiment analysis on is as follows:
+
+  }
+
+
   # Given a file handle to a data file, parse the filel contents as CSV and hydrate SurveyResponse records in serial.
   def self.import(file_handle)
     CSV.read(file_handle, headers: true).each do |record|
@@ -104,6 +117,18 @@ def persona
     )
   end
 
+  # Calculates and sets the sentiment based on a the "identity reflection / notes" field.
+  # This method uses the Clients::OpenAi client passing the text of the reflection as an
+  # argument to the prompt. The agent returns a classification, which is written to the
+  # SurveyResponse record.
+  def classify_sentiment
+    response = Clients::OpenAi.request("#{SENTIMENT_PROMPT} #{self.notes}")
+    return unless response['sentiment'].present?
+    classification = response['sentiment'].strip.downcase
+    update_attribute(:sentiment, classification)
+    return classification
+  end
+
   def populate_experience_codes
     {
       "age" => age_exp_codes,

db/migrate/20240820223410_add_sentiment_to_survey_response.rb

@@ -0,0 +1,5 @@
+class AddSentimentToSurveyResponse < ActiveRecord::Migration[7.1]
+  def change
+    add_column :survey_responses, :sentiment, :string
+  end
+end