Definizioni metriche

syrto_search_metric_definitions restituisce definizioni complete delle metriche, inclusi nome, descrizione, formula di calcolo, unità di misura, direzione (meglio se più alto/più basso/vicino al target) e link di dipendenza che mostrano la catena causale tra le metriche.

Quando usare questo strumento

Capire cosa significa una specifica metrica finanziaria, come viene calcolata e cosa la determina
Esplorare le relazioni causali tra metriche e identificare le dipendenze
Risolvere il nome di una metrica nel suo slug prima di chiamare syrto_get_company_metrics

Argomenti

string

obbligatorio

Parola chiave (es. "profitability", "working capital", "debt") o slug esatto (es. "ebitda", "roe", "net_working_capital"). La ricerca per slug esatto restituisce sempre un singolo risultato istantaneamente.

integer

Numero massimo di risultati per la ricerca per parola chiave. Predefinito 5, massimo 20. Ignorato per le corrispondenze esatte per slug.

string

"en" per inglese (predefinito) o "it" per italiano.

Risposta

Una lista JSON di definizioni metriche, ciascuna contenente:

string

Nome della metrica leggibile.

string

Identificativo interno della metrica (slug). Usalo come input per syrto_get_company_metrics tramite il parametro metric_slugs. Usa name per la visualizzazione.

string | null

Nome abbreviato della metrica, se disponibile.

string

Spiegazione in linguaggio naturale di cosa misura la metrica.

string

Tipo della metrica - uno dei tipi secondo cui Lista metriche disponibili raggruppa il catalogo.

string

Unità di misura: "EUR" per un importo, "%" per una percentuale, "" (vuota) per un rapporto, indice o punteggio adimensionale, oppure un’unità di misura come "Day" o "Person". Un tasso riporta il suo denominatore, es. "EUR/Person".I valori sono memorizzati senza moltiplicazione e non sono limitati a 0-1: un ROI del 120% è memorizzato come 1.2 e un margine del -15% come -0.15. Una percentuale e una metrica adimensionale condividono questa forma e differiscono solo nel modo in cui vengono mostrate.

string

"HIGHER", "LOWER", o "NEAR_TARGET".

float | null

Valore target quando better_if è "NEAR_TARGET". null per metriche HIGHER o LOWER.

integer

Numero di cifre decimali per la visualizzazione del valore della metrica.

string

Come viene calcolata la metrica, come espressione matematica LaTeX - per esempio \frac{\text{Added value}}{\text{GDP}}. Rendila come formula matematica dove il client lo consente.Presentala insieme alla descrizione, non al suo posto: la descrizione dice che cosa misura la metrica, e la formula è l’unico punto in cui è data la matematica. Nomina a parole le metriche che consuma, mai per slug, quindi è sicura da mostrare per intero.Stringa vuota per una metrica che è una voce grezza di bilancio anziché un calcolo - una quota consistente del catalogo.

object[]

Metriche su cui questa influisce, una voce per relazione. Ogni voce ha:

name - il nome leggibile della metrica collegata. null solo quando il catalogo non contiene alcuna metrica con quello slug, nel qual caso il collegamento è privo di nome
syrto_code - slug interno, utile solo come input per syrto_get_company_metrics
year_delta - lo scostamento di anno a cui le due metriche sono collegate

object[]

Metriche che determinano questa, stessa struttura di affects.

integer

Su ogni link di dipendenza, lo scarto temporale a cui le due metriche sono legate: 0 stesso anno, -1 anno precedente, e così via. La stessa metrica può comparire più volte con scarti diversi - una metrica di crescita triennale consuma la metrica base in due anni differenti - quindi si tratta di relazioni distinte, non di voci ripetute. Conta una metrica una sola volta quando rispondi a “su quante metriche influisce questa?”

Quando una parola chiave non corrisponde ad alcuna metrica, result è una lista vuota e warning suggerisce un termine più ampio - non è un errore. Accanto a result, la risposta contiene i campi restituiti da ogni strumento. Su questo strumento display_title è sempre Syrto AI e subtitle non è valorizzato.

Esempio

Cercare EBITDA e le sue dipendenze:

{
  "query": "ebitda"
}

Risposta (abbreviata):

{
  "result": [
    {
      "name": "EBITDA",
      "syrto_code": "ebitda",
      "short_name": "EBITDA",
      "description": "Earnings before interest, taxes, depreciation, and amortisation. Measures operating profitability before non-cash charges.",
      "type": "profitability",
      "uom": "EUR",
      "better_if": "HIGHER",
      "better_if_target": null,
      "fraction_digits": 2,
      "calculation_formula": "\\text{Operating profit} + \\text{Depreciation} + \\text{Amortisation}",
      "affects": [
        { "name": "EBITDA Margin", "syrto_code": "ebitda_margin", "year_delta": 0 },
        { "name": "Debt / EBITDA", "syrto_code": "debt_ebitda_ratio", "year_delta": 0 }
      ],
      "is_affected_by": [
        { "name": "Revenues From Sales And Services", "syrto_code": "revenues_from_sales_and_services", "year_delta": 0 }
      ]
    }
  ],
  "reference_url": "https://app.syrto.ai",
  "display_title": "Syrto AI",
  "allowance": "▕████████████████░░░░▏"
}

Per iniziare

Strumenti

Definizioni metriche

Quando usare questo strumento

Argomenti

Risposta

Esempio

​Quando usare questo strumento

​Argomenti

​Risposta

​Esempio

Quando usare questo strumento

Argomenti

Risposta

Esempio