Vai al contenuto principale

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.

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

​
query
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.
​
top_k
integer
Numero massimo di risultati per la ricerca per parola chiave. Predefinito 5, massimo 20. Ignorato per le corrispondenze esatte per slug.
​
language
string
"en" per inglese (predefinito) o "it" per italiano.

​
Risposta

Una lista JSON di definizioni metriche, ciascuna contenente:
​
name
string
Nome della metrica leggibile.
​
syrto_code
string
Identificativo interno della metrica (slug). Usalo come input per syrto_get_company_metrics tramite il parametro metric_slugs. Usa name per la visualizzazione.
​
short_name
string | null
Nome abbreviato della metrica, se disponibile.
​
description
string
Spiegazione in linguaggio naturale di cosa misura la metrica.
​
type
string
Categoria della metrica.
​
uom
string
Unità di misura (es. "EUR", "%", "ratio").
​
better_if
string
"HIGHER", "LOWER", o "NEAR_TARGET".
​
better_if_target
float | null
Valore target quando better_if è "NEAR_TARGET". null per metriche HIGHER o LOWER.
​
fraction_digits
integer
Numero di cifre decimali per la visualizzazione del valore della metrica.
​
calculation_formula
string
Come viene calcolata la metrica.
​
affects
string[]
Metriche su cui questa influisce.
​
is_affected_by
string[]
Metriche che determinano questa.
​
note
string
Nota contestuale sulla disponibilità dei dati e dove trovare maggiori informazioni su syrto.ai.

​
Esempio

Cercare EBITDA e le sue dipendenze: 
{
  "query": "ebitda"
}
Risposta (abbreviata): 
[
  {
    "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": "Operating profit + Depreciation + Amortisation",
    "affects": ["EBITDA Margin", "Net Financial Position / EBITDA"],
    "is_affected_by": ["Revenues", "Operating Costs"],
    "note": "..."
  }
]