Agent & CLI

Laissez un agent d’IA préparer les données. Approuvez vous-même chaque modification.

L’application Mac comprend une interface en ligne de commande vers vos projets. Un agent comme Codex ou Claude Code lit les factures, les relevés de compteurs et les exports ERP, propose les chiffres sous forme de simulation (dry run) et ne les écrit qu’après votre approbation, avec les mêmes calculs et contrôles que l’application.

Mis à jour le

Ce qui rend l’automatisation sûre

  • La logique de l’application elle-même

    Les commandes utilisent le même modèle de projet, les mêmes calculs et la même validation que l’application. Il n’y a pas de second jeu de règles à tenir à jour.

  • Simulation, approbation, application

    Chaque modification commence par une simulation. Seule la proposition exacte approuvée par une personne peut être appliquée, et l’approbation devient caduque si le projet change.

  • Un accès local que vous contrôlez

    L’application ouverte donne accès à son espace de travail chiffré via un intermédiaire (broker) sur votre Mac. Vous pouvez le désactiver à tout moment.

  • Prêt pour votre agent

    Prepare agent prompt rédige la tâche pour Codex ou Claude Code à partir des fichiers que vous choisissez ; un serveur MCP facultatif propose des outils de lecture et d’aperçu.

Pourquoi ne pas simplement laisser une IA rédiger le rapport ?

Un assistant d’IA généraliste peut rédiger un rapport agréable à lire, mais il doit chercher lui-même les facteurs d’émission. Il peut choisir un facteur inadapté, confondre des années ou des unités, ou combler un manque par une estimation plausible, et rien dans le texte ne montre d’où vient un chiffre. Interrogé deux fois, il peut donner deux réponses différentes.

Dans EnvironmentalReport, l’agent se contente de lire les documents et de proposer les valeurs d’entrée. Le calcul est effectué par l’application, pas par un modèle d’IA : des règles fixes et une bibliothèque de facteurs documentée et versionnée, de sorte que les mêmes entrées donnent toujours le même résultat. Lorsque l’application ne choisit pas un facteur automatiquement, l’agent compare les options et une personne décide ; le choix et sa raison sont enregistrés.

Les facteurs suivent le pays où l’entreprise exerce son activité, un détail qu’une IA généraliste manque facilement. L’électricité utilise le mix résiduel AIB de ce pays et, pour le résultat fondé sur la localisation, une source nationale officielle lorsqu’elle est intégrée, comme l’Umweltbundesamt pour l’Allemagne, RTE pour la France, l’ISPRA pour l’Italie ou OKTE pour la Slovaquie ; ailleurs, le mix de production AIB, signalé comme facteur de repli. Les carburants routiers utilisent la part nationale de biocarburants selon Eurostat, et la chaleur achetée le facteur propre du fournisseur local. Les combustibles suivent le DESNZ et les potentiels de réchauffement global l’IPCC AR6. Chaque facteur porte son année et son statut.

Le rapport n’est pas une boîte noire. Chaque chiffre calculé indique l’activité, le facteur avec sa source et son année ainsi que le calcul, et l’annexe des justificatifs liste les documents sur lesquels il repose. Si une entrée est erronée, par exemple une facture mal lue, l’erreur reste visible et traçable, et une personne a approuvé la valeur avant son écriture.

Comment un agent travaille avec l’application

  • Dans Agent / Command Line Access, activez l’accès et choisissez Prepare agent prompt
  • Choisissez les dossiers ou fichiers sources, puis un projet existant ou Identify project from sources
  • Collez la tâche dans Codex ou Claude Code ; l’agent lit les sources avec ses propres outils
  • L’agent propose chaque modification sous forme de simulation et vous montre le projet, l’année, la source et l’effet
  • Après votre approbation, il applique exactement cette proposition, recalcule, valide et indique ce qui reste ouvert

Ce que couvre la CLI

  • Informations sur l’entreprise, configuration et périmètre de reporting
  • Électricité, gaz, combustibles, véhicules, eau et déchets, avec le calcul de l’énergie et des gaz à effet de serre
  • Catégories du Scope 3 avec recherche de facteurs et trace de chaque choix de facteur
  • Pratiques et politiques (B2), informations sociales et de gouvernance et le questionnaire
  • Justificatifs copiés dans le projet avec leur empreinte et liés aux chiffres qu’ils étayent
  • Brouillons d’e-mails et demandes de questionnaire qu’une personne relit et envoie depuis l’application
  • Contrôles de préparation, la fiche de données ESG pour les banques en lecture seule et le PDF de l’inventaire des gaz à effet de serre

Données ERP et SAP

