Skip to main content
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?”
  • Avere un’idea approssimativa di quanto resta del plafond dell’organizzazione

​
Argomenti

Questo strumento non accetta argomenti.
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.

​
Risposta

​
string
L’unità in cui è espressa ogni cifra - unità di consumo (CU).
​
object | null
Consumi dall’inizio dell’ora precedente. È la finestra più breve che i dati consentono.
​
object | null
Consumi dalle 00:00 UTC di oggi - una giornata UTC, non locale.
​
object | null
Consumi degli ultimi 7 giorni.
​
object | null
Consumi degli ultimi 30 giorni.
​
string
Di chi sono queste cifre e quali sono i loro limiti.
Accanto a result:
​
string
Quanto resta del plafond Syrto AI dell’organizzazione, con lo stesso indicatore a venti segmenti presente in ogni risposta - vedi Indicatore del plafond. Gli assistenti che mostrano le MCP App lo disegnano come una batteria accanto alla risposta, con una didascalia a parole come “Ampia disponibilità” o “In esaurimento” anziché un numero. Assente quando il plafond non è noto, per esempio su un piano senza limite di consumo.
La risposta contiene anche gli altri campi restituiti da ogni strumento. Su questo strumento display_title è sempre Syrto AI, e warning segnala quando il report dei consumi non è disponibile sulla connessione. Ogni finestra contiene:
​
integer
Unità di consumo spese in quella finestra.
​
string
Inizio della finestra (UTC, incluso), arrotondato all’ora.
​
string
Fine della finestra (UTC) - il momento della chiamata.

​
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.
  • 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.
  • Quanto resta è indicato solo in modo approssimativo, dall’indicatore allowance. Descrive il plafond dell’organizzazione e non i consumi dell’utente, e si muove a passi di un ventesimo.

​
Esempio

Risposta (abbreviata):