Package com.tnsai.annotations

Annotation Interface QualityGate

@Documented @Retention(RUNTIME) @Target(METHOD) public @interface QualityGate
Defines an evaluation quality threshold for a method's output.

Usage


 @QualityGate(minScore = 0.8, evaluator = "relevance")
 public String chat(String message) { }

 @QualityGate(minScore = 0.9, evaluator = "factuality", onFail = OnFail.RETRY)
 public String answerQuestion(String question) { }
Since:
0.3.0

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static enum 
    QualityGate.OnFail
    Actions when quality gate fails.

  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    String
    evaluator
    Evaluator name (resolved via SPI, e.g., "relevance", "factuality", "toxicity").
    double
    minScore
    Minimum acceptable score (0.0-1.0).

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    int
    maxRetries
    Max retries when QualityGate.OnFail.RETRY is selected.
    QualityGate.OnFail
    onFail
    Action when the quality gate fails.

  • Element Details

    • minScore

      double minScore
      Minimum acceptable score (0.0-1.0).
      Returns:
      minimum score threshold

    • evaluator

      String evaluator
      Evaluator name (resolved via SPI, e.g., "relevance", "factuality", "toxicity").
      Returns:
      evaluator identifier

    • onFail

      QualityGate.OnFail onFail
      Action when the quality gate fails.
      Returns:
      failure action (default: LOG)
      Default:
      LOG

    • maxRetries

      int maxRetries
      Max retries when QualityGate.OnFail.RETRY is selected.
      Returns:
      max retries (default: 2)
      Default:
      2