plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "energyincloud",
  "version": "0.1.0",
  "description": "Ask about your solar and storage plant: production, consumption, self-consumption, savings, battery, connectivity and period reports, answered only from EnergyInCloud data.",
  "author": {
    "name": "Energy SpA",
    "email": "info@energysynt.com",
    "url": "https://mycloud.energy/"
  },
  "homepage": "https://mycloud.energy/",
  "repository": "https://github.com/eicsrl/energyincloud-plugin",
  "license": "MIT",
  "keywords": [
    "solar",
    "photovoltaic",
    "battery",
    "energy",
    "monitoring"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "EnergyInCloud",
        "shortDescription": "Ask your solar plant",
        "longDescription": "EnergyInCloud connects the assistant to the data of your solar plants with storage from the Ibridi Energy and EMS Energy XL families. Sign in with your zeroCO2 portal credentials and you see only your own plants. Ask how the plant is doing today, how much you produced, consumed and self-consumed in a period, how much you saved, how the battery is working, whether the plant is connected and the data are up to date, or ask for the monthly summary. Answers use only the data measured on your plant and always state the period they refer to; where a figure is missing or estimated, they say so. The assistant does not configure the plant and does not interpret individual alarms: the alarm list and its details stay in the portal. Installers and distributors also get fleet checks and the post-installation check on the plants they follow.",
        "developerName": "Energy SpA",
        "category": "Data & Analytics",
        "capabilities": [
          "Read plant data",
          "Energy and savings reports",
          "Installer fleet checks"
        ],
        "websiteURL": "https://mycloud.energy/",
        "supportURL": "https://mycloud.energy/assistenza/",
        "privacyPolicyURL": "https://mycloud.energy/privacy/",
        "termsOfServiceURL": "https://mycloud.energy/termini/",
        "defaultPrompt": [
          "Come va il mio impianto oggi?",
          "Quanto ho prodotto e risparmiato il mese scorso?",
          "La batteria oggi non si \u00e8 caricata, \u00e8 normale?"
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Daily plant status",
              "prompt": "How is my plant doing today?",
              "tools_triggered": "list_my_plants, get_plant_kpis, get_power_series",
              "expected_behavior": "Find the reviewer's plant, report today's production, consumption and battery figures with the time they run to, and state no fault unless a tool reports one."
            },
            {
              "description": "Production in a period",
              "prompt": "How much did my plant produce last month?",
              "tools_triggered": "list_my_plants, get_energy_summary",
              "expected_behavior": "Report last month's production, consumption and self-consumption in kWh for the plant, with the period covered and any availability warning."
            },
            {
              "description": "Savings estimate",
              "prompt": "How much did I save last month?",
              "tools_triggered": "list_my_plants, report_economics",
              "expected_behavior": "Report the estimated savings for last month, say that it is an estimate and which tariff assumptions it uses."
            },
            {
              "description": "Battery behaviour",
              "prompt": "The battery didn't charge today, is that normal?",
              "tools_triggered": "list_my_plants, get_battery_stats, get_power_series",
              "expected_behavior": "Show the battery's state of charge and charge/discharge data for today, explain the normal cases (for example a battery already full or no surplus production), and assert no defect unless a tool reports one."
            },
            {
              "description": "Fleet connectivity",
              "prompt": "Which of my plants are not communicating?",
              "tools_triggered": "check_fleet_connectivity",
              "expected_behavior": "List the plants visible to the account with their connectivity status, worst first, as returned by the tool."
            }
          ],
          "negative": [
            {
              "description": "Forecast request: the assistant gives no forecasts",
              "prompt": "How much will I save next year?"
            },
            {
              "description": "Comparison with other users' plants: out of scope, only the user's own plants are visible",
              "prompt": "Is my plant worse than other people's plants?"
            },
            {
              "description": "Configuration change: no write tool is available to this account",
              "prompt": "Change my battery's charging settings."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1kPMbDFH-9P6mnvq35qG4ssX6dQINkrlW/view?usp=sharing",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial release: read access to plant production, consumption, battery, savings and period reports; fleet checks for installers.",
        "translations": {
          "it-IT": {
            "subtitle": "Chiedi al tuo impianto solare",
            "description": "EnergyInCloud collega l'assistente ai dati dei tuoi impianti fotovoltaici con accumulo delle famiglie Ibridi Energy ed EMS Energy XL. Accedi con le credenziali del portale zeroCO2 e vedi solo i tuoi impianti. Puoi chiedere come sta andando l'impianto oggi, quanto hai prodotto, consumato e autoconsumato in un periodo, quanto hai risparmiato, come sta lavorando la batteria, se l'impianto \u00e8 collegato e i dati sono aggiornati, e farti preparare il riepilogo del mese. Le risposte usano solo i dati misurati dal tuo impianto e dicono sempre a quale periodo si riferiscono; dove un dato manca o \u00e8 stimato, lo dichiarano. L'assistente non configura l'impianto e non interpreta i singoli allarmi: la lista allarmi con i dettagli resta nel portale. Installatori e distributori vedono in pi\u00f9 le verifiche di flotta e il controllo post-installazione sugli impianti che seguono."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}