Schema

Agenti che richiamano strumenti

Definizione

Gli agenti che richiamano strumenti (noti anche come agenti con function calling o agenti di esecuzione di azioni) sono sistemi basati su LLM che invocano dinamicamente funzioni esterne, API, database e strumenti di calcolo durante il loro processo di ragionamento per recuperare dati in tempo reale, modificare lo stato del sistema, eseguire calcoli o compiere azioni che vanno ben oltre la sola generazione di testo.

L'innovazione chiave è che l'LLM non si limita a descrivere cosa dovrebbe accadere: decide di richiamare strumenti specifici, genera argomenti strutturati ed elabora i risultati per continuare a ragionare. Questo trasforma gli LLM da predittori di testo passivi in agenti attivi capaci di interagire con il mondo digitale.

Spiegazione tecnica

Il richiamo di strumenti rappresenta un cambiamento fondamentale nel modo in cui si usano gli LLM: da generatori di informazioni a orchestratori di azioni. Richiede un'integrazione stretta tra l'inferenza del modello linguistico e l'esecuzione programmatica.

Come funziona il richiamo di strumenti

  1. Registrazione delle definizioni degli strumenti: gli sviluppatori definiscono gli strumenti disponibili con schemi JSON che specificano nome, descrizione, parametri (tipi, vincoli, campi obbligatori) e requisiti di autenticazione.
  2. Prompt arricchito: il sistema inietta gli schemi degli strumenti nel contesto dell'LLM, insieme alle istruzioni di sistema su quando e come usarli.
  3. Ragionamento e decisione: l'LLM elabora la richiesta dell'utente e determina se serve una chiamata a uno strumento, quale strumento usare e con quali parametri.
  4. Generazione dell'output strutturato: il modello restituisce un blocco strutturato (di norma JSON) con nome e argomenti dello strumento, seguendo il formato di function calling (stile OpenAI, Anthropic tool use o personalizzato).
  5. Convalida ed esecuzione: il sistema ospite convalida il JSON rispetto allo schema, verifica i permessi ed esegue lo strumento con gli argomenti forniti.
  6. Iniezione del risultato: l'output dello strumento (o l'errore) viene formattato e reinserito nel contesto dell'LLM come nuovo messaggio.
  7. Continuazione: l'LLM elabora il risultato e risponde all'utente oppure avvia un'altra chiamata a uno strumento in un ciclo che prosegue fino al completamento del compito.

Implementazioni moderne

Function calling di OpenAI

Supporto integrato per definire funzioni con schemi JSON. Il modello restituisce {"name": "...", "arguments": "{...}"}. Supporta chiamate parallele e convalida rigorosa dello schema.

Tool use di Anthropic

Simile a OpenAI ma con un output in stile XML più flessibile. Gli strumenti sono definiti come parte dell'array dei messaggi. Eccellente nella gestione di parametri annidati complessi.

LangChain / LlamaIndex

Astrazioni a livello di framework sopra il richiamo di strumenti, con agenti integrati (ReAct, OpenAI Functions e altri), gestione della memoria e persistenza dello stato.

MCP (Model Context Protocol)

Protocollo standardizzato per esporre strumenti e risorse agli LLM tra client e server diversi. Abilita l'interoperabilità e la scoperta degli strumenti.

Tipi di strumenti

Sfide tecniche principali

# Esempio: implementazione di un agente con richiamo di strumenti import json from OpenAI import OpenAI client = OpenAI() tools = [ { "type": "function", "function": { "name": "search_customer", "description": "Cerca un cliente per email o telefono", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Indirizzo email o numero di telefono" } }, "required": ["query"] } } }, { "type": "function", "function": { "name": "update_crm", "description": "Aggiorna un record cliente nel CRM", "parameters": { "type": "object", "properties": { "customer_id": {"type": "string"}, "updates": { "type": "object", "properties": { "status": {"type": "string"}, "notes": {"type": "string"} } } }, "required": ["customer_id", "updates"] } } } ] messages = [ {"role": "system", "content": "Sei un assistente CRM utile."}, {"role": "user", "content": "Imposta [email protected] sullo stato 'closed-won'"} ] # Ciclo principale di richiamo degli strumenti for _ in range(5): # Massimo 5 iterazioni response = client.chat.completions.create( model="gpt-4o", messages=messages, tools=tools ) choice = response.choices[0] if choice.finish_reason == "tool_calls": tool_calls = choice.message.tool_calls messages.append(choice.message) for tool_call in tool_calls: fn_name = tool_call.function.name args = json.loads(tool_call.function.arguments) # Esegui in base al nome della funzione if fn_name == "search_customer": result = search_customer_db(args["query"]) elif fn_name == "update_crm": result = update_crm_record(args["customer_id"], args["updates"]) # Aggiungi il risultato alla conversazione messages.append({ "role": "tool", "tool_call_id": tool_call.id, "content": json.dumps(result) }) else: # Nessuna altra chiamata a strumenti: risposta finale print(choice.message.content) break

