Champion and Challenger Models
An API call using a RASON model or decision flow name always refers to the "champion" version of that model or flow, which by default is the most
recent version. The user can designate a specific version (resource ID) as the current "champion" via the API call PATCH rason.net/api/model/nameorid
with "champion in the body, marking that resource ID as the current "champion" (i.e. the model name to use when future API calls specify the model/flow name;
then the user can create newer versions as "challengers". An API call to PATCH rason.net/api/model/{nameorid} with "challenger" in the body, or an
empty body if just posting new data files, unmark's the resource ID as the champion, reverting to the rule that the most recent version is the "champion".
Similarly, when a RASON model uses a fittedModel for scoring by referencing its name in a datasource declaration, the champion version will be retrieved.
By default, this is the most recent version. But the user can designate a specific fittedModel version as the current "champion" via the API call PATCH
rason.net/api/model/{id} with the string "champion" in the body, where ID designates the model instance where the relevant fittedModel version was produced;
then the user can create newer versions as "challengers". As with RASON models, PATCH rason.net/api/model/{id} with the string "challenger" in the body,
or an empty body, "unmarks" the fittedModel version as the champion, reverting to the rule that the most recent version is the champion.
|