feat(M9): synthèse IA — protocole, providers OpenAI/litellm, factory, tests
Synthèse optionnelle via SDK openai (client injectable, prompt système FR, max 800 car., timeout 30 s, temp 0.3). Mode dégradé strict : generate() ne lève jamais, retourne None si clé absente/timeout/erreur. Provider litellm optionnel (extra ai-litellm) réutilisant le prompt OpenAI. Factory get_synthesis_provider() selon AISettings. 23 tests sans réseau, couverture synthesis/ 93%. Co-authored-by: opencode/coder <coder@agents.invalid> Co-authored-by: opencode/test-engineer <test-engineer@agents.invalid>
This commit is contained in:
27
pronote_sync/synthesis/provider.py
Normal file
27
pronote_sync/synthesis/provider.py
Normal file
@@ -0,0 +1,27 @@
|
||||
"""Protocole de fournisseur de synthèse IA."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Protocol, runtime_checkable
|
||||
|
||||
from pronote_sync.models.synthesis import SynthesisInput, SynthesisResult
|
||||
|
||||
__all__ = ["SynthesisProvider"]
|
||||
|
||||
|
||||
@runtime_checkable
|
||||
class SynthesisProvider(Protocol):
|
||||
"""Protocole pour un fournisseur de synthèse IA.
|
||||
|
||||
L'implémentation ne doit jamais lever d'exception : en cas
|
||||
d'échec, retourner ``None``.
|
||||
"""
|
||||
|
||||
def generate(self, input_data: SynthesisInput) -> SynthesisResult | None:
|
||||
"""Génère une synthèse IA à partir des données d'entrée.
|
||||
|
||||
:param input_data: Données de synthèse (diff agenda, messages, événements).
|
||||
:return: Résultat de la synthèse, ou ``None`` en cas d'échec.
|
||||
:rtype: SynthesisResult | None
|
||||
"""
|
||||
...
|
||||
Reference in New Issue
Block a user