> ## 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.

# Definizioni metriche

> Cerca definizioni di metriche finanziarie, formule e relazioni causali.

`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`](/it/mcp/tools/company-metrics)

## Argomenti

<ParamField query="query" type="string" required>
  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.
</ParamField>

<ParamField query="top_k" type="integer">
  Numero massimo di risultati per la ricerca per parola chiave. Predefinito `5`, massimo `20`. Ignorato per le corrispondenze esatte per slug.
</ParamField>

<ParamField query="language" type="string">
  `"en"` per inglese (predefinito) o `"it"` per italiano.
</ParamField>

## Risposta

Una lista JSON di definizioni metriche, ciascuna contenente:

<ResponseField name="name" type="string">
  Nome della metrica leggibile.
</ResponseField>

<ResponseField name="syrto_code" type="string">
  Identificativo interno della metrica (slug). Usalo come input per `syrto_get_company_metrics` tramite il parametro `metric_slugs`. Usa `name` per la visualizzazione.
</ResponseField>

<ResponseField name="short_name" type="string | null">
  Nome abbreviato della metrica, se disponibile.
</ResponseField>

<ResponseField name="description" type="string">
  Spiegazione in linguaggio naturale di cosa misura la metrica.
</ResponseField>

<ResponseField name="type" type="string">
  Tipo della metrica - uno dei tipi secondo cui [Lista metriche disponibili](/it/mcp/tools/list-available-metrics) raggruppa il catalogo.
</ResponseField>

<ResponseField name="uom" type="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.
</ResponseField>

<ResponseField name="better_if" type="string">
  `"HIGHER"`, `"LOWER"`, o `"NEAR_TARGET"`.
</ResponseField>

<ResponseField name="better_if_target" type="float | null">
  Valore target quando `better_if` è `"NEAR_TARGET"`. `null` per metriche `HIGHER` o `LOWER`.
</ResponseField>

<ResponseField name="fraction_digits" type="integer">
  Numero di cifre decimali per la visualizzazione del valore della metrica.
</ResponseField>

<ResponseField name="calculation_formula" type="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.
</ResponseField>

<ResponseField name="affects" type="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`](/it/mcp/tools/company-metrics)
  * `year_delta` - lo scostamento di anno a cui le due metriche sono collegate
</ResponseField>

<ResponseField name="is_affected_by" type="object[]">
  Metriche che determinano questa, stessa struttura di `affects`.
</ResponseField>

<ResponseField name="year_delta" type="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?"
</ResponseField>

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](/it/mcp/introduction#risposte). Su questo strumento `display_title` è sempre `Syrto AI` e `subtitle` non è valorizzato.

## Esempio

**Cercare EBITDA e le sue dipendenze:**

```json theme={null}
{
  "query": "ebitda"
}
```

**Risposta (abbreviata):**

```json theme={null}
{
  "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": "▕████████████████░░░░▏"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.