EnvironmentalReport.eu

Agent & CLI

Lascia che un agente IA prepari i dati. Ogni modifica la approvi tu.

L’app per Mac include un’interfaccia a riga di comando verso i tuoi progetti. Un agente come Codex o Claude Code legge fatture, letture dei contatori ed esportazioni ERP, propone i valori come simulazione (dry run) e li scrive solo dopo la tua approvazione, con gli stessi calcoli e controlli dell’app.

Aggiornato il

Richiedi l’accesso beta Piani e prezzi

Cosa rende sicura l’automazione

  • La logica stessa dell’app

    I comandi usano lo stesso modello di progetto, gli stessi calcoli e la stessa validazione dell’app. Non c’è un secondo insieme di regole da mantenere allineato.

  • Simulazione, approvazione, applicazione

    Ogni modifica inizia come simulazione. Si può applicare solo l’esatta proposta approvata da una persona, e l’approvazione decade se il progetto cambia.

  • Accesso locale sotto il tuo controllo

    L’app aperta concede l’accesso al suo spazio di lavoro cifrato tramite un intermediario (broker) sul tuo Mac. Puoi disattivarlo in qualsiasi momento.

  • Pronto per il tuo agente

    Prepare agent prompt scrive il compito per Codex o Claude Code dai file che scegli; un server MCP facoltativo offre strumenti di lettura e anteprima.

Perché non far scrivere il report semplicemente a un’IA?

Un assistente IA generico può scrivere un report che si legge bene, ma deve cercare da solo i fattori di emissione. Può scegliere un fattore non adatto, confondere anni o unità o colmare una lacuna con una stima plausibile, e nulla nel testo mostra da dove viene un valore. Se glielo chiedi due volte, può dare due risposte diverse.

In EnvironmentalReport l’agente si limita a leggere i documenti e a proporre i valori di input. Il calcolo lo fa l’app, non un modello di IA: regole fisse e una libreria di fattori documentata e versionata, così gli stessi input danno sempre lo stesso risultato. Dove l’app non sceglie un fattore automaticamente, l’agente confronta le opzioni e decide una persona; la scelta e il motivo vengono registrati.

I fattori seguono il paese in cui opera l’impresa, un dettaglio che un’IA generica trascura facilmente. L’elettricità usa il residual mix AIB di quel paese e, per il risultato location-based, una fonte nazionale ufficiale dove integrata, come l’Umweltbundesamt per la Germania, RTE per la Francia, ISPRA per l’Italia o OKTE per la Slovacchia; altrove il production mix AIB, segnalato come fattore di ripiego. I carburanti stradali usano la quota nazionale di biocarburanti secondo Eurostat e il calore acquistato il fattore del fornitore locale. I combustibili seguono DESNZ e i potenziali di riscaldamento globale IPCC AR6. Ogni fattore riporta anno e stato.

Il report non è una scatola nera. Ogni valore calcolato mostra l’attività, il fattore con fonte e anno e il calcolo, e l’allegato della documentazione elenca i documenti su cui si basa. Se un input è sbagliato, ad esempio una fattura letta male, l’errore resta visibile e tracciabile, e una persona ha approvato il valore prima della scrittura.

Come un agente lavora con l’app

  • In Agent / Command Line Access attiva l’accesso e scegli Prepare agent prompt
  • Scegli le cartelle o i file di origine e un progetto esistente oppure Identify project from sources
  • Incolla il compito in Codex o Claude Code; l’agente legge le fonti con i propri strumenti
  • L’agente propone ogni modifica come simulazione e ti mostra progetto, anno, fonte ed effetto
  • Dopo la tua approvazione applica esattamente quella proposta, ricalcola, valida e segnala cosa resta aperto

Cosa copre la CLI

  • Dati dell’impresa, configurazione e perimetro di rendicontazione
  • Elettricità, gas, combustibili, veicoli, acqua e rifiuti, con il calcolo di energia e gas serra
  • Categorie Scope 3 con ricerca dei fattori e registrazione di ogni scelta di fattore
  • Prassi e politiche (B2), informative sociali e di governance e il questionario
  • Documentazione copiata nel progetto con la sua impronta e collegata ai valori che supporta
  • Bozze di e-mail e richieste di questionario che una persona controlla e invia dall’app
  • Controlli di prontezza, la scheda dati ESG per le banche in sola lettura e il PDF dell’inventario dei gas serra

