> ## 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">
  Categoria della metrica.
</ResponseField>

<ResponseField name="uom" type="string">
  Unità di misura (es. `"EUR"`, `"%"`, `"ratio"`).
</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.
</ResponseField>

<ResponseField name="affects" type="string[]">
  Metriche su cui questa influisce.
</ResponseField>

<ResponseField name="is_affected_by" type="string[]">
  Metriche che determinano questa.
</ResponseField>

<ResponseField name="note" type="string">
  Nota contestuale sulla disponibilità dei dati e dove trovare maggiori informazioni su syrto.ai.
</ResponseField>

## Esempio

**Cercare EBITDA e le sue dipendenze:**

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

**Risposta (abbreviata):**

```json theme={null}
[
  {
    "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": "..."
  }
]
```