Chiamata a strumenti (Tool calling)
Ragionamento
Livello 3 · Tecniche agenticheDefinisci quali strumenti può usare il modello, quando usarli e come gestire gli errori — distinto dal ciclo di ragionamento di ReAct.
La chiamata a strumenti definisce il contratto statico di quali strumenti/funzioni sono disponibili per il modello, quando ciascuno dovrebbe essere usato, quali parametri richiede, e cosa dovrebbe succedere se una chiamata fallisce — a differenza di ReAct, che è il ciclo dinamico di ragionamento, azione e osservazione dei risultati turno dopo turno. In pratica le due tecniche sono spesso usate insieme: la chiamata a strumenti definisce la cassetta degli attrezzi, ReAct definisce come il modello la usa passo dopo passo. Tenerle come tecniche separate rende più chiaro quale parte di un prompt agentico si sta migliorando.
Quando usarla
Usala ogni volta che un prompt dà al modello accesso a funzioni esterne, API o strumenti — definire la cassetta degli attrezzi esplicitamente (invece di descrivere gli strumenti vagamente in prosa) riduce la selezione errata degli strumenti e le chiamate malformate.
Quando evitarla
Evitala per prompt che non coinvolgono nessuna chiamata a strumenti o funzioni esterne — non c'è nulla da definire.
Vantaggi
- Rende espliciti e verificabili la selezione degli strumenti e i parametri, invece di lasciarli impliciti
- Separa 'quali strumenti esistono e come funzionano' da 'come il modello dovrebbe ragionare mentre li usa' (ReAct) — più facile individuare quale parte sta fallendo
- Riduce le chiamate malformate o inappropriate dichiarando la policy per quando usare ogni strumento
Svantaggi
- Non aggiunge valore senza ReAct o un ciclo di ragionamento equivalente che usi realmente gli strumenti definiti qui
- L'elenco degli strumenti e i parametri devono restare sincronizzati con ciò che è realmente disponibile — una definizione obsoleta causa errori reali, non solo di formulazione
Esempi
Compito: rispondi a domande sul meteo e su semplici conversioni di valuta. Strumenti disponibili: - get_weather(città) — restituisce il meteo attuale per una città - convert_currency(importo, da, a) — converte un importo tra valute Usa uno strumento solo quando la domanda richiede davvero dati in tempo reale o calcolati che non conosci già. Se una chiamata a uno strumento fallisce, dichiaralo esplicitamente e rispondi con le migliori informazioni disponibili invece di fingere che la chiamata sia riuscita.
Provala
Compila i placeholder qui sotto e guarda il prompt aggiornarsi in tempo reale.
Cosa vuoi ottenere.
Elenca gli strumenti/azioni che il modello può usare, uno per riga (es. search_web(query), get_weather(città)).
Quando dovrebbe essere usato uno strumento invece di rispondere direttamente?
Cosa dovrebbe succedere se una chiamata a uno strumento fallisce o restituisce un errore?
- 16
- Parole
- 120
- Caratteri
- 0/4
- Placeholder compilati
- 1 min
- Tempo di lettura
- Completezza0
- Chiarezza0
- Contesto0
- Specificità0
- Vincoli0
- Formato0
- Output0
- Sezione vincoli0
- Criteri di successo0
- Focus scope100
- Step di verifica0
- Esempio negativo0
- Confidenza0
- Sintassi placeholder100
- Struttura Markdown0
- Compila i placeholder rimasti.
- Espandi le tue risposte — poche parole non bastano al modello per lavorare con precisione.
- Aggiungi contesto di sfondo perché il modello capisca la situazione.