Spec, vérifications de la phase 0, instance de test, plan de la phase 1
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e323ebbd8a
commit
cbaab49d3f
6 files changed
+970
No files matched your search
@@ -0,0 +1 @@
|
|||||||
|
.superpowers/
|
||||||
@@ -0,0 +1,292 @@
|
|||||||
|
# Phase 1 : squelette sécurisé, instance de test — plan d'implémentation
|
||||||
|
|
||||||
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||||
|
|
||||||
|
**Goal :** une conversation LibreDesk étiquetée `tri:diagnostic` reçoit, sur l'instance de test, une note privée « Brouillon IA » écrite par les agents support et analyste, avec ses étiquettes d'état, sans qu'aucun message sortant n'apparaisse.
|
||||||
|
|
||||||
|
**Architecture :** un point d'entrée non interactif, `python -m support_diagnostic.run`, lit les conversations éligibles par l'API LibreDesk, passe chaque mail aux agents existants (copiés de `Support-Agent/API/`, sortie mail), et seul ce code déterministe écrit dans LibreDesk : une note privée et des étiquettes, par un client restreint. L'état vit dans les étiquettes. Un workflow Gitea le lance à la main.
|
||||||
|
|
||||||
|
**Tech Stack :** Python ≥ 3.12, bibliothèque standard (urllib, http.server, unittest) ; `anthropic`, `langsmith`, `matplotlib` pour les agents copiés ; Docker Compose pour l'instance de test ; Gitea Actions.
|
||||||
|
|
||||||
|
**Spec :** `docs/spec.md` (§1, §6.2, §7, §8 S1, §9) ; constats de la phase 0 : `docs/verifications.md`.
|
||||||
|
|
||||||
|
## Global Constraints
|
||||||
|
|
||||||
|
- **Aucun message ne part au client** (spec §1). Le seul `POST …/messages` du dépôt est dans `LibreDesk.note_privee`, avec `"private": True` en dur, `"sender_type": "agent"`, jamais `to`, `cc`, `bcc`.
|
||||||
|
- Les agents LLM n'écrivent jamais dans LibreDesk : ils reçoivent du texte, rendent du texte (spec §7.4).
|
||||||
|
- `DRY_RUN` : seule la valeur exacte `false` permet d'écrire ; absente ou toute autre valeur, rien n'est écrit (spec §7.5).
|
||||||
|
- Écrire exige aussi `ALLOWED_CONVERSATION_IDS` non vide : des uuid séparés par des virgules, ou `*` pour toutes (spec §7.6).
|
||||||
|
- `MAX_CONVERSATIONS_PER_RUN` : défaut `3` (spec §7.7).
|
||||||
|
- `KILL_SWITCH` non vide et différent de `false` et `0` : sortie immédiate, code 0, rien lu ni écrit (spec §7.8).
|
||||||
|
- Le compte technique a le rôle « Agent IA » : `conversations:read`, `conversations:read_all`, `messages:read`, `messages:write_private`, `conversations:update_tags`, et rien d'autre (verifications.md, point 1).
|
||||||
|
- Étiquettes, toujours avec `action` `add_tags` ou `remove_tags`, jamais `set_tags` ni sans `action` (sans, LibreDesk remplace toutes les étiquettes).
|
||||||
|
- Contrat d'étiquettes (à confirmer par Maxime à la revue du plan) : `tri:diagnostic`, `diag:en-cours`, `diag:fait`, `diag:erreur`, `diag:ignore`, `diag:relancer`. Éligible : `tri:diagnostic` présent et (aucune `diag:*` ou `diag:relancer` présente).
|
||||||
|
- En-tête de chaque note, mot pour mot : `🤖 BROUILLON IA — à relire, ne pas envoyer tel quel`. Pas de mention `@agent` (spec §7.11, §7.12).
|
||||||
|
- Langue : code et documents en français, comme `Support-Agent`.
|
||||||
|
- Le runner Gitea : son label est inconnu (verifications.md, Gitea) ; les workflows portent `runs-on: ubuntu-latest` jusqu'à ce que Maxime donne le label.
|
||||||
|
|
||||||
|
## Hors de ce plan
|
||||||
|
|
||||||
|
- Phase 2 et au-delà : la planification (cron), la production.
|
||||||
|
- **Les données des stations sur le runner** (verifications.md, point 6) : en phase 1, le diagnostic réel tourne sur le poste avec `AIMSIGHT_DATA=~/Support-Agent/data` ; le workflow ne fait qu'un passage à blanc. À décider avant la phase 2. De même : en phase 2, un cron en simulation, qui n'écrit pas d'étiquette, rediagnostiquerait les mêmes conversations à chaque passage.
|
||||||
|
- Les verrous orphelins (`diag:en-cours` laissé par un runner tué, spec §9.3) : un humain retire l'étiquette ; marqué `ponytail:` dans le code.
|
||||||
|
- `supprimer_note` (spec §7.2) : inutile tant que l'instance de test se remet à zéro par `docker compose down -v`.
|
||||||
|
- Le nom du site → la station (Crissier = LENZSPITZE) : le support le déduit du mail, ou le demande, et sa question devient la note (`diag:ignore`).
|
||||||
|
|
||||||
|
## Review Focus
|
||||||
|
|
||||||
|
1. Une conversation porte déjà une étiquette d'un humain (`urgent`) : nos opérations ne la retirent jamais. → Tâche 2, `test_etiqueter_n_envoie_jamais_set`.
|
||||||
|
2. La réponse de LibreDesk à la note n'est pas une note privée (changement d'API, 200 sans `private: true`) : tout s'arrête, plus rien n'est écrit. → Tâches 2 et 4, `test_note_non_privee_leve_garde`, `test_garde_arrete_tout`.
|
||||||
|
3. Les agents échouent au milieu d'une conversation : `diag:en-cours` est retiré, `diag:erreur` posé, la suivante est traitée. → Tâche 4, `test_erreur_passe_a_la_suivante`.
|
||||||
|
4. Relance (`diag:relancer`) d'une conversation où figure déjà notre note : notre note n'entre ni dans le mail ni dans le contexte ; les notes privées des humains entrent dans le contexte. → Tâche 4, `test_relance_ecarte_nos_notes`.
|
||||||
|
5. Mail du client vide (image seule, HTML sans texte) : pas d'appel aux agents, `diag:ignore` et une note qui le dit. → Tâche 4, `test_mail_vide_ignore`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
Support-AI/
|
||||||
|
agents/ copie de Support-Agent/API/ (prompts, knowledge, tools sans typst/, support/), PROVENANCE.md
|
||||||
|
support_diagnostic/
|
||||||
|
__init__.py
|
||||||
|
libredesk.py le client restreint (seul à parler à LibreDesk)
|
||||||
|
diagnostic.py l'adaptateur vers agents/support/seance.py
|
||||||
|
run.py la configuration, le cycle, la note
|
||||||
|
tests/
|
||||||
|
faux_libredesk.py un faux LibreDesk (http.server) qui enregistre les requêtes
|
||||||
|
test_libredesk.py
|
||||||
|
test_garde_fou.py
|
||||||
|
test_diagnostic.py
|
||||||
|
test_run.py
|
||||||
|
test_instance.py intégration, sautée sans LIBREDESK_TEST_URL
|
||||||
|
instance-de-test/ docker-compose.yml, verifier.py (phase 0), preparer.py
|
||||||
|
.gitea/workflows/tests.yml, diagnostic.yml
|
||||||
|
requirements.txt, .gitignore, README.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Tests : `python -m unittest discover -s tests -v` depuis la racine.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 1 : la copie des agents
|
||||||
|
|
||||||
|
**Files :**
|
||||||
|
- Create : `agents/` (copie), `agents/PROVENANCE.md`, `requirements.txt`, `.gitignore`
|
||||||
|
|
||||||
|
**Interfaces :**
|
||||||
|
- Produces : `agents/support/seance.py` (`Seance`, `CASES`), `agents/support/agent.py`, inchangés ; `requirements.txt`.
|
||||||
|
|
||||||
|
- [ ] **Step 1 : copier** `Support-Agent/API/` vers `agents/`, sans `cases/`, `docs/`, `.venv/`, `.env`, `__pycache__/`, `tools/typst/` (la sortie PDF n'est pas utilisée). `agents/PROVENANCE.md` : la provenance de `API/PROVENANCE.md`, plus une ligne « `Support-Agent/API/` → `agents/`, commit `<sha de Support-Agent>`, 2026-11-09, sans `tools/typst/` ni `cases/` ».
|
||||||
|
- [ ] **Step 2 : `requirements.txt`** = celui de `API/` (`anthropic`, `langsmith`, `matplotlib`). `.gitignore` : `.venv/`, `__pycache__/`, `.env`, `cases/`, `instance-de-test/config.toml`, `instance-de-test/uploads/`.
|
||||||
|
- [ ] **Step 3 : vérifier que le prompt du support se construit sans la PDF**
|
||||||
|
|
||||||
|
Run : `python3 -m venv .venv && .venv/bin/pip install -r requirements.txt && .venv/bin/python -c "import sys; sys.path.insert(0,'agents/support'); import seance; print(len(seance.systeme('support','mail')), len(seance.systeme('analyste')))"`
|
||||||
|
Expected : deux nombres > 10000, pas d'exception.
|
||||||
|
|
||||||
|
- [ ] **Step 4 : commit** `git add agents requirements.txt .gitignore && git commit -m "Copie des agents de Support-Agent/API (sortie mail)"`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 2 : le client LibreDesk restreint
|
||||||
|
|
||||||
|
**Files :**
|
||||||
|
- Create : `support_diagnostic/__init__.py` (vide), `support_diagnostic/libredesk.py`, `tests/faux_libredesk.py`, `tests/test_libredesk.py`, `tests/test_garde_fou.py`
|
||||||
|
|
||||||
|
**Interfaces :**
|
||||||
|
- Produces :
|
||||||
|
- `class Garde(Exception)` : anomalie du garde-fou d'envoi ; l'appelant arrête toute l'exécution.
|
||||||
|
- `class LibreDesk(url: str, cle: str, secret: str, ecrire: bool)` ; en-tête `Authorization: token <cle>:<secret>` ; timeout 30 s.
|
||||||
|
- `moi() -> int` : l'id du compte technique (`GET /api/v1/agents/me`).
|
||||||
|
- `ids_etiquettes() -> dict[str, int]` (`GET /api/v1/tags`).
|
||||||
|
- `conversations(avec: int) -> list[dict]` : toutes les pages de `GET /api/v1/conversations/all?page_size=50&filters=…` avec le filtre `{"model":"conversations","field":"tags","operator":"contains","value":"[<avec>]"}`.
|
||||||
|
- `etiquettes(uuid: str) -> list[str]` (`GET /api/v1/conversations/{uuid}` → `tags`).
|
||||||
|
- `messages(uuid: str) -> list[dict]` (`GET …/messages?page_size=500`).
|
||||||
|
- `piece(url: str) -> bytes`.
|
||||||
|
- `etiqueter(uuid: str, ajouter: list[str] = (), retirer: list[str] = ()) -> None` : un `POST …/tags` par action non vide ; si `ecrire` est faux, journalise et ne fait rien ; après un ajout, relit `etiquettes(uuid)` et lève `RuntimeError` s'il en manque une (LibreDesk ignore en silence une étiquette inconnue).
|
||||||
|
- `note_privee(uuid: str, html: str) -> dict | None` : si `ecrire` est faux, journalise `[simulation] note pour <uuid>` puis le html, rend `None` ; sinon `POST …/messages` avec exactement `{"message": html, "private": True, "sender_type": "agent"}`, et lève `Garde` si la réponse n'a pas `private is True`.
|
||||||
|
- Aucune autre méthode qui écrit ; pas de méthode de requête générique publique.
|
||||||
|
|
||||||
|
- [ ] **Step 1 : le faux LibreDesk.** `tests/faux_libredesk.py` : `FauxLibreDesk()` démarre un `ThreadingHTTPServer` sur `127.0.0.1:0` ; `.url` ; `.requetes : list[tuple[str, str, dict | None]]` (méthode, chemin avec la requête, corps JSON) ; `.reponses : dict[tuple[str, str], object]` (méthode, chemin sans la requête → la valeur de `data`, ou un `int` pour un code d'erreur) ; `.arreter()`.
|
||||||
|
- [ ] **Step 2 : les tests qui échouent**, dans `tests/test_libredesk.py` :
|
||||||
|
|
||||||
|
```python
|
||||||
|
def test_note_privee_envoie_exactement_le_corps_fige(self):
|
||||||
|
self.faux.reponses[("POST", "/api/v1/conversations/c1/messages")] = {"uuid": "m1", "private": True}
|
||||||
|
LibreDesk(self.faux.url, "k", "s", ecrire=True).note_privee("c1", "<p>x</p>")
|
||||||
|
m, chemin, corps = self.faux.requetes[-1]
|
||||||
|
assert (m, chemin) == ("POST", "/api/v1/conversations/c1/messages")
|
||||||
|
assert corps == {"message": "<p>x</p>", "private": True, "sender_type": "agent"}
|
||||||
|
|
||||||
|
def test_note_non_privee_leve_garde(self): # réponse {"uuid": "m1", "private": False}, puis {} : Garde les deux fois
|
||||||
|
def test_simulation_n_ecrit_rien(self): # ecrire=False : note_privee et etiqueter → aucune requête POST
|
||||||
|
def test_etiqueter_n_envoie_jamais_set(self): # etiqueter("c1", ["diag:fait"], ["diag:en-cours"]) : deux POST,
|
||||||
|
# actions add_tags puis remove_tags, aucun autre champ
|
||||||
|
def test_etiquette_inconnue_leve(self): # après add_tags, GET rend tags sans "diag:fait" → RuntimeError
|
||||||
|
def test_authentification(self): # en-tête Authorization == "token k:s" (le faux l'enregistre aussi)
|
||||||
|
def test_conversations_pagine_et_filtre(self):# deux pages (total_pages=2) → résultats concaténés ; le filtre
|
||||||
|
# décodé == [{"model":"conversations","field":"tags","operator":"contains","value":"[7]"}]
|
||||||
|
```
|
||||||
|
|
||||||
|
Et `tests/test_garde_fou.py` (spec §7.10), sur le texte de `support_diagnostic/*.py` :
|
||||||
|
|
||||||
|
```python
|
||||||
|
def test_un_seul_post_de_messages(self):
|
||||||
|
# "/messages" n'apparaît que dans libredesk.py, dans le corps de note_privee et de messages() (GET)
|
||||||
|
def test_private_en_dur(self):
|
||||||
|
# libredesk.py contient '"private": True' ; aucun fichier ne contient '"to"', '"cc"', '"bcc"', 'set_tags'
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 3 : lancer, vérifier l'échec** — Run : `.venv/bin/python -m unittest tests.test_libredesk tests.test_garde_fou -v` — Expected : ImportError sur `support_diagnostic.libredesk`.
|
||||||
|
- [ ] **Step 4 : écrire `support_diagnostic/libredesk.py`** (urllib, comme `Support-Agent/app/serveur/libredesk.py` ; `add_unredirected_header` pour l'authentification).
|
||||||
|
- [ ] **Step 5 : lancer, vérifier le succès** — même commande — Expected : tout OK.
|
||||||
|
- [ ] **Step 6 : commit** `git commit -m "Client LibreDesk restreint : notes privées et étiquettes seulement"`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 3 : l'adaptateur vers les agents
|
||||||
|
|
||||||
|
**Files :**
|
||||||
|
- Create : `support_diagnostic/diagnostic.py`, `tests/test_diagnostic.py`
|
||||||
|
|
||||||
|
**Interfaces :**
|
||||||
|
- Consumes : `agents/support/seance.py` (`Seance(mail, images, contexte, donnees, journal, client=None, sortie="mail")`, `.demarrer()`, `.derniere_version()`, `.cout()`, `.support.messages`, `.dossier`, le module attribut `CASES`).
|
||||||
|
- Produces :
|
||||||
|
- `@dataclass Resultat: statut: str` (`"fait"` ou `"ignore"`) `, texte: str, pieces: list[Path], cout: float, dossier: Path | None` (`None` quand les agents n'ont pas tourné)
|
||||||
|
- `MODELE = "claude-opus-5-5"` (celui de `agents/support/agent.py`, pour le pied de note)
|
||||||
|
- `diagnostiquer(mail: str, images: list[tuple[str, bytes]], contexte: str, donnees: Path, cases: Path, client=None) -> Resultat`
|
||||||
|
|
||||||
|
Approche : `sys.path` reçoit `agents/support` ; `seance.CASES = cases` avant de créer la séance ; `journal` écrit chaque événement en une ligne sur stdout (`[agent] type : texte`, tronqué à 300 caractères). Si `derniere_version()` existe : `fait`, `texte` et `pieces` (chemins dans `s.dossier`) lus du JSON. Sinon : `ignore`, `texte` = le texte du dernier message `assistant` du support (sa question ou son explication). Une exception des agents remonte telle quelle.
|
||||||
|
|
||||||
|
- [ ] **Step 1 : les tests qui échouent**, avec un faux client Anthropic sur le modèle de `agents/support/check.py` (`FauxClient`, `reponse`, `Bloc` : les recopier dans le test, `check.py` n'est pas importable sans données) :
|
||||||
|
|
||||||
|
```python
|
||||||
|
def test_mail_ecrit_donne_fait(self):
|
||||||
|
# le support appelle ecrire_mail({"texte": "Bonjour, …", "pieces_jointes": []}) puis end_turn
|
||||||
|
r = diagnostiquer("mail", [], "", Path(tmp), Path(tmp), client=faux)
|
||||||
|
assert r.statut == "fait" and r.texte == "Bonjour, …" and r.pieces == []
|
||||||
|
|
||||||
|
def test_question_donne_ignore(self):
|
||||||
|
# le support répond par du texte, end_turn, sans ecrire_mail
|
||||||
|
assert r.statut == "ignore" and r.texte == "Quelle station ?"
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2 : lancer, vérifier l'échec** — Run : `.venv/bin/python -m unittest tests.test_diagnostic -v` — Expected : ImportError.
|
||||||
|
- [ ] **Step 3 : écrire `support_diagnostic/diagnostic.py`**.
|
||||||
|
- [ ] **Step 4 : lancer, vérifier le succès** — même commande — Expected : OK.
|
||||||
|
- [ ] **Step 5 : commit** `git commit -m "Adaptateur non interactif vers le support et l'analyste"`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 4 : le cycle
|
||||||
|
|
||||||
|
**Files :**
|
||||||
|
- Create : `support_diagnostic/run.py`, `tests/test_run.py`
|
||||||
|
|
||||||
|
**Interfaces :**
|
||||||
|
- Consumes : `LibreDesk`, `Garde` (tâche 2) ; `diagnostiquer`, `Resultat`, `MODELE` (tâche 3).
|
||||||
|
- Produces :
|
||||||
|
- `@dataclass Config: url, cle, secret: str; ecrire: bool; autorisees: set[str] | None` (`None` = `*`) `; plafond: int; conversation: str` (`""` = toutes) `; donnees: Path; cases: Path`
|
||||||
|
- `Config.depuis_env(env: Mapping[str, str]) -> Config | None` : `None` si `KILL_SWITCH` est actif. Variables : `LIBREDESK_URL`, `LIBREDESK_API_KEY`, `LIBREDESK_API_SECRET`, `DRY_RUN`, `ALLOWED_CONVERSATION_IDS`, `MAX_CONVERSATIONS_PER_RUN`, `KILL_SWITCH`, `CONVERSATION`, `AIMSIGHT_DATA` (défaut `data`), `AIMSIGHT_CASES` (défaut un dossier temporaire). Lève `ValueError` si `ecrire` et `ALLOWED_CONVERSATION_IDS` vide.
|
||||||
|
- `eligible(etiquettes: list[str]) -> bool`
|
||||||
|
- `fil(messages: list[dict], moi: int) -> tuple[str, str]` : (le mail, le contexte). Le mail : messages `incoming` et `outgoing` non privés, le plus récent en tête, au format de `mail()` de `Support-Agent/app/serveur/libredesk.py` (le recopier). Le contexte : les notes privées dont l'auteur n'est pas `moi`, en texte.
|
||||||
|
- `note(r: Resultat, execution: str) -> str` : le HTML de la note.
|
||||||
|
- `traiter(ld: LibreDesk, cfg: Config, diag=diagnostiquer) -> dict[str, str]` : uuid → statut (`fait`, `ignore`, `erreur`).
|
||||||
|
- `main() -> int` : `python -m support_diagnostic.run` ; code 1 sur `Garde`.
|
||||||
|
|
||||||
|
Le cycle de `traiter` (spec §9.2) :
|
||||||
|
1. Candidates : `ld.conversations(ids["tri:diagnostic"])`, ou la seule `cfg.conversation` ; garder celles dont `eligible(ld.etiquettes(uuid))` et, si `cfg.autorisees`, l'uuid y est ; s'arrêter à `cfg.plafond`.
|
||||||
|
2. Pour chacune : `etiqueter(uuid, ["diag:en-cours"])` ; `fil(ld.messages(uuid), ld.moi())` ; images des messages entrants (types `image/png|jpeg|gif|webp`, ≥ 10 000 octets, comme `Support-Agent`) ; mail vide après `strip()` → `Resultat("ignore", "Le mail du client ne contient pas de texte.", …)` sans appeler `diag` ; sinon `diag(...)` ; `note_privee(uuid, note(r, execution))` ; `etiqueter(uuid, ["diag:" + r.statut], ["diag:en-cours", "diag:relancer"])`.
|
||||||
|
3. Exception d'une conversation (autre que `Garde`) : `note_privee(uuid, …)` courte (en-tête, « Diagnostic en échec », nom de l'exception, `execution`), `etiqueter(uuid, ["diag:erreur"], ["diag:en-cours"])`, chacun dans son propre `try` ; conversation suivante.
|
||||||
|
4. `Garde` : `etiqueter(uuid, ["diag:erreur"])` dans un `try`, puis la relancer : tout s'arrête.
|
||||||
|
5. Fin : une ligne par conversation (uuid, statut, coût), le total, la durée.
|
||||||
|
|
||||||
|
`execution` : `${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}` si ces variables existent (Gitea les fournit), sinon `local` ; plus `GITHUB_SHA[:7]`.
|
||||||
|
|
||||||
|
La note (spec §8, version de départ ; format à valider avec l'équipe support) :
|
||||||
|
|
||||||
|
```html
|
||||||
|
<p><strong>🤖 BROUILLON IA — à relire, ne pas envoyer tel quel</strong></p>
|
||||||
|
<p><em>Proposition de réponse au client :</em></p> <!-- statut fait ; « Pas de proposition : » pour ignore -->
|
||||||
|
<p>…texte échappé (html.escape), un <p> par paragraphe, <br> aux retours simples…</p>
|
||||||
|
<p><em>Figures préparées (non jointes) : figure-1.png, …</em></p> <!-- seulement s'il y en a -->
|
||||||
|
<hr><p><small>Exécution … · commit … · modèle claude-opus-5-5 · coût 1.23 $</small></p>
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 1 : les tests qui échouent**, `tests/test_run.py`, avec un faux `LibreDesk` en mémoire (mêmes méthodes, enregistre les appels ; `ecrire` comme le vrai) et un faux `diag` :
|
||||||
|
|
||||||
|
```python
|
||||||
|
def test_dry_run_par_defaut(self): # depuis_env({...sans DRY_RUN}).ecrire is False ; "False", "0", "no" → False ; "false" → True
|
||||||
|
def test_ecrire_exige_liste_blanche(self):# DRY_RUN=false sans ALLOWED_CONVERSATION_IDS → ValueError ; "*" → autorisees is None
|
||||||
|
def test_kill_switch(self): # KILL_SWITCH="1" → None ; "false", "0", "" → Config
|
||||||
|
def test_eligible(self): # ["tri:diagnostic"] True ; + "diag:fait" False ; + "diag:fait","diag:relancer" True ; [] False
|
||||||
|
def test_plafond_et_liste_blanche(self): # 5 éligibles, plafond 3 → 3 traitées ; liste blanche {c2} → seule c2
|
||||||
|
def test_cycle_fait(self): # étiquettes : add en-cours, puis add diag:fait / remove en-cours, relancer ;
|
||||||
|
# une note qui commence par l'en-tête exact et contient le texte du diag
|
||||||
|
def test_mail_vide_ignore(self): # Review Focus 5
|
||||||
|
def test_erreur_passe_a_la_suivante(self):# Review Focus 3 : diag lève sur c1 → c1 "erreur" (en-cours retiré), c2 "fait"
|
||||||
|
def test_garde_arrete_tout(self): # Review Focus 2 : note_privee lève Garde sur c1 → c2 jamais lue, Garde remonte
|
||||||
|
def test_relance_ecarte_nos_notes(self): # Review Focus 4 : fil() avec une note privée de moi (exclue) et une d'un
|
||||||
|
# humain (dans le contexte, pas dans le mail)
|
||||||
|
def test_note_echappe_le_html(self): # texte "<script>" → "<script>" dans la note
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2 : lancer, vérifier l'échec** — Run : `.venv/bin/python -m unittest tests.test_run -v` — Expected : ImportError.
|
||||||
|
- [ ] **Step 3 : écrire `support_diagnostic/run.py`**, avec le commentaire `# ponytail: verrou orphelin non détecté (runner tué) : un humain retire diag:en-cours ; date de l'étiquette si ça arrive` à la pose de `diag:en-cours`.
|
||||||
|
- [ ] **Step 4 : lancer tous les tests** — Run : `.venv/bin/python -m unittest discover -s tests -v` — Expected : OK (`test_instance` sauté).
|
||||||
|
- [ ] **Step 5 : commit** `git commit -m "Cycle : conversations éligibles, agents, note privée, étiquettes d'état"`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 5 : l'instance de test, de bout en bout
|
||||||
|
|
||||||
|
**Files :**
|
||||||
|
- Create : `instance-de-test/preparer.py`, `tests/test_instance.py`
|
||||||
|
|
||||||
|
**Interfaces :**
|
||||||
|
- Consumes : `traiter`, `Config` (tâche 4), `LibreDesk` (tâche 2).
|
||||||
|
- Produces : `preparer.py <mot de passe System> <fichier du mail>` : sur une instance neuve, crée la boîte e-mail (SMTP = Mailpit), les six étiquettes du contrat, le rôle « Agent IA » (les cinq permissions), l'agent et sa clé, une conversation du contact avec le mail du fichier, étiquetée `tri:diagnostic` ; écrit dans `instance-de-test/.env` (hors de git) `LIBREDESK_URL`, `LIBREDESK_API_KEY`, `LIBREDESK_API_SECRET`, `CONVERSATION` ; reprend les appels de `verifier.py` (cookie de session sans `Secure`, `csrf_token` posé à la main, `initiator: "contact"`).
|
||||||
|
|
||||||
|
- [ ] **Step 1 : `tests/test_instance.py`**, sauté sans `LIBREDESK_TEST_URL` :
|
||||||
|
|
||||||
|
```python
|
||||||
|
def test_bout_en_bout_sans_envoi(self):
|
||||||
|
# instance préparée ; traiter() avec ecrire=True, autorisees={CONVERSATION}, diag factice (pas d'appel API) :
|
||||||
|
# la conversation porte diag:fait sans diag:en-cours ; son dernier message est private et commence par l'en-tête ;
|
||||||
|
# Mailpit (GET http://127.0.0.1:9125/api/v1/messages) : messages_count inchangé
|
||||||
|
```
|
||||||
|
|
||||||
|
- [ ] **Step 2 : écrire `preparer.py`**, lancer l'instance neuve et le test
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd instance-de-test && docker compose -p ldtest down -v; LIBREDESK_SYSTEM_USER_PASSWORD='TestAdmin-2026!' docker compose -p ldtest up -d
|
||||||
|
```
|
||||||
|
```bash
|
||||||
|
.venv/bin/python -I instance-de-test/preparer.py 'TestAdmin-2026!' instance-de-test/mail-exemple.txt && set -a && . instance-de-test/.env && set +a && LIBREDESK_TEST_URL=$LIBREDESK_URL .venv/bin/python -m unittest tests.test_instance -v
|
||||||
|
```
|
||||||
|
Expected : OK. `mail-exemple.txt` : un mail inventé sur une station de `Support-Agent/data/` (pas un vrai mail de client dans un dépôt public).
|
||||||
|
|
||||||
|
- [ ] **Step 3 : le vrai diagnostic, une fois** (critère de sortie de la phase ; coûte des crédits) :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
set -a && . instance-de-test/.env && set +a && DRY_RUN=false ALLOWED_CONVERSATION_IDS=$CONVERSATION AIMSIGHT_DATA=$HOME/Support-Agent/data ANTHROPIC_API_KEY=… .venv/bin/python -m support_diagnostic.run
|
||||||
|
```
|
||||||
|
Expected : `diag:fait` ou `diag:ignore` ; la note dans l'interface (`http://127.0.0.1:9100`) ; Mailpit inchangé. Maxime juge la note.
|
||||||
|
|
||||||
|
- [ ] **Step 4 : commit** `git commit -m "Instance de test : préparation et test de bout en bout sans envoi"`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Task 6 : les workflows Gitea et le mode d'emploi
|
||||||
|
|
||||||
|
**Files :**
|
||||||
|
- Create : `.gitea/workflows/tests.yml`, `.gitea/workflows/diagnostic.yml`, `README.md`
|
||||||
|
|
||||||
|
**Interfaces :**
|
||||||
|
- Consumes : `python -m support_diagnostic.run` et ses variables (tâche 4).
|
||||||
|
|
||||||
|
- [ ] **Step 1 : `tests.yml`** : sur `push` ; Python 3.12 (`actions/setup-python`) ; `pip install -r requirements.txt` ; `python -m unittest discover -s tests -v`.
|
||||||
|
- [ ] **Step 2 : `diagnostic.yml`** : l'esquisse du §9.4 de la spec, **sans `schedule`** ; entrées `dry_run` (défaut `"true"`) et `conversation` (défaut `""`, passée en `CONVERSATION`) ; `concurrency: support-diagnostic` ; `AIMSIGHT_DATA` absent (hors de ce plan).
|
||||||
|
- [ ] **Step 3 : `README.md`** : ce que fait le dépôt, la règle « aucun mail ne part » et ses garde-fous, les variables et secrets Gitea, lancer les tests, l'instance de test (renvoi à `docs/verifications.md`).
|
||||||
|
- [ ] **Step 4 : vérifier sur Gitea** (le runner ne joint pas l'instance de test du poste : ce passage lit la production, en simulation, sans rien écrire ; Maxime : secrets `LIBREDESK_API_KEY`, `LIBREDESK_API_SECRET`, `ANTHROPIC_API_KEY`, variable `LIBREDESK_URL` vers la production, avec la clé d'un rôle « Agent IA ») : pousser ; `tests.yml` passe ; `diagnostic.yml` lancé à la main en simulation liste les conversations éligibles (aucune tant que personne n'a posé `tri:diagnostic`) et sort en code 0. Si `concurrency:` est refusé, le retirer et le noter dans `docs/verifications.md`.
|
||||||
|
- [ ] **Step 5 : commit et push** `git commit -m "Workflows Gitea : tests et diagnostic manuel en simulation" && git push`
|
||||||
Executable
+403
@@ -0,0 +1,403 @@
|
|||||||
|
# Spec — Automatisation du support : LibreDesk + agents sur Gitea
|
||||||
|
|
||||||
|
> **Pour Claude Code.** Ce document est le résultat d'un brainstorming entre Maxime et Claude (sans accès au code du projet). Il fixe l'**intention**, les **contraintes**, l'**architecture cible** et **toutes les options envisagées**. Les détails d'implémentation (structure exacte, noms de modules, réutilisation du code existant) sont à décider par toi à partir du projet réel.
|
||||||
|
>
|
||||||
|
> **Méthode attendue :** commencer par la phase 0 (vérifications sur les instances réelles), puis rédiger un plan d'implémentation détaillé (ex. skill superpowers `writing-plans` si disponible), puis implémenter phase par phase. Plusieurs informations ci-dessous sont **non vérifiées** et marquées ⚠️ : ne pas les tenir pour acquises, les tester.
|
||||||
|
>
|
||||||
|
> **Philosophie de cette phase :** ne fermer aucune porte. On construit, Maxime teste, on garde ce qui marche. Les options alternatives sont listées pour être essayées, pas écartées.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Règle absolue : aucun e-mail ne part au client
|
||||||
|
|
||||||
|
Ce sont **de vrais e-mails de vrais clients**. Pendant toute la phase de développement et de test :
|
||||||
|
|
||||||
|
- **Aucun message ne doit jamais être envoyé à un client** par le système, ni directement, ni indirectement (assistant IA LibreDesk, macro, règle d'automatisation, appel API mal paramétré).
|
||||||
|
- Le système produit uniquement des **notes privées** (et éventuellement des **brouillons**, cf. §8). **Un humain relit, modifie et envoie lui-même.**
|
||||||
|
- Plus tard, une fois le système validé et peaufiné par Maxime, on pourra envisager plus d'automatisation. **Pas avant, et pas sans décision explicite de Maxime.**
|
||||||
|
|
||||||
|
Cette règle prime sur toutes les autres. Les garde-fous concrets sont au §7 : ils doivent être implémentés **avant** tout premier appel en écriture vers le LibreDesk de production.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Objectif
|
||||||
|
|
||||||
|
Traiter automatiquement les demandes de support arrivant par e-mail dans LibreDesk :
|
||||||
|
|
||||||
|
1. **Pré-tri** : comprendre de quoi parle la demande et l'étiqueter.
|
||||||
|
2. **Traitement spécialisé** : selon l'étiquette, un dépôt Gitea dédié fait l'analyse poussée (diagnostic technique, etc.) avec les agents existants.
|
||||||
|
3. **Restitution** : le résultat (diagnostic + proposition de réponse) revient dans la conversation LibreDesk sous forme de note privée.
|
||||||
|
4. **Validation humaine** : un membre du support relit, corrige, envoie.
|
||||||
|
|
||||||
|
Contraintes d'entreprise :
|
||||||
|
|
||||||
|
- **Tout doit s'aligner sur l'infrastructure de l'entreprise : Gitea + LibreDesk.** L'entreprise tient à ce que tout soit conforme à Gitea. Pas de service maison à héberger à côté si on peut l'éviter.
|
||||||
|
- **Rien ne dépend de l'ordinateur de Maxime.** Tout tourne sur le serveur de l'entreprise.
|
||||||
|
- **Personne ne doit avoir à intervenir sur le dépôt** pour que ça tourne : exécution autonome.
|
||||||
|
- **Pas de contrainte de latence** : ce sont des e-mails, traités en plusieurs jours. Un délai de 15–30 min est parfaitement acceptable.
|
||||||
|
|
||||||
|
Hors périmètre :
|
||||||
|
|
||||||
|
- L'application React + FastAPI existante de Maxime **n'est pas concernée**. On ne la déploie pas.
|
||||||
|
- Ce qu'on reprend : le **dossier API** du projet `support agent` (clients API, documentation, tout ce qui fait fonctionner les agents analyste et support) et la **logique des agents** (déjà capables de comprendre et traiter une demande).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Situation de départ (faits établis)
|
||||||
|
|
||||||
|
- Les demandes clients arrivent **par e-mail** dans **LibreDesk**, auto-hébergé dans l'entreprise.
|
||||||
|
- **Gitea** est une brique d'infrastructure importante de l'entreprise (Gitea, pas GitHub).
|
||||||
|
- Le projet `support agent` de Maxime contient un **dossier API** encapsulant les appels aux API et la documentation nécessaires aux agents, et des **agents** (analyste, support) fonctionnels.
|
||||||
|
- Les agents sont du **code Python qui appelle l'API Anthropic** avec une **clé API** (pas Claude Code, pas d'abonnement).
|
||||||
|
- La clé sera stockée dans les **secrets Gitea**. Pour la production, prévoir une clé au nom de l'entreprise plutôt qu'une clé personnelle.
|
||||||
|
- **Données** : envoyer le contenu des e-mails clients à l'API Anthropic est acceptable à ce stade.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Ce qu'on sait de LibreDesk
|
||||||
|
|
||||||
|
Sources en fin de document. ✅ = confirmé par une source ; ⚠️ = à vérifier sur l'instance.
|
||||||
|
|
||||||
|
### 4.1 Intégration
|
||||||
|
|
||||||
|
- ✅ **API HTTP/JSON**, authentification par **clé API + secret générés par agent** (Admin → Teammates → Agents → générer une clé). Certains points d'accès ne sont pas documentés.
|
||||||
|
- ✅ **Messages d'une conversation** :
|
||||||
|
- `GET /api/v1/conversations/{uuid}/messages` : lire les messages.
|
||||||
|
- `POST /api/v1/conversations/{cuuid}/messages` : **envoyer un message**. Champs : `message`, `attachments`, **`private`** (note interne), `to`, `cc`, `bcc`, `sender_type`.
|
||||||
|
- ⚠️ **DANGER** : c'est **le même point d'accès** pour une réponse au client et pour une note privée. Seul le booléen `private` fait la différence. Source = schéma d'un wrapper MCP communautaire (`metanmai/libredesk-mcp`), pas la doc officielle. **À vérifier sur une instance de test avant tout usage en production** (cf. §7).
|
||||||
|
- ✅ **Suppression de notes privées par API** (depuis v2.5.0) : utile pour nettoyer pendant les tests. Restreinte à l'auteur de la note ou à un admin (v2.8.0).
|
||||||
|
- ✅ **Webhooks** : `message.created` se déclenche à chaque nouveau message (entrant, sortant, note privée, activité). Il faut donc filtrer pour ne pas retraiter ses propres notes.
|
||||||
|
- ✅ **Règles d'automatisation** : étiquetage, assignation, routage selon des conditions personnalisées. Pas d'IA.
|
||||||
|
- ✅ **Macros** : réponses enregistrées, pose d'étiquettes en un clic.
|
||||||
|
- ✅ **Étiquettes, statuts personnalisés, attributs personnalisés** sur les conversations.
|
||||||
|
- ⚠️ Points d'accès API **étiquettes** (ajout/retrait sur une conversation) et **filtrage des conversations par étiquette** : à trouver (doc officielle, spécification OpenAPI, code source Go du dépôt `abhinavxd/libredesk`).
|
||||||
|
- ⚠️ **Brouillons** : depuis v2.5.0, les brouillons sont stockés **par type** (réponse / note privée). Existe-t-il un point d'accès API pour créer un **brouillon de réponse** visible par l'agent humain dans l'éditeur ? Si oui, c'est une sortie très intéressante (cf. §8).
|
||||||
|
|
||||||
|
### 4.2 Fonctions IA de LibreDesk (v2.6.0+, bêta)
|
||||||
|
|
||||||
|
| Fonction | Ce qu'on sait | Intérêt pour nous |
|
||||||
|
|---|---|---|
|
||||||
|
| **Assistant IA** | Une règle d'automatisation route une conversation vers un assistant. Il répond à partir de la base de connaissances et passe la main à un humain s'il ne peut pas aider. Le README le décrit pour le **chat en direct**. Option de passage à l'humain configurable par assistant. | ⚠️ **Il répond au client.** Contraire au §1 tant qu'on n'a pas prouvé qu'on peut l'empêcher de répondre. Ne **jamais** le router vers la boîte e-mail de production pendant les tests. Explorable sur une instance de test uniquement. |
|
||||||
|
| **Outils IA personnalisés** | Branchent l'assistant sur nos propres API (GET et POST uniquement, plusieurs en-têtes d'authentification). Conditionnés à une vérification OTP par e-mail du contact. | Permettrait en théorie à l'assistant d'appeler un service de diagnostic. Mais : lié à l'assistant (qui répond au client) et nécessite d'exposer une API. À explorer, pas prioritaire. |
|
||||||
|
| **Copilote (Juno)** | Onglet latéral : répond aux questions sur la conversation et la base de connaissances. Outils d'historique client, choix de persona, **suggestions d'étiquettes**. | **Suggestions d'étiquettes** = tri assisté par IA, validé par un humain. ⚠️ Rien n'indique qu'elles sont **appliquées automatiquement** : à vérifier. |
|
||||||
|
| **Suggestions d'étiquettes** | Tirées de la liste d'étiquettes existante. Présélection par embeddings, puis le LLM choisit. | Cœur de l'option de tri T2 (§6). ⚠️ Existe-t-il un point d'accès API interne qu'on pourrait appeler depuis un cron pour automatiser le tri (option T3b) ? |
|
||||||
|
| **Générer une réponse** | Rédige un brouillon dans l'éditeur, que l'agent humain modifie avant d'envoyer. | Compatible avec le §1. Peut compléter notre note privée. |
|
||||||
|
| **Résumé IA** | Ajoute un résumé de la conversation **en note privée**. | Montre que LibreDesk sait poster des notes privées IA en interne. |
|
||||||
|
| **Apprentissage sur conversations résolues** | Rédige des extraits pour la base de connaissances, qu'un agent approuve ou rejette. | Piste pour la boucle de retour d'expérience (§12). |
|
||||||
|
| **Fournisseur de modèle** | N'importe quel service **compatible OpenAI**, y compris un modèle local. Suivi de la consommation de jetons. | ⚠️ Tester si l'API Anthropic via son point d'accès compatible OpenAI fonctionne, pour réutiliser la même clé. |
|
||||||
|
|
||||||
|
Non mentionné dans les notes de version : l'IA de LibreDesk qui **applique** des étiquettes, assigne des équipes ou crée des notes privées en dehors du résumé. **Ça ne veut pas dire que c'est impossible** : vérifier dans l'interface et le code de la version installée. Il peut y avoir des subtilités qui nous échappent.
|
||||||
|
|
||||||
|
### 4.3 Version
|
||||||
|
|
||||||
|
- ⚠️ **Vérifier la version de LibreDesk installée.** Fonctions IA : ≥ 2.6.0. Suppression de notes par API : ≥ 2.5.0. Dernière version connue au moment du brainstorming : 2.8.0 (août 2026). Une mise à jour peut être nécessaire.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Ce qu'on sait de Gitea Actions
|
||||||
|
|
||||||
|
- ✅ Compatible avec la syntaxe GitHub Actions. Déclencheurs : `push`, `pull_request`, **`schedule` (cron)**, **`workflow_dispatch`** (manuel).
|
||||||
|
- ✅ **Déclenchement par API** de `workflow_dispatch` : point d'accès de dispatch de workflow, exposé dans le SDK Go (`DispatchRepoActionWorkflow`) et le CLI `tea` (`tea actions workflows dispatch`). ⚠️ C'est **récent** : vérifier que la version de l'instance l'expose. Rappel : `workflow_dispatch` ne fonctionne que pour un workflow présent **sur la branche par défaut**.
|
||||||
|
- ✅ Exécution dans un **runner** (`act_runner`) installé sur le serveur.
|
||||||
|
- ✅ **Secrets de dépôt** (ou d'organisation) pour les clés.
|
||||||
|
- ✅ **Un webhook LibreDesk ne peut pas déclencher directement une Action** : formats de données et authentification incompatibles. Il faut un cron ou un relais.
|
||||||
|
- ⚠️ Support de `concurrency:` (empêcher deux exécutions simultanées) : dépend de la version de Gitea. À vérifier. Sinon, verrou applicatif (§9.3).
|
||||||
|
- ⚠️ `actions/upload-artifact` : version supportée selon l'instance. À vérifier si on veut publier les sorties du mode simulation en artefact.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Architecture cible
|
||||||
|
|
||||||
|
### 6.1 Principe : l'étiquette LibreDesk est l'interface
|
||||||
|
|
||||||
|
Les briques ne se parlent **jamais directement**. Elles communiquent par **étiquettes sur les conversations LibreDesk**.
|
||||||
|
|
||||||
|
- Une brique de **tri** pose une étiquette `tri-*`.
|
||||||
|
- Chaque **dépôt de traitement** lit les conversations qui portent « son » étiquette `tri-*`, fait son travail, poste une note privée et pose une étiquette d'**état**.
|
||||||
|
|
||||||
|
Conséquences :
|
||||||
|
|
||||||
|
- **Qui pose l'étiquette de tri est interchangeable** : règle LibreDesk, copilote + humain, assistant IA LibreDesk, dépôt de tri dédié, humain à la main. Les dépôts de traitement ne voient pas la différence. C'est ce qui permet de tester toutes les options de tri (§6.3) sans rien changer en aval.
|
||||||
|
- **L'état vit dans LibreDesk** : pas de base de données, pas d'état persistant côté runner.
|
||||||
|
- **Un dépôt = une responsabilité.** On ajoute un nouveau type de traitement en créant un dépôt qui écoute une nouvelle étiquette `tri-*`.
|
||||||
|
|
||||||
|
```
|
||||||
|
E-mail client
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
LibreDesk ──────────────────────────────────────────────────────────┐
|
||||||
|
│ │
|
||||||
|
│ TRI (une ou plusieurs options, cf. §6.3) │
|
||||||
|
│ → pose tri-diagnostic | tri-<autre> | tri-humain | tri-ignore│
|
||||||
|
│ │
|
||||||
|
│ [dépôt support-diagnostic] cron Gitea, toutes les 15–30 min │
|
||||||
|
│ lit : tri-diagnostic ET aucune étiquette diag-* │
|
||||||
|
│ → agents existants (dossier API + agents analyste/support) │
|
||||||
|
│ → note privée « Brouillon IA » dans la conversation ──────────┤
|
||||||
|
│ → pose diag-fait | diag-erreur | diag-ignore │
|
||||||
|
│ │
|
||||||
|
│ [futurs dépôts] même modèle, autre étiquette tri-* │
|
||||||
|
│ │
|
||||||
|
▼ │
|
||||||
|
Humain du support : lit la note, corrige, ENVOIE LUI-MÊME ◄─────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.2 Contrat d'étiquettes (proposition, à ajuster)
|
||||||
|
|
||||||
|
⚠️ Vérifier les caractères autorisés dans les noms d'étiquettes (il existe une validation). Utiliser `:` si autorisé (`tri:diagnostic`), sinon `-`.
|
||||||
|
|
||||||
|
| Étiquette | Posée par | Signification |
|
||||||
|
|---|---|---|
|
||||||
|
| `tri-diagnostic` | brique de tri | La demande relève du diagnostic technique. |
|
||||||
|
| `tri-<domaine>` | brique de tri | Autres domaines futurs (facturation, compte…). |
|
||||||
|
| `tri-humain` | brique de tri | Doute ou cas sensible : un humain décide. |
|
||||||
|
| `tri-ignore` | brique de tri | Spam, accusé de réception, hors sujet. |
|
||||||
|
| `diag-en-cours` | dépôt diagnostic | Verrou pendant le traitement (§9.3). |
|
||||||
|
| `diag-fait` | dépôt diagnostic | Note privée postée. |
|
||||||
|
| `diag-erreur` | dépôt diagnostic | Échec. Une note d'alerte courte est postée si possible. |
|
||||||
|
| `diag-ignore` | dépôt diagnostic | Les agents ont jugé qu'aucun diagnostic n'est pertinent (la note explique pourquoi). |
|
||||||
|
| `diag-relancer` | humain | Demande un nouveau diagnostic (par exemple après une réponse du client). |
|
||||||
|
|
||||||
|
Règle de sélection du dépôt diagnostic : `tri-diagnostic` présent ET (aucune étiquette `diag-*` OU `diag-relancer` présent).
|
||||||
|
|
||||||
|
**Relance du client dans un ticket déjà traité** : par défaut, **pas de relance automatique**. L'humain pose `diag-relancer`. À rediscuter après les tests.
|
||||||
|
|
||||||
|
### 6.3 Options de tri — toutes à tester
|
||||||
|
|
||||||
|
Maxime **préfère que le tri se fasse dans LibreDesk** avec ses outils d'IA. D'après ce qu'on sait, le tri IA **entièrement automatique** des e-mails n'est pas une fonction documentée de LibreDesk. On garde donc toutes les options ouvertes, à essayer dans cet ordre de préférence :
|
||||||
|
|
||||||
|
| # | Option | Automatique ? | Où vit la logique | Statut |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| **T1** | **Règles d'automatisation LibreDesk** (boîte de réception, mots-clés du sujet, domaine de l'expéditeur…) → pose `tri-*` | Oui | LibreDesk | ✅ Disponible. Tri grossier, sans IA. Bon socle. |
|
||||||
|
| **T2** | **Copilote LibreDesk : suggestions d'étiquettes** → un humain valide d'un clic | Semi | LibreDesk | ✅ Existe (≥ 2.6). Vérifier l'ergonomie et si une application automatique est possible. Combine IA et garde-fou humain. |
|
||||||
|
| **T3a** | **Assistant IA LibreDesk** configuré pour **uniquement classer** (instructions + éventuel outil personnalisé qui pose l'étiquette), sans jamais répondre | Oui | LibreDesk | ⚠️ Expérimental et **risqué** (§1). Uniquement sur une instance ou une boîte **de test sans SMTP sortant**. Vérifier : canal e-mail supporté ? Peut-on l'empêcher de répondre ? |
|
||||||
|
| **T3b** | Un cron Gitea qui appelle **l'API interne de suggestion d'étiquettes** de LibreDesk et applique la suggestion | Oui | LibreDesk (IA) + Gitea (application) | ⚠️ Seulement si ce point d'accès est accessible par clé API. À chercher dans le code source. |
|
||||||
|
| **T4** | **Dépôt `support-triage`** : cron Gitea, agent de tri Python + Anthropic avec garde-fous, pose `tri-*` | Oui | Gitea | Plan B robuste, entièrement maîtrisé et versionné. |
|
||||||
|
| **T5** | **Humain** pose l'étiquette à la main (ou via une macro) | Non | — | Toujours possible. Utile pour démarrer et pour cibler. |
|
||||||
|
|
||||||
|
Ces options **se combinent** : par exemple T1 pour le gros du flux, T2/T5 pour le reste, T4 si on veut plus d'intelligence. Toute brique de tri IA doit avoir des garde-fous : liste fermée d'étiquettes, `tri-humain` en cas de doute, aucune capacité d'écriture autre que l'étiquette.
|
||||||
|
|
||||||
|
**Désactiver** (ou ne jamais router vers la boîte e-mail réelle) l'assistant IA LibreDesk tant que T3a n'est pas validé, pour éviter qu'il réponde aux clients.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Garde-fous « zéro envoi au client » (obligatoires, implémentés en premier)
|
||||||
|
|
||||||
|
Défense en profondeur. Chaque couche doit suffire seule à empêcher un envoi.
|
||||||
|
|
||||||
|
1. **Instance LibreDesk de test d'abord.** Monter un LibreDesk local (`docker compose` officiel) **sans SMTP sortant configuré**, avec des conversations factices. Tous les développements et toutes les vérifications du §10 se font d'abord là.
|
||||||
|
2. **Client LibreDesk restreint, refus par défaut.** Le module qui parle à LibreDesk n'expose qu'une liste fermée d'opérations : lister/lire des conversations, lire des messages, ajouter/retirer des étiquettes, **poster une note privée**, supprimer sa propre note privée. Aucune méthode générique « envoyer un message » ou « requête arbitraire ».
|
||||||
|
3. **`post_private_note` verrouillée** :
|
||||||
|
- force `private: true` en dur, non paramétrable ;
|
||||||
|
- ne transmet **jamais** `to`, `cc`, `bcc` ;
|
||||||
|
- vérifie la réponse de l'API (si elle renvoie le message créé, contrôler qu'il est bien privé). Sinon : exception, **arrêt immédiat de l'exécution entière** et étiquette `diag-erreur`. Ne pas continuer sur les autres tickets.
|
||||||
|
4. **Les agents LLM n'ont aucun accès en écriture à LibreDesk.** Ils reçoivent du texte et renvoient du texte. Seul l'orchestrateur, déterministe, écrit (note + étiquettes). C'est aussi la protection contre l'**injection de prompt** : le contenu des e-mails clients est une entrée non fiable.
|
||||||
|
5. **Mode simulation par défaut** (`DRY_RUN=true`) : aucune écriture vers LibreDesk. Les notes prévues sont écrites dans les journaux du job (et en artefact si disponible). Passer en écriture réelle exige un changement explicite de configuration.
|
||||||
|
6. **Liste blanche de conversations** (`ALLOWED_CONVERSATION_IDS`) pour la première phase en production : le système n'écrit que sur des conversations explicitement autorisées.
|
||||||
|
7. **Plafond par exécution** (`MAX_CONVERSATIONS_PER_RUN`, par exemple 3 à 5) : limite le coût et les dégâts possibles.
|
||||||
|
8. **Interrupteur d'arrêt** : une variable ou un secret Gitea (`KILL_SWITCH`) vérifié au démarrage. Désactiver le workflow dans Gitea fonctionne aussi.
|
||||||
|
9. **Compte technique LibreDesk dédié** (par exemple « Agent IA ») avec les permissions minimales. ⚠️ Vérifier si les rôles LibreDesk permettent d'autoriser les notes privées **sans** autoriser les réponses. Si oui, c'est la meilleure barrière.
|
||||||
|
10. **Tests automatisés** : un test vérifie que tout appel `POST …/messages` passe par `post_private_note` avec `private: true`. Un test (ou une règle de lint/grep en CI) interdit tout autre usage de ce point d'accès.
|
||||||
|
11. **Marquage visible de la note** : en-tête du type « 🤖 BROUILLON IA — à relire, ne pas envoyer tel quel », pour qu'un humain ne la confonde jamais avec une réponse validée.
|
||||||
|
12. **Pas de mention `@agent`** dans les notes au début : éviter les notifications parasites.
|
||||||
|
13. **Vérifier les règles d'automatisation et les macros existantes** dans LibreDesk : aucune ne doit envoyer automatiquement une réponse quand une étiquette `tri-*` ou `diag-*` est posée.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Sorties vers l'humain — options
|
||||||
|
|
||||||
|
| Option | Description | Statut |
|
||||||
|
|---|---|---|
|
||||||
|
| **S1 — Note privée** (principale) | Diagnostic + proposition de réponse dans une note privée. | ✅ Supporté (`private: true`), à valider sur l'instance de test. |
|
||||||
|
| **S2 — Brouillon de réponse** | Préremplir l'éditeur de réponse de l'agent humain, qui n'a plus qu'à relire et envoyer. | ⚠️ À explorer : existe-t-il une API de brouillon ? Gros gain d'ergonomie si oui. Un brouillon ne doit jamais s'envoyer seul : à vérifier. |
|
||||||
|
| **S3 — « Générer une réponse » natif** | L'humain clique sur « Générer une réponse » dans LibreDesk, qui peut s'appuyer sur notre note privée présente dans la conversation. | ✅ Existe (≥ 2.6). À tester en combinaison avec S1. |
|
||||||
|
| **S4 — Attributs personnalisés** | Stocker des champs structurés (catégorie, gravité, confiance) dans des attributs de conversation. | ⚠️ Vérifier l'API. Utile pour filtrer et faire des statistiques. |
|
||||||
|
|
||||||
|
Format de la note : **à valider avec l'équipe support.** Proposition de départ :
|
||||||
|
- en-tête « Brouillon IA » ;
|
||||||
|
- résumé de la demande en 1–2 lignes ;
|
||||||
|
- diagnostic (constats, vérifications faites, sources/données consultées) ;
|
||||||
|
- niveau de confiance et points incertains ;
|
||||||
|
- **proposition de réponse au client**, prête à copier ;
|
||||||
|
- pied de page technique : identifiant d'exécution Gitea, version du dépôt (commit), modèle utilisé.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Dépôt `support-diagnostic` (phase 1)
|
||||||
|
|
||||||
|
### 9.1 Contenu
|
||||||
|
|
||||||
|
- Le **dossier API** et la **logique des agents** repris du projet `support agent` (à toi de juger : copie, sous-module, ou paquet Python partagé).
|
||||||
|
- Un **point d'entrée** non interactif (par exemple `python -m support_diagnostic.run`).
|
||||||
|
- Le **client LibreDesk restreint** (§7).
|
||||||
|
- Le **workflow Gitea** (`.gitea/workflows/diagnostic.yml`).
|
||||||
|
- Tests (§7.10 + tests unitaires du cycle).
|
||||||
|
|
||||||
|
### 9.2 Cycle d'une exécution
|
||||||
|
|
||||||
|
1. Vérifier l'interrupteur d'arrêt et la configuration (mode simulation, liste blanche, plafond).
|
||||||
|
2. Lister les conversations éligibles (§6.2). ⚠️ Si l'API ne filtre pas par étiquette : lister les conversations ouvertes récentes et filtrer côté client.
|
||||||
|
3. Pour chaque conversation, jusqu'au plafond :
|
||||||
|
1. poser `diag-en-cours` ;
|
||||||
|
2. lire les messages (ignorer les notes privées et nos propres notes ; ne garder que les messages client et les réponses humaines utiles comme contexte) ;
|
||||||
|
3. exécuter les agents (pré-analyse → diagnostic → rédaction de la proposition de réponse) ;
|
||||||
|
4. poster la note privée (ou l'écrire dans les journaux en mode simulation) ;
|
||||||
|
5. retirer `diag-en-cours` et `diag-relancer`, poser `diag-fait` ou `diag-ignore`.
|
||||||
|
4. En cas d'erreur sur une conversation : note d'alerte courte si possible, `diag-erreur`, retrait de `diag-en-cours`, passage à la suivante. **Exception : une anomalie du garde-fou d'envoi (§7.3) arrête tout.**
|
||||||
|
5. Résumé de l'exécution dans les journaux : conversations traitées, statuts, jetons consommés, durée.
|
||||||
|
|
||||||
|
### 9.3 Doublons, concurrence, boucles
|
||||||
|
|
||||||
|
- **Doublons** : l'état est porté par les étiquettes `diag-*`. Une conversation déjà traitée n'est pas reprise.
|
||||||
|
- **Concurrence** : `concurrency:` dans le workflow si Gitea le supporte. Sinon, le verrou `diag-en-cours` plus un intervalle de cron largement supérieur à la durée d'une exécution.
|
||||||
|
- **Verrous orphelins** (exécution plantée) : considérer `diag-en-cours` comme périmé après N heures (par exemple via la date de l'étiquette ou d'une note de démarrage) et le libérer.
|
||||||
|
- **Boucles** : en cron, on ne réagit pas aux événements, donc le risque de retraiter ses propres notes est nul tant qu'on filtre sur les étiquettes. En mode webhook (§11), filtrer explicitement notes privées, messages sortants et messages de l'agent technique.
|
||||||
|
|
||||||
|
### 9.4 Workflow Gitea (esquisse)
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
name: support-diagnostic
|
||||||
|
on:
|
||||||
|
schedule:
|
||||||
|
- cron: "*/20 * * * *" # toutes les 20 min, à ajuster
|
||||||
|
workflow_dispatch: # lancement manuel pour les tests
|
||||||
|
inputs:
|
||||||
|
dry_run:
|
||||||
|
description: "Mode simulation (aucune écriture LibreDesk)"
|
||||||
|
default: "true"
|
||||||
|
# concurrency: support-diagnostic # si supporté par l'instance
|
||||||
|
jobs:
|
||||||
|
run:
|
||||||
|
runs-on: <label du runner>
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- run: pip install -r requirements.txt # envisager une image Docker préconstruite pour éviter la réinstallation à chaque exécution
|
||||||
|
- run: python -m support_diagnostic.run
|
||||||
|
env:
|
||||||
|
LIBREDESK_URL: ${{ vars.LIBREDESK_URL }}
|
||||||
|
LIBREDESK_API_KEY: ${{ secrets.LIBREDESK_API_KEY }}
|
||||||
|
LIBREDESK_API_SECRET: ${{ secrets.LIBREDESK_API_SECRET }}
|
||||||
|
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
|
||||||
|
DRY_RUN: ${{ inputs.dry_run || vars.DRY_RUN || 'true' }}
|
||||||
|
ALLOWED_CONVERSATION_IDS: ${{ vars.ALLOWED_CONVERSATION_IDS }}
|
||||||
|
MAX_CONVERSATIONS_PER_RUN: ${{ vars.MAX_CONVERSATIONS_PER_RUN || '3' }}
|
||||||
|
KILL_SWITCH: ${{ vars.KILL_SWITCH }}
|
||||||
|
```
|
||||||
|
|
||||||
|
Points d'attention :
|
||||||
|
- Le runner doit joindre **l'API LibreDesk** (réseau interne), **l'API Anthropic** (sortie internet) et **les API utilisées par le dossier API** des agents.
|
||||||
|
- Pas de GPU nécessaire a priori (les modèles sont appelés par API). À confirmer selon les détecteurs.
|
||||||
|
- **Traçabilité** : chaque exécution Gitea est un journal horodaté. Mettre l'identifiant d'exécution dans la note pour remonter du ticket au journal.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. Phase 0 — vérifications avant de développer
|
||||||
|
|
||||||
|
Faire ces vérifications **sur les instances réelles**, en lecture seule ou sur l'instance de test, et consigner les résultats dans un fichier `docs/verifications.md` du dépôt.
|
||||||
|
|
||||||
|
**Gitea**
|
||||||
|
- [ ] Version de Gitea. Actions activées ? Runner installé, enregistré, label disponible ?
|
||||||
|
- [ ] Le runner joint-il l'API LibreDesk, l'API Anthropic et les API du dossier API ?
|
||||||
|
- [ ] `workflow_dispatch` via API disponible ? `concurrency:` supporté ? Quelle version d'`upload-artifact` ?
|
||||||
|
- [ ] Secrets et variables de dépôt/organisation utilisables.
|
||||||
|
|
||||||
|
**LibreDesk**
|
||||||
|
- [ ] Version installée (≥ 2.6 pour l'IA ; dernière connue : 2.8.0).
|
||||||
|
- [ ] Monter l'**instance de test** sans SMTP sortant.
|
||||||
|
- [ ] Spécification OpenAPI / doc API : points d'accès conversations (liste, filtres), messages, **étiquettes**, attributs personnalisés, **brouillons**.
|
||||||
|
- [ ] Sur l'instance de test : `POST …/messages` avec `private: true` crée bien une **note privée** et n'envoie rien. Tester aussi un appel **sans** `private` pour comprendre le comportement par défaut (sur l'instance de test uniquement !).
|
||||||
|
- [ ] Permissions des rôles : peut-on autoriser les notes privées sans autoriser les réponses ?
|
||||||
|
- [ ] Caractères autorisés dans les noms d'étiquettes.
|
||||||
|
- [ ] Fonctions IA : suggestions d'étiquettes (manuelles ou automatiques ? point d'accès API ?), assistant IA sur le canal e-mail (supporté ? peut-on l'empêcher de répondre ?), outils personnalisés, « Générer une réponse ».
|
||||||
|
- [ ] Fournisseur IA : l'API Anthropic via son point d'accès compatible OpenAI fonctionne-t-elle ?
|
||||||
|
- [ ] Inventaire des règles d'automatisation et des macros existantes : aucune ne doit envoyer de réponse automatiquement (§7.13).
|
||||||
|
|
||||||
|
**Projet existant**
|
||||||
|
- [ ] Identifier dans `support agent` ce qui est réutilisable sans interface : dossier API, agents, détecteurs, prompts.
|
||||||
|
- [ ] Les agents peuvent-ils être appelés de façon non interactive avec en entrée le contenu d'une conversation et en sortie un diagnostic plus une proposition de réponse ?
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. Modes de déclenchement — toutes les options
|
||||||
|
|
||||||
|
| Mode | Description | Statut |
|
||||||
|
|---|---|---|
|
||||||
|
| **D1 — Cron Gitea** | Workflow planifié qui interroge l'API LibreDesk. | ✅ **Choisi pour la phase 1.** 100 % Gitea, pas de service à héberger, latence sans importance. |
|
||||||
|
| **D2 — Manuel** | `workflow_dispatch` depuis l'interface Gitea, éventuellement avec un identifiant de conversation en entrée. | ✅ Utile pour les tests et pour forcer un traitement. |
|
||||||
|
| **D3 — Webhook + relais** | LibreDesk `message.created` → petit service toujours allumé → déclenche `workflow_dispatch` via l'API Gitea (ou traite directement). | Plus réactif, mais ajoute un service hors Gitea. Inutile vu l'absence d'urgence. Garder pour plus tard. |
|
||||||
|
| **D4 — LibreDesk appelle notre API** | Un outil IA personnalisé de l'assistant LibreDesk appelle une API de diagnostic exposée par nous. | Nécessite d'héberger une API et passe par l'assistant qui répond au client (§1). Exploratoire. |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 12. Alternatives discutées
|
||||||
|
|
||||||
|
- **Déployer l'application FastAPI existante comme service permanent** (conteneur sur le serveur, déployé par Gitea Actions, recevant directement les webhooks) : solution classique, réactive. **Écartée** car Maxime veut rester aligné sur Gitea + LibreDesk sans service maison, et l'application existante n'est pas concernée. À reconsidérer si le cron montre ses limites.
|
||||||
|
- **Limites connues de l'approche cron Gitea**, acceptées :
|
||||||
|
- chaque exécution repart de zéro (checkout, installation des dépendances) → image Docker préconstruite si c'est trop lent ;
|
||||||
|
- pas d'état persistant → l'état est dans les étiquettes LibreDesk ;
|
||||||
|
- risque d'exécutions simultanées → `concurrency:` ou verrou ;
|
||||||
|
- journaux répartis par exécution → identifiant d'exécution dans la note.
|
||||||
|
- **Utiliser l'assistant IA intégré de LibreDesk pour le pré-tri et la finalisation** (schéma initial) : il répond lui-même au client et semble limité au chat en direct. Il ne peut donc pas jouer ce rôle tel quel. On le garde comme option expérimentale de tri (T3a).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 13. Plan par phases
|
||||||
|
|
||||||
|
Chaque phase a un critère de sortie validé par Maxime avant de passer à la suivante.
|
||||||
|
|
||||||
|
**Phase 0 — Vérifications** (§10)
|
||||||
|
Sortie : `docs/verifications.md` rempli. Choix du contrat d'étiquettes final.
|
||||||
|
|
||||||
|
**Phase 1 — Squelette sécurisé, instance de test**
|
||||||
|
- Dépôt `support-diagnostic` : client LibreDesk restreint et garde-fous du §7, avec tests.
|
||||||
|
- Point d'entrée et cycle complet du §9.2, branché sur les agents existants.
|
||||||
|
- Workflow Gitea en mode simulation, déclenchement manuel.
|
||||||
|
- Sortie : sur l'instance de test, une conversation `tri-diagnostic` reçoit une note privée correcte, les étiquettes sont posées, et **aucun message sortant n'apparaît**.
|
||||||
|
|
||||||
|
**Phase 2 — Production en simulation**
|
||||||
|
- Workflow branché sur le LibreDesk de production, `DRY_RUN=true`, cron actif.
|
||||||
|
- Tri : T1 et/ou T5 pour poser `tri-diagnostic`.
|
||||||
|
- Sortie : Maxime relit les notes prévues dans les journaux sur des tickets réels et juge la qualité.
|
||||||
|
|
||||||
|
**Phase 3 — Production en écriture, liste blanche**
|
||||||
|
- `DRY_RUN=false` avec `ALLOWED_CONVERSATION_IDS` et un plafond bas.
|
||||||
|
- Validation du format de la note avec l'équipe support.
|
||||||
|
- Sortie : notes utiles, zéro incident d'envoi.
|
||||||
|
|
||||||
|
**Phase 4 — Production élargie**
|
||||||
|
- Retrait de la liste blanche, plafond relevé, cron régulier.
|
||||||
|
- Essai des options de tri T2, T3b, T3a (test uniquement), T4. On garde celle(s) qui marchent.
|
||||||
|
- Essai des sorties S2, S3, S4.
|
||||||
|
|
||||||
|
**Phase 5 — Plus tard, sur décision explicite de Maxime**
|
||||||
|
- Nouveaux dépôts spécialisés (`tri-<domaine>`).
|
||||||
|
- Webhook (D3) si la réactivité devient utile.
|
||||||
|
- Boucle de retour d'expérience : comparer la note IA à la réponse réellement envoyée par l'humain, alimenter les agents ou la base de connaissances (cf. l'apprentissage sur conversations résolues de LibreDesk).
|
||||||
|
- Éventuellement plus d'automatisation, **jamais d'envoi automatique sans validation explicite**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 14. Questions ouvertes
|
||||||
|
|
||||||
|
- Quels **types de demandes** sont visés en premier par `tri-diagnostic` ? Quels autres domaines à terme ?
|
||||||
|
- **Format exact de la note** : à valider avec l'équipe support.
|
||||||
|
- **Journalisation** : les journaux Gitea suffisent-ils, ou faut-il un historique consultable (fichier, attribut LibreDesk, tableau de bord) ?
|
||||||
|
- **Gestion des erreurs** : note d'alerte et `diag-erreur` suffisent-elles, ou faut-il une notification (e-mail interne, autre canal) ?
|
||||||
|
- **Coût** : budget de jetons acceptable par ticket et par mois ? Quel modèle Anthropic pour chaque agent (tri, diagnostic, rédaction) ?
|
||||||
|
- **Clé API** : passage à une clé au nom de l'entreprise, et à quel moment ?
|
||||||
|
- **Relances client** : faut-il un jour relancer automatiquement le diagnostic quand le client répond ?
|
||||||
|
- **Pièces jointes** (captures, journaux envoyés par le client) : les agents doivent-ils les lire ?
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
|
||||||
|
- LibreDesk, notes de version v2.6.0 (fonctions IA) : https://github.com/abhinavxd/libredesk/releases/tag/v2.6.0
|
||||||
|
- LibreDesk, notes de version v2.8.0 : https://github.com/abhinavxd/libredesk/releases/tag/v2.8.0
|
||||||
|
- LibreDesk, notes de version v2.5.0 (suppression de notes privées, brouillons par type) : https://newreleases.io/project/github/abhinavxd/libredesk/release/v2.5.0
|
||||||
|
- LibreDesk, README : https://raw.githubusercontent.com/abhinavxd/libredesk/main/README.md
|
||||||
|
- Schéma `send_message` (wrapper MCP communautaire, champ `private`) : https://glama.ai/mcp/servers/metanmai/libredesk-mcp/tools/send_message
|
||||||
|
- DeepWiki LibreDesk, messages et points d'accès : https://deepwiki.com/abhinavxd/libredesk/3.1-messages-and-replies
|
||||||
|
- Gitea `tea`, dispatch de workflow par API : https://gitea.com/gqx/tea/src/branch/main/docs/example-workflows.md
|
||||||
|
- Gitea, ajout de `workflow_dispatch` (PR #28163) : https://git.sim1222.com/sim1222-mirror/gitea/commits/commit/4f5c96627b4622d64593db2d436b1f3befa5f3c3
|
||||||
|
- Document de brainstorming initial de Maxime (« Automatisation du support : LibreDesk + agents sur Gitea »), intégré et corrigé ici.
|
||||||
@@ -0,0 +1,80 @@
|
|||||||
|
# Phase 0 : vérifications (LibreDesk + agents sur Gitea)
|
||||||
|
|
||||||
|
Phase 0 de la spec « Automatisation du support : LibreDesk + agents sur Gitea » (Maxime et Claude, 2026-11-09). Écrit dans `Support-Agent`, puis versé ici, dans `Support-AI`, le dépôt du diagnostic automatique.
|
||||||
|
|
||||||
|
Sources de chaque constat : **[code]** le code de LibreDesk (`main` du 2026-11-08, `a987842`) ; **[test]** l'instance de test locale à la version de la production, `instance-de-test/` ; **[prod]** un appel en lecture seule à l'instance réelle ; **[?]** non vérifié, à faire par Maxime ou un admin.
|
||||||
|
|
||||||
|
## Ce qui change dans la spec
|
||||||
|
|
||||||
|
1. **La meilleure barrière existe, côté serveur** [code, test]. Les notes privées (`messages:write_private`) et les réponses (`messages:write`) sont deux permissions distinctes. Un rôle « Agent IA » sans `messages:write` reçoit **403** sur toute réponse au client, avec ou sans `private`, quoi que fasse notre code. Le garde-fou §7.9 devient le premier, les autres restent en profondeur.
|
||||||
|
2. **Sans `private: true`, le mail part** [test]. Même point d'accès ; `private` absent vaut `false` et met la réponse en file d'envoi : sur l'instance de test, l'admin a envoyé un vrai mail (capté par le piège SMTP). Le danger du §4.1 est confirmé.
|
||||||
|
3. **Le brouillon de réponse (S2) n'est pas utilisable** [code, test]. Un brouillon est rangé par conversation **et par utilisateur** : celui de l'« Agent IA » n'apparaît pas dans l'éditeur de l'humain (et l'appel par clé API renvoie 500). S2 écarté ; S1, la note privée, reste la sortie.
|
||||||
|
4. **Le tri T3b est faisable** [code, test]. `POST /api/v1/ai/suggest-tags {"conversation_uuid"}` accepte une clé API (sans permission particulière) et rend des suggestions sans les appliquer ; notre cron les appliquerait. Il faut un fournisseur IA configuré dans LibreDesk.
|
||||||
|
5. **L'assistant IA répond par mail** [code]. Sur une boîte e-mail, il envoie sa réponse à l'adresse du contact. T3a (assistant qui classe) reste sur l'instance de test, sans exception ; et l'essai D-142 (assistant seul) aussi, dans l'onglet Test.
|
||||||
|
6. **Les données des stations : le vrai préalable** [code du projet]. Les agents lisent `data/<STATION>/`, rempli à la main par `extraction/pomper.py` dans le dev container de `~/monitoring-dashboard` (base de production en lecture seule, et S3 pour les images). Sur un runner, il faudra pomper la station et la plage du mail avant l'analyse : identifiants de la base et de S3 en secrets Gitea, accès réseau du runner. Absent de la spec.
|
||||||
|
7. **Les dépôts sont « publics » sur `exchange.sensima.ch`** [prod] (`private: false`) : sans risque, le Gitea n'est joignable que de l'entreprise (Maxime, 2026-11-09).
|
||||||
|
|
||||||
|
## LibreDesk
|
||||||
|
|
||||||
|
| Point | Résultat | Source |
|
||||||
|
|---|---|---|
|
||||||
|
| Version installée | **v2.9.0** (IA ≥ 2.6, suppression de notes ≥ 2.5 : OK). Dernière publiée : v2.9.2 | [prod] `GET /api/v1/settings/general` |
|
||||||
|
| Authentification | `Authorization: token <clé>:<secret>`, clé par agent | [code, test] |
|
||||||
|
| Lire les conversations | `GET /api/v1/conversations/all?page_size=&order_by=&order=&filters=` (permissions `conversations:read` **et** `conversations:read_all`) | [test] |
|
||||||
|
| Filtrer par étiquette | `filters=[{"model":"conversations","field":"tags","operator":"contains","value":"[<id>]"}]`, aussi `not contains`, `set`, `not set` ; par **id** d'étiquette (`GET /api/v1/tags`) | [code, test] |
|
||||||
|
| Lire les messages | `GET /api/v1/conversations/{uuid}/messages` (`messages:read`) ; déjà fait par `app/serveur/libredesk.py` | [prod] |
|
||||||
|
| Note privée | `POST /api/v1/conversations/{uuid}/messages {"message","private":true,"sender_type":"agent"}` → 200, message `private: true`. `sender_type` obligatoire (400 sinon) | [test] |
|
||||||
|
| Réponse au client | même point d'accès, `private` faux ou absent → `outgoing`, mail envoyé | [test] |
|
||||||
|
| Note privée sans droit de réponse | rôle `conversations:read`, `conversations:read_all`, `messages:read`, `messages:write_private`, `conversations:update_tags` : note OK, toute réponse **403** | [test] |
|
||||||
|
| Supprimer sa note | `DELETE …/messages/{uuid}` (`messages:write_private`) → OK | [test] |
|
||||||
|
| Étiquettes d'une conversation | `POST /api/v1/conversations/{uuid}/tags {"tags":[noms],"action":"add_tags"|"remove_tags"|"set_tags"}`. **Sans `action`, c'est `set_tags` : remplace toutes les étiquettes** (celles des humains comprises) : toujours l'envoyer. Une étiquette inexistante est **ignorée en silence** (200) : relire les étiquettes après | [code, test] |
|
||||||
|
| Créer une étiquette | `POST /api/v1/tags` (`tags:manage`, admin) ; seul contrôle : non vide et unique. `tri:diagnostic`, `diag-fait`, espaces, emoji : acceptés | [code, test] |
|
||||||
|
| Étiquettes en production | aucune pour l'instant : à créer par un admin | [prod] |
|
||||||
|
| Règles d'automatisation | se déclenchent sur message entrant/sortant, assignation, statut, priorité ; **pas sur un changement d'étiquette** : nos étiquettes ne lancent aucune règle | [code] |
|
||||||
|
| Webhook | `conversation.tags_changed` existe (utile pour D3, plus tard) | [code] |
|
||||||
|
| Attributs personnalisés (S4) | `PUT /api/v1/conversations/{uuid}/custom-attributes` existe ; non testé | [code] |
|
||||||
|
| Brouillons (S2) | par conversation et par utilisateur : invisibles pour l'humain | [code, test] |
|
||||||
|
| Suggestions d'étiquettes (T2, T3b) | point d'accès ouvert à toute clé ; à tester avec un fournisseur configuré | [code, test] |
|
||||||
|
| Fournisseur IA = API Anthropic (compatible OpenAI) | **[?]** non testé (coûte des crédits) | |
|
||||||
|
| Règles et macros existantes de la production qui enverraient une réponse (§7.13) | **[?]** lecture réservée à l'admin | |
|
||||||
|
| Rôles en production : créer « Agent IA » | **[?]** un admin crée le rôle (liste ci-dessus), l'agent et sa clé | |
|
||||||
|
|
||||||
|
## Gitea
|
||||||
|
|
||||||
|
| Point | Résultat | Source |
|
||||||
|
|---|---|---|
|
||||||
|
| Instance | `exchange.sensima.ch`, « Powered by Gitea », `GET /api/v1/version` → `28.2.0` | [prod] |
|
||||||
|
| Actions activées sur le dépôt | `has_actions: true` sur `Support-Agent` | [prod] |
|
||||||
|
| `workflow_dispatch` par API | `POST /repos/{owner}/{repo}/actions/workflows/{id}/dispatches` présent | [prod] swagger |
|
||||||
|
| Artefacts | `/repos/{owner}/{repo}/actions/artifacts` présent ; version d'`upload-artifact` acceptée : **[?]** | [prod] swagger |
|
||||||
|
| Variables de dépôt / d'organisation | points d'accès présents | [prod] swagger |
|
||||||
|
| Runner installé, son label | **[?]** (lecture authentifiée) | |
|
||||||
|
| Le runner joint LibreDesk, `api.anthropic.com`, la base et S3 des stations | **[?]** à tester par un premier workflow | |
|
||||||
|
| `concurrency:` | **[?]** à tester par un workflow | |
|
||||||
|
|
||||||
|
## Le projet
|
||||||
|
|
||||||
|
- **Réutilisable sans interface** : `API/` (prompts, savoir, outils, détecteurs, `support/agent.py`, `support/seance.py`) ; `app/serveur/libredesk.py` (lecture des conversations et du fil, images jointes comprises).
|
||||||
|
- **Appel non interactif** : `Seance(mail, images, contexte, donnees, journal, sortie="mail").demarrer()` fait un tour du support, qui appelle l'analyste puis écrit `mail-vN.json` (le corps du mail et ses pièces jointes). Si le support manque d'une information, il pose une question à Marc et s'arrête (étape 2 de `prompts/support.md`) : sans Marc, cette question devient la note (`diag-ignore` ou une étiquette « question »).
|
||||||
|
- **Ne suit pas** : la web app `app/` (hors périmètre) ; la sortie PDF (Typst sur le runner, inutile pour une note).
|
||||||
|
- **À trancher** : comment `support-diagnostic` reprend `API/` (copie, sous-module, paquet) ; le nom du site → station (Crissier = LENZSPITZE) est aujourd'hui dans le contexte donné par Marc.
|
||||||
|
|
||||||
|
## L'instance de test
|
||||||
|
|
||||||
|
`../instance-de-test/` : LibreDesk v2.9.0, Postgres, Redis et **Mailpit**, un piège SMTP : tout « envoi » y reste, on le voit sur `http://127.0.0.1:9125`. Rien ne sort.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd instance-de-test && curl -sO https://raw.githubusercontent.com/abhinavxd/libredesk/v2.9.0/config.sample.toml && mv config.sample.toml config.toml && sed -i "s/^encryption_key = .*/encryption_key = \"$(python3 -c 'import secrets;print(secrets.token_hex(16))')\"/" config.toml
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd instance-de-test && LIBREDESK_SYSTEM_USER_PASSWORD='TestAdmin-2026!' docker compose -p ldtest up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
Interface : `http://127.0.0.1:9100` (utilisateur `System`). Rejouer les vérifications sur une instance neuve : `python3 -I verifier.py 'TestAdmin-2026!'`. Arrêter et effacer : `docker compose -p ldtest down -v`.
|
||||||
|
|
||||||
|
## Reste à faire par Maxime (ou un admin)
|
||||||
|
|
||||||
|
1. Gitea : runner et son label ; le runner joint-il LibreDesk, `api.anthropic.com`, la base et S3 des stations ?
|
||||||
|
2. LibreDesk : créer le rôle « Agent IA » (les cinq permissions ci-dessus, rien d'autre), l'agent et sa clé ; relire les règles et macros existantes (§7.13) ; créer les étiquettes du contrat.
|
||||||
|
3. Choisir : le contrat d'étiquettes final (`:` est accepté : `tri:diagnostic`) ; comment les données arrivent sur le runner.
|
||||||
@@ -0,0 +1,66 @@
|
|||||||
|
services:
|
||||||
|
# Libredesk app
|
||||||
|
app: # LibreDesk à la version de la production (v2.9.0)
|
||||||
|
image: libredesk/libredesk:v2.9.0
|
||||||
|
container_name: ldtest_app
|
||||||
|
restart: unless-stopped
|
||||||
|
ports:
|
||||||
|
- "127.0.0.1:9100:9000"
|
||||||
|
environment:
|
||||||
|
# If the password is set during first docker-compose up, the system user password will be set to this value.
|
||||||
|
# You can always set system user password later by running `docker exec -it libredesk_app ./libredesk --set-system-user-password`.
|
||||||
|
LIBREDESK_SYSTEM_USER_PASSWORD: ${LIBREDESK_SYSTEM_USER_PASSWORD:-}
|
||||||
|
networks:
|
||||||
|
- libredesk
|
||||||
|
depends_on:
|
||||||
|
- db
|
||||||
|
- redis
|
||||||
|
volumes:
|
||||||
|
- ./uploads:/libredesk/uploads:rw
|
||||||
|
- ./config.toml:/libredesk/config.toml
|
||||||
|
command: [sh, -c, "./libredesk --install --idempotent-install --yes --config /libredesk/config.toml && ./libredesk --upgrade --yes --config /libredesk/config.toml && ./libredesk --config /libredesk/config.toml"]
|
||||||
|
|
||||||
|
# PostgreSQL database
|
||||||
|
db:
|
||||||
|
image: postgres:17-alpine
|
||||||
|
container_name: ldtest_db
|
||||||
|
restart: unless-stopped
|
||||||
|
networks:
|
||||||
|
- libredesk
|
||||||
|
environment:
|
||||||
|
# Set these environment variables to configure the database, defaults to libredesk.
|
||||||
|
POSTGRES_USER: ${POSTGRES_USER:-libredesk}
|
||||||
|
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-libredesk}
|
||||||
|
POSTGRES_DB: ${POSTGRES_DB:-libredesk}
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-libredesk} -d ${POSTGRES_DB:-libredesk}"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 5s
|
||||||
|
retries: 6
|
||||||
|
volumes:
|
||||||
|
- postgres-data:/var/lib/postgresql/data
|
||||||
|
|
||||||
|
# Redis
|
||||||
|
redis:
|
||||||
|
image: redis:7-alpine
|
||||||
|
container_name: ldtest_redis
|
||||||
|
restart: unless-stopped
|
||||||
|
networks:
|
||||||
|
- libredesk
|
||||||
|
volumes:
|
||||||
|
- redis-data:/data
|
||||||
|
|
||||||
|
mailpit: # SMTP piège : tout « envoi » y reste, rien ne sort
|
||||||
|
image: axllent/mailpit:v1.27
|
||||||
|
container_name: ldtest_mailpit
|
||||||
|
ports:
|
||||||
|
- "127.0.0.1:9125:8025"
|
||||||
|
networks:
|
||||||
|
- libredesk
|
||||||
|
|
||||||
|
networks:
|
||||||
|
libredesk:
|
||||||
|
|
||||||
|
volumes:
|
||||||
|
postgres-data:
|
||||||
|
redis-data:
|
||||||
@@ -0,0 +1,128 @@
|
|||||||
|
"""Phase 0 sur l'instance LibreDesk de test (127.0.0.1:9100, SMTP = Mailpit 127.0.0.1:9125). Rien ne sort."""
|
||||||
|
import http.cookiejar, json, sys, time, urllib.error, urllib.parse, urllib.request
|
||||||
|
|
||||||
|
B, MP = "http://127.0.0.1:9100", "http://127.0.0.1:9125"
|
||||||
|
jar = http.cookiejar.CookieJar()
|
||||||
|
op = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(jar))
|
||||||
|
|
||||||
|
|
||||||
|
def req(m, p, body=None, auth=None, quiet=False):
|
||||||
|
r = urllib.request.Request(B + p, method=m, data=json.dumps(body).encode() if body is not None else None,
|
||||||
|
headers={"Content-Type": "application/json"})
|
||||||
|
if auth:
|
||||||
|
r.add_header("Authorization", f"token {auth}")
|
||||||
|
else:
|
||||||
|
csrf = next((c.value for c in jar if c.name == "csrf_token"), None)
|
||||||
|
if csrf:
|
||||||
|
r.add_header("X-CSRFTOKEN", csrf)
|
||||||
|
try:
|
||||||
|
with (urllib.request.urlopen(r) if auth else op.open(r)) as x:
|
||||||
|
return x.status, json.loads(x.read() or b"{}").get("data")
|
||||||
|
except urllib.error.HTTPError as e:
|
||||||
|
t = e.read().decode()
|
||||||
|
return e.code, (json.loads(t).get("message") if t.startswith("{") else t[:200])
|
||||||
|
|
||||||
|
|
||||||
|
def mailpit():
|
||||||
|
return json.load(urllib.request.urlopen(MP + "/api/v1/messages"))["messages_count"]
|
||||||
|
|
||||||
|
|
||||||
|
def ok(nom, cond, detail=""):
|
||||||
|
print(("OK " if cond else "ÉCHEC ") + nom + (f" [{detail}]" if detail else ""))
|
||||||
|
|
||||||
|
|
||||||
|
print("login", req("POST", "/api/v1/auth/login", {"email": "System", "password": sys.argv[1]})[0])
|
||||||
|
for c in jar:
|
||||||
|
c.secure = False # cookies Secure : http local
|
||||||
|
jar.set_cookie(http.cookiejar.Cookie(0, "csrf_token", "t0k3n", None, False, "127.0.0.1", False, False, "/", True,
|
||||||
|
False, None, False, None, None, {})) # le serveur compare cookie et en-tête
|
||||||
|
|
||||||
|
# boîte e-mail, SMTP = Mailpit
|
||||||
|
s, inbox = req("POST", "/api/v1/inboxes", {"name": "Test", "channel": "email", "enabled": True, "csat_enabled": False, "from": "Support <support@example.com>",
|
||||||
|
"config": {"auth_type": "password", "from": "Support <support@example.com>",
|
||||||
|
"smtp": [{"enabled": True, "host": "mailpit", "port": 1025, "username": "", "password": "",
|
||||||
|
"auth_protocol": "none", "tls_type": "none", "max_conns": 1, "max_msg_retries": 0,
|
||||||
|
"idle_timeout": "5s", "pool_wait_timeout": "5s", "hello_hostname": ""}],
|
||||||
|
"imap": [{"host": "127.0.0.1", "port": 1, "username": "x", "password": "x", "mailbox": "INBOX",
|
||||||
|
"read_interval": "1h", "scan_inbox_since": "1h", "tls_type": "none"}]}})
|
||||||
|
print("inbox", s, inbox if s != 200 else inbox["id"])
|
||||||
|
inbox_id = inbox["id"]
|
||||||
|
|
||||||
|
# étiquettes : caractères
|
||||||
|
for nom in ["tri:diagnostic", "diag-fait", "diag-en-cours", "tri-diagnostic", "Brouillon IA 🤖"]:
|
||||||
|
s, d = req("POST", "/api/v1/tags", {"name": nom})
|
||||||
|
ok(f"créer l'étiquette « {nom} »", s == 200, d if s != 200 else "")
|
||||||
|
tags = {t["name"]: t["id"] for t in req("GET", "/api/v1/tags")[1]}
|
||||||
|
|
||||||
|
# rôle restreint + agent IA + clé
|
||||||
|
perms = ["conversations:read", "conversations:read_all", "messages:read", "messages:write_private", "conversations:update_tags"]
|
||||||
|
s, role = req("POST", "/api/v1/roles", {"name": "Agent IA", "description": "notes privées seulement", "permissions": perms})
|
||||||
|
print("role", s, role if s != 200 else perms)
|
||||||
|
s, ag = req("POST", "/api/v1/agents", {"first_name": "Agent", "last_name": "IA", "email": "agent-ia@example.com",
|
||||||
|
"roles": ["Agent IA"], "send_welcome_email": False, "enabled": True})
|
||||||
|
print("agent", s, ag if s != 200 else ag["id"])
|
||||||
|
s, k = req("POST", f"/api/v1/agents/{ag['id']}/api-key")
|
||||||
|
print("api-key", s, list(k) if s == 200 else k)
|
||||||
|
KEY = f"{k['api_key']}:{k['api_secret']}"
|
||||||
|
|
||||||
|
# une conversation : un mail « client » (créée par l'admin, ce qui envoie un premier mail sortant vers Mailpit)
|
||||||
|
s, conv = req("POST", "/api/v1/conversations", {"inbox_id": inbox_id, "contact_email": "client@example.com",
|
||||||
|
"first_name": "Client", "last_name": "Test", "initiator": "contact", "subject": "Courbes bizarres", "content": "<p>amorce</p>"})
|
||||||
|
print("conversation", s, conv if s != 200 else conv["uuid"])
|
||||||
|
cu = conv["uuid"]
|
||||||
|
time.sleep(5)
|
||||||
|
m0 = mailpit()
|
||||||
|
|
||||||
|
# 1. note privée par la clé restreinte
|
||||||
|
s, n = req("POST", f"/api/v1/conversations/{cu}/messages", {"message": "<p>🤖 BROUILLON IA</p>", "private": True,
|
||||||
|
"sender_type": "agent"}, auth=KEY)
|
||||||
|
ok("note privée (clé restreinte)", s == 200 and n.get("private") is True, f"{s} private={n.get('private') if s == 200 else n}")
|
||||||
|
# 2. réponse au client par la clé restreinte : doit être refusée
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/messages", {"message": "<p>réponse</p>", "private": False,
|
||||||
|
"sender_type": "agent"}, auth=KEY)
|
||||||
|
ok("réponse refusée sans messages:write", s == 403, f"{s} {d}")
|
||||||
|
# 3. sans le champ private (défaut), clé restreinte
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/messages", {"message": "<p>défaut</p>", "sender_type": "agent"}, auth=KEY)
|
||||||
|
ok("sans « private » : refusé aussi (défaut = réponse)", s == 403, f"{s} {d}")
|
||||||
|
# 4. sans sender_type
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/messages", {"message": "<p>x</p>", "private": True}, auth=KEY)
|
||||||
|
print("note sans sender_type :", s, d if s != 200 else "acceptée")
|
||||||
|
time.sleep(5)
|
||||||
|
ok("aucun mail de plus dans Mailpit", mailpit() == m0, f"{m0} → {mailpit()}")
|
||||||
|
|
||||||
|
# 5. même appel sans private avec l'admin : part-il ? (instance de test seulement)
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/messages", {"message": "<p>admin défaut</p>", "sender_type": "agent",
|
||||||
|
"to": ["client@example.com"]})
|
||||||
|
time.sleep(8)
|
||||||
|
print("admin sans private :", s, "type", d.get("type") if s == 200 else d, "| Mailpit", m0, "→", mailpit())
|
||||||
|
|
||||||
|
# étiquettes : add / remove, étiquette inconnue, set par défaut
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/tags", {"tags": ["tri:diagnostic"], "action": "add_tags"}, auth=KEY)
|
||||||
|
ok("add_tags", s == 200, f"{s} {d}")
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/tags", {"tags": ["diag-en-cours"], "action": "add_tags"}, auth=KEY)
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/tags", {"tags": ["inconnue"], "action": "add_tags"}, auth=KEY)
|
||||||
|
print("add_tags d'une étiquette inexistante :", s, d)
|
||||||
|
s, c = req("GET", f"/api/v1/conversations/{cu}", auth=KEY)
|
||||||
|
print("étiquettes :", c.get("tags"))
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/tags", {"tags": ["diag-en-cours"], "action": "remove_tags"}, auth=KEY)
|
||||||
|
print("remove_tags →", req("GET", f"/api/v1/conversations/{cu}", auth=KEY)[1].get("tags"))
|
||||||
|
|
||||||
|
# filtre par étiquette
|
||||||
|
for f in ([{"model": "conversations", "field": "tags", "operator": "contains", "value": json.dumps([tags["tri:diagnostic"]])}],
|
||||||
|
[{"model": "conversations", "field": "tags", "operator": "not contains", "value": json.dumps([tags["diag-fait"]])}]):
|
||||||
|
s, d = req("GET", "/api/v1/conversations/all?page_size=50&filters=" + urllib.parse.quote(json.dumps(f)), auth=KEY)
|
||||||
|
print("filtre", f[0]["operator"], s, [x["uuid"] == cu for x in d["results"]] if s == 200 else d)
|
||||||
|
|
||||||
|
# brouillon : visible par qui ?
|
||||||
|
s, d = req("POST", f"/api/v1/conversations/{cu}/draft", {"content": "<p>brouillon IA</p>", "type": "reply"}, auth=KEY)
|
||||||
|
print("brouillon par la clé :", s)
|
||||||
|
s, d = req("GET", "/api/v1/drafts")
|
||||||
|
print("brouillons vus par l'admin :", s, len(d or []))
|
||||||
|
|
||||||
|
# suppression de sa propre note
|
||||||
|
s, d = req("DELETE", f"/api/v1/conversations/{cu}/messages/{n['uuid']}", auth=KEY)
|
||||||
|
ok("supprimer sa note privée", s == 200, f"{s} {d}")
|
||||||
|
|
||||||
|
# suggestion d'étiquettes par clé API (sans fournisseur IA configuré : on regarde seulement l'accès)
|
||||||
|
s, d = req("POST", "/api/v1/ai/suggest-tags", {"conversation_uuid": cu}, auth=KEY)
|
||||||
|
print("suggest-tags par clé :", s, d)
|
||||||
Reference in new issue
Block a user