# Strumenti

Gli strumenti connessi dotano i tuoi agenti IA di occhi e mani, consentendo loro di recuperare informazioni dal web in tempo reale, interagire con API reali, risolvere posizioni geografiche ed eseguire calcoli.

Senza strumenti, i grandi modelli linguistici sono limitati all'istantanea statica dei loro dati di pre-addestramento. Con gli strumenti abilitati, gli agenti possono cercare dinamicamente fatti in tempo reale, verificare le fonti, ispezionare URL live ed eseguire calcoli deterministici.

## Strumenti nativi disponibili

AIsh.li include una suite di strumenti nativi attivabili su qualsiasi agente con un solo clic:

| Strumento             | ID                | Descrizione                                                               | Guida                              |
| :-------------------- | :---------------- | :------------------------------------------------------------------------ | :--------------------------------- |
| **Ricerca Google**    | `search-google`   | Grounding di ricerca web in tempo reale con citazioni delle fonti live.   | [Guida Ricerca Google](search.md)  |
| **Recupero Web**      | `http`            | Leggi pagine web pubbliche, consulta documentazione e ispeziona API live. | [Guida Recupero Web](fetch.md)     |
| **Google Maps**       | `geo-google-maps` | Geocodifica indirizzi, risolvi coordinate GPS e individua luoghi.         | [Guida Google Maps](maps.md)       |
| **Esecuzione codice** | `code-execution`  | Esegui codice Python in sandbox per calcoli matematici esatti.            | [Guida Esecuzione codice](code.md) |

## Come funziona il Tool Calling

Quando un utente pone una domanda che richiede informazioni esterne o calcoli:

```mermaid
sequenceDiagram
    autonumber
    actor User as Utente
    participant Model as Modello IA
    participant Runtime as Runtime strumenti
    participant Search as Google Search API

    User->>Model: "What was the score of yesterday's Champions League match?"
    Note over Model: Riconosce il bisogno di dati live in tempo reale
    Model->>Runtime: Tool Call: search-google(query="Champions League score yesterday")
    Runtime->>Search: Esegui query web
    Search-->>Runtime: Risultati di ricerca strutturati & snippet
    Runtime-->>Model: Risposta dello strumento ancorata
    Model-->>User: Risposta sintetizzata con citazioni
```

## Abilitare gli strumenti su un agente

Puoi abilitare o disabilitare gli strumenti per qualsiasi agente in due modi:

1. **Builder visivo**:
   - Vai alla pagina [Agenti](/agents) e seleziona un agente da modificare (o [Crea un nuovo agente](/agents/new)).
   - Scorri fino alla sezione **Tools** (Strumenti).
   - Seleziona le caselle per **HTTP/URL 🌐**, **Google Search 🔎**, **Google Maps 🗺️** o **Code Execution 💻**.
   - Clicca su **Save Agent**.

2. **YAML dichiarativo**:
   - Clicca sulla scheda _Codice_ su qualsiasi pagina dell'agente.
   - Aggiungi gli identificatori degli strumenti desiderati all'array `tools`:

```yaml
id: my-account/research-assistant
instruction: You are a thorough researcher. Always verify facts using search.
model: gemini-3.8-flash
tools:
  - search-google
  - http
```

## Model Context Protocol (MCP)

Oltre ai nostri strumenti nativi integrati, AIsh.li è progettato con il supporto per il protocollo aperto [Model Context Protocol (MCP)](https://modelcontextprotocol.io), consentendo agli agenti aziendali di connettersi a database proprietari, API interne e strumenti aziendali personalizzati.

## Prossimi passi

Esplora le guide dettagliate per ciascuno strumento nativo:

- 🔎 **[Grounding Ricerca Google](search.md)**: Ricerca in tempo reale e verifica dei fatti.
- 🌐 **[Strumento Recupero Web](fetch.md)**: Recupero e lettura di URL live.
- 🗺️ **[Google Maps e Geolocalizzazione](maps.md)**: Risoluzione geografica e coordinate.
- 💻 **[Esecuzione codice](code.md)**: Esecuzione di calcoli Python in sandbox.