Dati da ERP e SAP

Per i dati contabili la CLI usa EDX, un formato di scambio strutturato: l’agente prepara il pacchetto dal modello, lo valida e propone l’importazione, con unità, valute e sedi mappate esplicitamente. EDX è uno scambio, non una connessione in tempo reale: nulla viene riscritto nel tuo ERP.

Cosa un agente non può fare

  • Scrivere qualsiasi cosa senza una simulazione approvata, né riutilizzare un’approvazione dopo che il progetto è cambiato
  • Modificare direttamente i file di progetto, i sigilli di integrità o la traccia di audit
  • Leggere chiavi, password o credenziali della casella di posta; le credenziali le inserisce una persona nell’app
  • Inventare valori mancanti, zeri, fattori o documentazione; una fonte mancante non cancella mai un valore esistente
  • Inviare e-mail, avviare Audit Ready o richiedere una revisione indipendente senza un’approvazione specifica

Dove vanno i tuoi dati

L’app non ci invia nulla. L’intermediario esiste solo sul tuo Mac, solo finché l’app è aperta e l’accesso è attivo, e non cede mai la chiave dello spazio di lavoro.

L’agente è un programma separato con il proprio fornitore. Ciò che legge, come fatture o risultati dei comandi, può inviarlo al suo modello di IA secondo le condizioni di quel fornitore. Scegli un agente e un modello il cui trattamento dei dati sia adatto alla tua azienda, oppure un modello che gira in locale.

Requisiti

  • L’app EnvironmentalReport su un Mac, aperta, con lo spazio di lavoro cifrato sbloccato
  • Accesso per l’agente attivo in Agent / Command Line Access; il comando da copiare vale per la sessione corrente
  • Un agente in grado di eseguire comandi da terminale, come Codex o Claude Code, oppure un host MCP
  • Accesso solo alle cartelle che un comando legge o scrive, confermato da te nella finestra di sistema

Una sessione nel terminale

Comandi dal manuale Agent e CLI, abbreviati. In pratica li esegue l’agente e ti mostra ogni simulazione per l’approvazione.

# 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

Manuale Agent e CLI

Il riferimento completo dei comandi, il flusso di approvazione, l’accesso alle cartelle e la configurazione MCP, in inglese.

Scarica il manuale Agent e CLI (PDF)

Domande frequenti

Devo essere uno sviluppatore?

No. L’app prepara il compito per l’agente e tu approvi o rifiuti le proposte che ti mostra. Basta un po’ di familiarità con un agente come Codex o Claude Code.

Che differenza c’è con un’IA che scrive report ESG?

Un’IA generica scrive il testo e trova da sola i fattori, quindi i suoi valori possono essere sbagliati senza che nessuno veda perché. Qui l’agente propone solo gli input; l’app calcola con regole fisse e fattori documentati per il paese dell’impresa, e ogni valore mostra fattore, fonte e calcolo.

L’agente può modificare i dati senza di me?

No. Ogni modifica inizia come simulazione e viene applicata solo dopo che una persona ha approvato esattamente quella proposta. Se nel frattempo il progetto cambia, l’agente ha bisogno di una nuova simulazione e di una nuova approvazione.

Funziona su Windows o Linux?

Non ancora. La CLI fa parte dell’app per Mac e funziona finché l’app è aperta. Una versione dell’app per Windows è in preparazione.

La CLI produce il report VSME?

Prepara e controlla i dati ed esporta la scheda dati ESG per le banche e il PDF dell’inventario dei gas serra. Il report VSME si prepara nell’app, dove una persona controlla il PDF finale prima dell’invio.

Cosa offre il server MCP?

Cinque strumenti per un host MCP: funzionalità, stato dello spazio di lavoro, elenco dei progetti, anni e un’anteprima limitata dei comandi. Non può applicare modifiche né trasferire file.

Leggi anche