4.0 KiB
Support-AI : le diagnostic automatique des demandes de support
Les demandes des clients arrivent par mail dans LibreDesk. Quand une conversation porte l'étiquette tri:diagnostic, python -m support_diagnostic.run passe le mail aux agents support et analyste (copiés de Support-Agent/API/, dans agents/), puis dépose leur proposition de réponse en note privée dans la conversation. Un humain relit, corrige et envoie lui-même.
Spec : docs/spec.md. Vérifications de la phase 0 : docs/verifications.md. Plan de la phase 1 : docs/plans/2026-11-09-phase-1.md.
Aucun mail ne part au client
Chaque barrière suffit seule :
- Le compte LibreDesk « Agent IA » n'a pas la permission
messages:write: LibreDesk refuse toute réponse au client (403). - Seul
support_diagnostic/libredesk.pyparle à LibreDesk, et il ne sait écrire qu'une note privée (private: Trueen dur, sans destinataire) et des étiquettes ; une réponse de LibreDesk qui n'est pas une note privée arrête toute l'exécution (Garde).tests/test_garde_fou.pyle vérifie dans le code. - Les agents n'ont aucun accès à LibreDesk : ils rendent du texte.
- Simulation par défaut : seul
DRY_RUN=falseécrit, et seulement avec une liste blanche. KILL_SWITCHarrête tout avant la moindre lecture.
Les étiquettes
| Étiquette | Posée par | Sens |
|---|---|---|
tri:diagnostic |
le tri (humain, règle LibreDesk…) | à diagnostiquer |
diag:en-cours |
ce dépôt | traitement en cours (un runner tué la laisse : la retirer à la main) |
diag:fait |
ce dépôt | note posée, avec une proposition de réponse |
diag:ignore |
ce dépôt | note posée, sans proposition (question des agents, mail sans texte) |
diag:erreur |
ce dépôt | échec ; une note courte le dit |
diag:relancer |
un humain | refaire le diagnostic ; ses notes privées servent alors de contexte aux agents |
Éligible : tri:diagnostic et (aucune diag:*, ou diag:relancer). Les six étiquettes doivent exister dans LibreDesk (un admin les crée).
Réglages (Gitea : Settings → Actions)
| Nom | Type | Rôle |
|---|---|---|
LIBREDESK_URL |
variable | l'adresse de LibreDesk |
LIBREDESK_API_KEY, LIBREDESK_API_SECRET |
secrets | la clé de l'agent « Agent IA » |
ANTHROPIC_API_KEY |
secret | la clé de l'API Claude |
DRY_RUN |
variable | false pour écrire ; sinon simulation |
ALLOWED_CONVERSATION_IDS |
variable | uuid séparés par des virgules, ou * ; obligatoire pour écrire |
MAX_CONVERSATIONS_PER_RUN |
variable | défaut 3 |
KILL_SWITCH |
variable | non vide (autre que false, 0) : rien ne tourne |
Le rôle « Agent IA » dans LibreDesk : conversations:read, conversations:read_all, messages:read, messages:write_private, conversations:update_tags, rien d'autre.
Lancer : Actions → support-diagnostic → Run workflow (simulation par défaut ; une conversation précise en option : elle est traitée même sans tri:diagnostic, toujours sous la liste blanche). Un workflow lancé à la main doit être sur la branche par défaut.
Sur le poste
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python -m unittest discover -s tests -v
L'instance LibreDesk de test (LibreDesk v2.9.0 et Mailpit, un piège SMTP : rien ne sort) : docs/verifications.md, section « L'instance de test ». La préparer, puis le test de bout en bout :
.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
Un vrai diagnostic sur l'instance de test (coûte des crédits ; les données des stations sont celles de Support-Agent) :
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