.NET API
RunScore
Tracon.Abstractions.dllA human (or judge) score for a run or for a single message within a run.
public sealed record RunScore : IEquatable<RunScore>Inheritance
Section titled “Inheritance”Implements
Section titled “Implements”Inherited Members
Section titled “Inherited Members”object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
Section titled “Remarks”If RunScore.MessageId is empty, the score belongs to the whole run; if set, it belongs to a single message.
An author (RunScore.Author) writes the same RunScore.Name onto the
same target (a run or a message) once — a second write updates the existing
row, IRunScoreStore.UpsertAsync. A different
name from the same author opens a new row, so one reviewer can score the
same run for helpfulness and for accuracy side by side. When
RunScore.Author is empty (an identity-less setup), this rule does not
apply; every call opens a new row.
Constructors
Section titled “Constructors”RunScore()
Section titled “ RunScore()”public RunScore()Properties
Section titled “Properties”Author
Section titled “ Author”The actor who gave the score. null in an identity-less setup.
public string? Author { get; init; }Property Value
Section titled “Property Value”Comment
Section titled “ Comment”A free-text comment.
public string? Comment { get; init; }Property Value
Section titled “Property Value”CreatedAt
Section titled “ CreatedAt”The creation/last-updated time.
public DateTimeOffset CreatedAt { get; init; }Property Value
Section titled “Property Value”The score’s identifier.
public Guid Id { get; init; }Property Value
Section titled “Property Value”The shape of the value.
public required RunScoreKind Kind { get; init; }Property Value
Section titled “Property Value”MessageId
Section titled “ MessageId”The identifier of the message being scored. If empty, the score belongs to the whole run.
public string? MessageId { get; init; }Property Value
Section titled “Property Value”The score’s stable, low-cardinality name — part of the uniqueness key.
public required string Name { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”Must match [A-Za-z0-9._-]{1,64}, the same rule as
IRunJudge.Name. It is used as a metric tag and as a score
field, so it must stay low-cardinality; a run identifier or a timestamp
does not belong here. RunScoreRules carries the rule.
The identifier of the run being scored.
public required Guid RunId { get; init; }Property Value
Section titled “Property Value”Source
Section titled “ Source”The score’s source: human, api, or judge:{name}.
public required string Source { get; init; }Property Value
Section titled “Property Value”TenantId
Section titled “ TenantId”The tenant.
public required string TenantId { get; init; }Property Value
Section titled “Property Value”TextValue
Section titled “ TextValue”The categorical value. Set only for a RunScoreKind.Categorical score.
public string? TextValue { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”At most RunScoreRules.MaxTextValueLength characters; free-form prose belongs in RunScore.Comment.
The numeric value: 0/1 for RunScoreKind.Binary, 1 to 5 for RunScoreKind.Stars, 0 to 100 for RunScoreKind.Numeric.
public double? Value { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”null means no measurement was made, not zero — the same rule JudgeScore.Value already states. Always null when RunScore.Kind is RunScoreKind.Categorical.
Methods
Section titled “Methods”Equals(object?)
Section titled “ Equals(object?)”public override bool Equals(object? obj)Parameters
Section titled “Parameters”obj object?
Returns
Section titled “Returns”Equals(RunScore?)
Section titled “ Equals(RunScore?)”public bool Equals(RunScore? other)Parameters
Section titled “Parameters”other RunScore?
Returns
Section titled “Returns”GetHashCode()
Section titled “ GetHashCode()”public override int GetHashCode()Returns
Section titled “Returns”ToString()
Section titled “ ToString()”public override string ToString()Returns
Section titled “Returns”Operators
Section titled “Operators”operator ==(RunScore?, RunScore?)
Section titled “ operator ==(RunScore?, RunScore?)”public static bool operator ==(RunScore? left, RunScore? right)Parameters
Section titled “Parameters”left RunScore?
right RunScore?
Returns
Section titled “Returns”operator !=(RunScore?, RunScore?)
Section titled “ operator !=(RunScore?, RunScore?)”public static bool operator !=(RunScore? left, RunScore? right)Parameters
Section titled “Parameters”left RunScore?
right RunScore?