Pour les données comptables, la CLI utilise EDX, un format d’échange structuré : l’agent prépare le paquet à partir du modèle, le valide et propose l’import, avec des unités, devises et sites explicitement mis en correspondance. EDX est un échange, pas une connexion en direct : rien n’est réécrit dans votre ERP.

Ce qu’un agent ne peut pas faire

  • Écrire quoi que ce soit sans simulation approuvée, ni réutiliser une approbation après une modification du projet
  • Modifier directement les fichiers du projet, les sceaux d’intégrité ou la piste d’audit
  • Lire des clés, des mots de passe ou des identifiants de messagerie ; les identifiants sont saisis par une personne dans l’application
  • Inventer des valeurs manquantes, des zéros, des facteurs ou des justificatifs ; une source manquante n’efface jamais une valeur existante
  • Envoyer un e-mail, lancer Audit Ready ou demander une revue indépendante sans approbation spécifique

Où vont vos données

L’application ne nous envoie rien. L’intermédiaire n’existe que sur votre Mac, seulement tant que l’application est ouverte et l’accès activé, et il ne remet jamais la clé de l’espace de travail.

L’agent est un programme distinct avec son propre fournisseur. Ce qu’il lit, comme des factures ou des résultats de commandes, il peut l’envoyer à son modèle d’IA selon les conditions de ce fournisseur. Choisissez un agent et un modèle dont le traitement des données convient à votre entreprise, ou un modèle qui fonctionne en local.

Prérequis

  • L’application EnvironmentalReport sur un Mac, ouverte, avec son espace de travail chiffré déverrouillé
  • Accès agent activé dans Agent / Command Line Access ; la commande à copier vaut pour la session en cours
  • Un agent capable d’exécuter des commandes dans le terminal, comme Codex ou Claude Code, ou un hôte MCP
  • Un accès limité aux dossiers qu’une commande lit ou écrit, que vous confirmez dans la boîte de dialogue du système

Une session dans le terminal

Commandes tirées du manuel Agent et CLI, abrégées. En pratique, l’agent les exécute et vous montre chaque simulation pour approbation.

# Connect: the app shows the exact command to copy
ER=("<helper path>" --broker-endpoint "<session endpoint>")
"${ER[@]}" projects list --json

# Read the project and the open work
"${ER[@]}" show --project-id "$P" --year 2025 --numeric --json
"${ER[@]}" agent plan --project-id "$P" --year 2025 --json

# Propose a change: a dry run, nothing is written
"${ER[@]}" set electricity --project-id "$P" --year 2025 \
  --kwh 48750 --supplier "Documented supplier" \
  --actor "Reporting agent" --json

# After your approval: apply exactly that proposal
"${ER[@]}" set electricity --project-id "$P" --year 2025 \
  --kwh 48750 --supplier "Documented supplier" \
  --actor "Reporting agent" --json --apply \
  --operation-id "<from the dry run>" \
  --expected-project-hash "<from the dry run>"

# Check the result
"${ER[@]}" validate --project-id "$P" --year 2025 --json

Manuel Agent et CLI

La référence complète des commandes, le processus d’approbation, l’accès aux dossiers et la configuration MCP, en anglais.

Questions fréquentes

Faut-il être développeur ?

Non. L’application prépare la tâche pour l’agent, et vous approuvez ou refusez les propositions qu’il vous montre. Une certaine habitude d’un agent comme Codex ou Claude Code suffit.

Quelle différence avec une IA qui rédige des rapports ESG ?

Une IA généraliste rédige le texte et trouve elle-même les facteurs, si bien que ses chiffres peuvent être faux sans que personne ne voie pourquoi. Ici, l’agent ne fait que proposer les entrées ; l’application calcule avec des règles fixes et des facteurs documentés propres au pays de l’entreprise, et chaque chiffre montre son facteur, sa source et son calcul.

L’agent peut-il modifier les données sans moi ?

Non. Chaque modification commence par une simulation et n’est appliquée qu’après l’approbation de cette proposition exacte par une personne. Si le projet change entre-temps, l’agent a besoin d’une nouvelle simulation et d’une nouvelle approbation.

Cela fonctionne-t-il sous Windows ou Linux ?

Pas encore. La CLI fait partie de l’application Mac et fonctionne tant que l’application est ouverte. Une version Windows de l’application est en préparation.

La CLI produit-elle le rapport VSME ?

Elle prépare et contrôle les données et exporte la fiche de données ESG pour les banques et le PDF de l’inventaire des gaz à effet de serre. Le rapport VSME lui-même est préparé dans l’application, où une personne relit le PDF final avant son envoi.

Que propose le serveur MCP ?

Cinq outils pour un hôte MCP : capacités, état de l’espace de travail, liste des projets, années et aperçu limité des commandes. Il ne peut ni appliquer de modifications ni transférer de fichiers.