{
  "name": "io-energy-perspective",
  "title": "AI energy footprint estimator",
  "description": "Estimates the operational electricity and CO2e attributable to a team's AI use, and compares it with the same workload done without AI. Directional, not an audit.",
  "version": "1.0.0",
  "provider": {
    "name": "inocta.io",
    "url": "https://inocta.io"
  },
  "url": "https://energie.inocta.io/",
  "languages": [
    "fr",
    "en"
  ],
  "authentication": "none",
  "dataRetention": "none",
  "tools": [
    {
      "name": "estimate_ai_energy",
      "description": "Compute the annual energy, CO2e and tree-year equivalence for a team's AI use, plus the equal-boundary comparison against the same work done without AI.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "employees": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100000,
            "description": "Number of employees using AI."
          },
          "usage": {
            "type": "string",
            "enum": [
              "light",
              "normal",
              "heavy"
            ],
            "description": "Interactions per person per day: light 8, normal 20, heavy 50."
          },
          "text": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Percent of interactions that are text. text + image + video + code must total 100."
          },
          "image": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Percent of interactions that generate an image."
          },
          "video": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Percent of interactions that generate video."
          },
          "code": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Percent of interactions that are coding turns."
          },
          "scenario": {
            "type": "string",
            "enum": [
              "CA",
              "US"
            ],
            "description": "Carbon-intensity scenario for electricity. NOT a claim about where the request was processed."
          }
        },
        "required": [
          "employees"
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "scenario": {
            "type": "object",
            "description": "The inputs as the tool resolved them, including any normalisation.",
            "properties": {
              "employees": {
                "type": "integer"
              },
              "interactionsPerDay": {
                "type": "integer"
              },
              "mix": {
                "type": "object",
                "description": "Percent shares, totalling 100.",
                "properties": {
                  "text": {
                    "type": "integer"
                  },
                  "image": {
                    "type": "integer"
                  },
                  "video": {
                    "type": "integer"
                  },
                  "code": {
                    "type": "integer"
                  }
                }
              },
              "carbonScenario": {
                "type": "string",
                "enum": [
                  "CA",
                  "US"
                ]
              },
              "gridNote": {
                "type": "string"
              }
            }
          },
          "result": {
            "type": "object",
            "properties": {
              "interactionsPerYear": {
                "type": "integer",
                "description": "AI requests per year."
              },
              "infraKwh": {
                "type": "number",
                "description": "Data-centre inference electricity, kWh/year."
              },
              "infraRangeKwh": {
                "type": "array",
                "items": {
                  "type": "number"
                },
                "description": "Low and high bound of infraKwh. The tool is directional: quote the range, not the point estimate alone."
              },
              "deviceKwh": {
                "type": "number",
                "description": "Employee workstation electricity while prompting, kWh/year. Never summed with infraKwh: different grids."
              },
              "co2Kg": {
                "type": "number",
                "description": "CO2e per year, kg, under the chosen scenario."
              },
              "co2RangeKg": {
                "type": "array",
                "items": {
                  "type": "number"
                },
                "description": "Low and high bound of co2Kg."
              },
              "treeYears": {
                "type": "integer",
                "description": "Whole urban tree-years of sequestration, rounded up."
              },
              "creditsTonnes": {
                "type": "number",
                "description": "The same figure expressed in tonnes, for comparison with carbon credits. NOT an offset claim."
              },
              "humanKwh": {
                "type": "number",
                "description": "Electricity of the same workload done without AI, kWh/year."
              },
              "humanKg": {
                "type": "number",
                "description": "CO2e of that no-AI scenario, kg/year."
              },
              "comparison": {
                "type": "object",
                "description": "Either a percent difference or, past a threshold, a multiple. Always carries the direction.",
                "properties": {
                  "percent": {
                    "type": "number"
                  },
                  "multiple": {
                    "type": "number"
                  },
                  "direction": {
                    "type": "string",
                    "enum": [
                      "lower",
                      "higher",
                      "comparable"
                    ]
                  }
                }
              }
            }
          },
          "boundary": {
            "type": "object",
            "description": "What the estimate includes and excludes. Read before summarising the result.",
            "properties": {
              "includes": {
                "type": "string"
              },
              "excludes": {
                "type": "string"
              },
              "infraAndDeviceNeverSummed": {
                "type": "string"
              },
              "treeEquivalence": {
                "type": "string"
              },
              "displacedMinutes": {
                "type": "string"
              }
            }
          },
          "disclaimer": {
            "type": "string"
          },
          "inputNotes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Present only when the tool normalised an input. Read it: the scenario computed may differ from the one requested."
          }
        }
      }
    }
  ],
  "documentation": "https://energie.inocta.io/llms.txt",
  "disclaimer": "Directional estimate. Excludes model training, hardware manufacturing, data-centre construction, water and rebound effects. The tree figure is a size equivalence, not a carbon offset."
}