plexus.feedback_item_explanations module
Shared feedback-item explanation generation and cache persistence.
- exception plexus.feedback_item_explanations.FeedbackItemExplanationTimeoutError(provider: 'str', model: 'str', attempt_count: 'int', elapsed_seconds: 'float', last_error_type: 'str', last_error_message: 'str', feedback_item_id: 'Optional[str]' = None)
Bases:
RuntimeError- __init__(provider: str, model: str, attempt_count: int, elapsed_seconds: float, last_error_type: str, last_error_message: str, feedback_item_id: str | None = None) None
- attempt_count: int
- property diagnostics: Dict[str, Any]
- elapsed_seconds: float
- feedback_item_id: str | None = None
- last_error_message: str
- last_error_type: str
- model: str
- provider: str
- async plexus.feedback_item_explanations.get_or_generate_feedback_item_explanation(*, feedback_item: Any, api_client: Any | None, predicted_value: str, correct_value: str, score_explanation: str, original_explanation: str, score_guidelines_text: str, scorecard_guidance_text: str, transcript_text: str, item_metadata_snapshot: str, initial_comment: str, final_comment: str, provider: str | None = 'auto', model: str | None = None, force_refresh: bool = False) Dict[str, Any]
Get cached feedback-item explanation or generate and persist it.
- async plexus.feedback_item_explanations.hydrate_feedback_item_explanations(*, feedback_items: List[Any], api_client: Any | None, score_results_by_item_id: Dict[str, Dict[str, Any]] | None = None, score_results_by_feedback_id: Dict[str, Dict[str, Any]] | None = None, original_explanations_by_feedback_id: Dict[str, str] | None = None, transcript_by_item_id: Dict[str, str] | None = None, item_metadata_snapshot_by_item_id: Dict[str, str] | None = None, score_guidelines_text: str = '', scorecard_guidance_text: str = '', provider: str | None = 'auto', model: str | None = None, max_concurrent: int = 8) Dict[str, Dict[str, Any]]
Hydrate explanation cache for each feedback item and return explanation payloads.