From b48d7568833db82a561c94611f3d4bb30ca9d163 Mon Sep 17 00:00:00 2001 From: maxime Date: Mon, 9 Nov 2026 08:47:08 +0100 Subject: [PATCH] Workflows Gitea : tests et diagnostic manuel en simulation ; README Co-Authored-By: Claude Opus 5.5 --- .gitea/workflows/diagnostic.yml | 33 ++++++++++++++++ .gitea/workflows/tests.yml | 12 ++++++ README.md | 70 +++++++++++++++++++++++++++++++++ 3 files changed, 115 insertions(+) create mode 100644 .gitea/workflows/diagnostic.yml create mode 100644 .gitea/workflows/tests.yml diff --git a/.gitea/workflows/diagnostic.yml b/.gitea/workflows/diagnostic.yml new file mode 100644 index 0000000..21cae11 --- /dev/null +++ b/.gitea/workflows/diagnostic.yml @@ -0,0 +1,33 @@ +name: support-diagnostic +# Phase 1 : lancement à la main seulement, en simulation par défaut. Pas de schedule avant la phase 2 (spec §13). +on: + workflow_dispatch: + inputs: + dry_run: + description: "Mode simulation : aucune écriture dans LibreDesk (seul « false » écrit)" + default: "true" + conversation: + description: "Une seule conversation (uuid) ; vide : toutes les éligibles" + default: "" +concurrency: support-diagnostic +jobs: + run: + runs-on: ubuntu-latest # le label du runner de l'entreprise, à donner par Maxime + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: "3.12" + - run: pip install -r requirements.txt + - 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 }} + CONVERSATION: ${{ inputs.conversation }} + # AIMSIGHT_DATA : les données des stations ne sont pas encore sur le runner (docs/verifications.md, point 6) diff --git a/.gitea/workflows/tests.yml b/.gitea/workflows/tests.yml new file mode 100644 index 0000000..6572f43 --- /dev/null +++ b/.gitea/workflows/tests.yml @@ -0,0 +1,12 @@ +name: tests +on: push +jobs: + tests: + runs-on: ubuntu-latest # le label du runner de l'entreprise, à donner par Maxime + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: "3.12" + - run: pip install -r requirements.txt + - run: python -m unittest discover -s tests -v # test_instance est sauté : pas d'instance de test ici diff --git a/README.md b/README.md index e69de29..a938c76 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,70 @@ +# 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 : + +1. Le compte LibreDesk « Agent IA » n'a pas la permission `messages:write` : LibreDesk refuse toute réponse au client (403). +2. Seul `support_diagnostic/libredesk.py` parle à LibreDesk, et il ne sait écrire qu'une note privée (`private: True` en 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.py` le vérifie dans le code. +3. Les agents n'ont aucun accès à LibreDesk : ils rendent du texte. +4. Simulation par défaut : seul `DRY_RUN=false` écrit, et seulement avec une liste blanche. +5. `KILL_SWITCH` arrê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). Un workflow lancé à la main doit être sur la branche par défaut. + +## Sur le poste + +```bash +python3 -m venv .venv && .venv/bin/pip install -r requirements.txt +``` + +```bash +.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 : + +```bash +.venv/bin/python -I instance-de-test/preparer.py 'TestAdmin-2026!' instance-de-test/mail-exemple.txt +``` + +```bash +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`) : + +```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 +```