> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Consumi

> Riporta quanto ha consumato di recente l'utente connesso su Syrto AI, su quattro finestre temporali.

`syrto_get_usage` riporta quanto ha consumato di recente su Syrto AI l'utente connesso. Chiamarlo non costa nulla.

I consumi sono misurati in **unità di consumo (CU)**.

## Quando usare questo strumento

* Rispondere a "quanto ho speso?", "quanto è costato questo lavoro?" o "quanti consumi sto facendo?"

## Argomenti

Questo strumento non accetta argomenti.

<Note>
  `syrto_get_usage` è legato a un utente connesso. Una connessione autenticata con una chiave API di organizzazione non ha alcun utente associato, quindi su quella connessione lo strumento non viene proposto affatto.
</Note>

## Risposta

<ResponseField name="unit" type="string">
  L'unità in cui è espressa ogni cifra - unità di consumo (CU).
</ResponseField>

<ResponseField name="since_hour" type="object | null">
  Consumi dall'inizio dell'ora precedente. È la finestra più breve che i dati consentono.
</ResponseField>

<ResponseField name="today_utc" type="object | null">
  Consumi dalle 00:00 **UTC** di oggi - una giornata UTC, non locale.
</ResponseField>

<ResponseField name="last_7_days" type="object | null">
  Consumi degli ultimi 7 giorni.
</ResponseField>

<ResponseField name="last_30_days" type="object | null">
  Consumi degli ultimi 30 giorni.
</ResponseField>

<ResponseField name="attribution" type="string">
  Di chi sono queste cifre e quali sono i loro limiti.
</ResponseField>

Ogni finestra contiene:

<ResponseField name="consumption_units" type="integer">
  Unità di consumo spese in quella finestra.
</ResponseField>

<ResponseField name="start" type="string">
  Inizio della finestra (UTC, incluso), arrotondato all'ora.
</ResponseField>

<ResponseField name="end" type="string">
  Fine della finestra (UTC) - il momento della chiamata.
</ResponseField>

## Come leggere le cifre

* **Ogni finestra riporta i consumi dell'utente connesso**, mai il totale dell'organizzazione. Colleghi e integrazioni automatiche attingono allo stesso plafond.
* **Non sono una fattura né un saldo residuo.** Sono consumi già registrati. Per i consumi e il plafond dell'organizzazione, un amministratore può aprire la [dashboard Syrto](https://app.syrto.ai).
* **Le chiamate molto recenti potrebbero non essere ancora conteggiate.** Gli eventi di consumo sono bufferizzati, quindi una chiamata fatta poco fa può non comparire.
* **Non esiste una cifra per "questa conversazione".** Il server vede le singole chiamate agli strumenti e non può sapere dove inizia o finisce un lavoro; `since_hour` è la risposta più vicina disponibile.
* Le finestre sono in UTC e arrotondate all'ora, quindi "oggi" significa dalle 00:00 UTC, che può non coincidere con la giornata locale. Ogni finestra riporta lo `start` da cui è stata effettivamente misurata.

## Esempio

```json theme={null}
{}
```

**Risposta (abbreviata):**

```json theme={null}
{
  "result": {
    "unit": "consumption units (CU)",
    "since_hour": {
      "consumption_units": 14,
      "start": "2026-09-13T18:00:00+00:00",
      "end": "2026-09-13T18:42:07+00:00"
    },
    "today_utc": {
      "consumption_units": 96,
      "start": "2026-09-13T00:00:00+00:00",
      "end": "2026-09-13T18:42:07+00:00"
    },
    "last_7_days": { "consumption_units": 611, "start": "2026-09-06T18:00:00+00:00", "end": "2026-09-13T18:42:07+00:00" },
    "last_30_days": { "consumption_units": 2384, "start": "2026-08-14T18:00:00+00:00", "end": "2026-09-13T18:42:07+00:00" },
    "attribution": "These figures are your own consumption, not your organization's total - colleagues and any automated integrations consume from the same allowance. Very recent calls may not be counted yet."
  },
  "note": "Syrto data summary. More metrics, benchmarks, and insights are available at https://www.syrto.ai",
  "source_url": "https://app.syrto.ai"
}
```