// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
namespace Microsoft.Extensions.AI.Evaluation.NLP;
 
/// <summary>
/// Contextual information that the <see cref="F1Evaluator"/> uses to compute the F1 score for a response.
/// </summary>
/// <remarks>
/// <see cref="F1Evaluator"/> measures the F1 score of a response compared to a reference response that is supplied via
/// <see cref="GroundTruth" />. F1 is a metric used to valuate the quality of machine-generated text. It is the ratio
/// of the number of shared words between the generated response and the reference response.
/// </remarks>
public sealed class F1EvaluatorContext : EvaluationContext
{
    /// <summary>
    /// Gets the unique <see cref="EvaluationContext.Name"/> that is used for
    /// <see cref="F1EvaluatorContext"/>.
    /// </summary>
    public static string GroundTruthContextName => "Ground Truth (F1)";
 
    /// <summary>
    /// Gets the reference response against which the provided response will be scored.
    /// </summary>
    /// <remarks>
    /// The <see cref="F1Evaluator"/> measures the degree to which the response being evaluated is similar to
    /// the response supplied via <see cref="GroundTruth"/>. The metric will be reported as an F1 score.
    /// </remarks>
    public string GroundTruth { get; }
 
    /// <summary>
    /// Initializes a new instance of the <see cref="F1EvaluatorContext"/> class.
    /// </summary>
    /// <param name="groundTruth">
    /// The reference response against which the provided response will be scored.
    /// </param>
    public F1EvaluatorContext(string groundTruth)
        : base(
            name: GroundTruthContextName,
            content: groundTruth)
    {
        GroundTruth = groundTruth;
    }
}