Buone pratiche

Esempi reali

Assistenza clienti intelligente

Scenario: un agente di assistenza deve risolvere una richiesta di fatturazione di un cliente con il contesto completo.

Flusso di richiamo degli strumenti:

  1. Cerca il cliente: interroga l'API di Stripe con l'email → ottieni ID cliente, stato dell'abbonamento, cronologia dei pagamenti.
  2. Recupera le interazioni: cerca i ticket passati su Zendesk → individua i problemi ricorrenti.
  3. Calcola il rimborso: esegui uno strumento di calcolo per determinare il rimborso proporzionale in base al piano e all'utilizzo.
  4. Redigi la risposta: l'LLM genera una spiegazione personalizzata con un'offerta di rimborso.
  5. Aggiorna lo stato: chiama Stripe per applicare il credito e aggiorna lo stato del ticket su Zendesk.

Risultato: il tempo di risoluzione passa da 20 minuti (ricerche manuali, copia e incolla) a 2 minuti con piena accuratezza.

Qualificazione automatica dei lead

Scenario: una nuova segnalazione dal modulo web richiede arricchimento, punteggio e assegnazione.

Flusso di richiamo degli strumenti:

  1. Ricerca web: cerca i dati del profilo nelle API di LinkedIn/Twitter → arricchisci i dati aziendali.
  2. Controllo nel database: interroga Salesforce per contatti esistenti e interazioni precedenti.
  3. Calcolo del punteggio: calcola il punteggio di compatibilità in base a dimensione aziendale, settore, ruolo e livello di coinvolgimento.
  4. Decisione di instradamento: se il punteggio > 80, assegna all'SDR migliore; altrimenti aggiungi alla sequenza di coltivazione.
  5. Notifica: invia un messaggio Slack al commerciale assegnato con riepilogo e apertura suggerita.
  6. Aggiorna il CRM: crea un nuovo record lead con tutti i dati arricchiti e i passaggi successivi.

Risultato: tempo di prima risposta inferiore a 10 minuti contro oltre 4 ore di processo manuale, completezza dei dati al 95% contro il 60%.

Analisi dei dati e reporting

Scenario: report settimanale sulle prestazioni commerciali con analisi delle tendenze e raccomandazioni.

Flusso di richiamo degli strumenti:

  1. Recupero dei dati: interroga le API di HubSpot/Salesforce per tutte le trattative chiuse questa settimana, con fasi e valori.
  2. Analisi statistica: esegui codice Python per calcolare tassi di conversione, velocità e tendenze della dimensione media delle trattative.
  3. Previsione: applica un modello predittivo alla pipeline per proiezioni sui prossimi 30/60/90 giorni.
  4. Visualizzazione: genera grafici (matplotlib) e incorporali come immagini nel report.
  5. Redazione del testo: l'LLM scrive una sintesi esecutiva evidenziando successi, rischi e raccomandazioni.
  6. Distribuzione: invia il report via email alla dirigenza commerciale e pubblica il riepilogo su un canale Slack.

Risultato: i report settimanali automatizzati risparmiano 4 ore di lavoro all'analista, offrono una metodologia coerente e sono disponibili lunedì alle 8.

Termini correlati

Resta aggiornato.

Analisi tecniche, nuovi sistemi realizzati e lezioni dalla distribuzione di IA autonoma. Un'email a settimana, direttamente nella tua casella.

Un'email a settimana. Esci con un clic.