Raxol.Adaptive.FeedbackLoop (Raxol v2.6.0)

Tracks pilot accept/reject decisions on layout recommendations.

Maintains a feedback history and computes acceptance accuracy. When accuracy drops below threshold and enough training data exists, triggers async NxModel retrain and broadcasts new params to the LayoutRecommender.

Summary

Types

feedback()

t()

Functions

accept(server \\ __MODULE__, recommendation_id)

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

force_retrain(server \\ __MODULE__)

get_accuracy(server \\ __MODULE__)

get_history(server \\ __MODULE__, count \\ 20)

reject(server \\ __MODULE__, recommendation_id)

start_link(opts \\ [])

submit_recommendation(server \\ __MODULE__, recommendation)

Types

feedback()

@type feedback() :: %{
  recommendation_id: binary(),
  decision: :accepted | :rejected,
  timestamp: integer()
}

t()

@type t() :: %Raxol.Adaptive.FeedbackLoop{
  accuracy_window: pos_integer(),
  feedback_history: [feedback()],
  pending_recommendations: %{required(binary()) => map()},
  recommender_server: GenServer.server() | nil,
  retrain_in_progress: boolean(),
  training_examples: [{term(), term()}]
}

Functions

accept(server \\ MODULE, recommendation_id)

@spec accept(GenServer.server(), binary()) :: :ok | {:error, :not_found}

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

force_retrain(server \\ MODULE)

@spec force_retrain(GenServer.server()) ::
  {:ok, :rule_based_mode} | {:ok, :trained, map()} | {:ok, :insufficient_data}

get_accuracy(server \\ MODULE)

@spec get_accuracy(GenServer.server()) :: float()

get_history(server \\ MODULE, count \\ 20)

@spec get_history(GenServer.server(), pos_integer()) :: [feedback()]

reject(server \\ MODULE, recommendation_id)

@spec reject(GenServer.server(), binary()) :: :ok | {:error, :not_found}

start_link(opts \\ [])

@spec start_link(keyword()) :: GenServer.on_start()

submit_recommendation(server \\ MODULE, recommendation)

@spec submit_recommendation(GenServer.server(), map()) :: :ok