Skip to main content
GitHub

OUTPUT

Response generation failures.

The OUTPUT module covers errors in generating and delivering agent responses. This includes structural formatting, response quality, and safety concerns.

Categories

FORMAT

Output formatting failures.

CodeSeverityDescriptionRemediation
OUTPUT.FORMAT.INVALID_JSON3Invalid JSON outputUse structured output parsing
OUTPUT.FORMAT.SCHEMA_VIOLATION4Output violates schemaValidate against output schema
OUTPUT.FORMAT.MALFORMED3Malformed output structureImplement output validation
OUTPUT.FORMAT.TRUNCATED2Output was truncatedHandle output length limits
OUTPUT.FORMAT.ENCODING2Output encoding issuesNormalize output encoding

QUALITY

Output quality failures.

CodeSeverityDescriptionRemediation
OUTPUT.QUALITY.INCOMPLETE3Incomplete responseValidate response completeness
OUTPUT.QUALITY.IRRELEVANT3Response is irrelevant to queryImprove response relevance
OUTPUT.QUALITY.VERBOSE2Overly verbose responseImplement response length optimization
OUTPUT.QUALITY.UNCLEAR2Unclear or ambiguous responseAdd clarity checks
OUTPUT.QUALITY.REPETITIVE2Repetitive content in responseDetect and reduce repetition

SAFETY

Output safety failures.

CodeSeverityDescriptionRemediation
OUTPUT.SAFETY.HARMFUL_CONTENT5Potentially harmful contentImplement content filtering
OUTPUT.SAFETY.PII_LEAK5PII leaked in outputImplement PII detection and masking
OUTPUT.SAFETY.BIAS4Biased content in outputImplement bias detection
OUTPUT.SAFETY.POLICY_VIOLATION4Output violates policyAdd policy compliance checks
OUTPUT.SAFETY.COPYRIGHT3Potential copyright violationImplement copyright checks

Danger

OUTPUT.SAFETY.HARMFUL_CONTENT and OUTPUT.SAFETY.PII_LEAK are both severity 5. These errors trigger immediate alerts and should be treated as blocking issues that prevent the response from being delivered to the user.

Example Diagnosis

{
  "error_code": "OUTPUT.FORMAT.SCHEMA_VIOLATION",
  "confidence": 0.88,
  "root_cause": "Agent returned a string where the downstream consumer expected a JSON object with 'result' and 'status' fields.",
  "suggested_fixes": ["prompt", "guard"]
}

Next Steps