Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Chiamata programmatica degli strumenti: strumenti orchestrati dal modello

Lezione 5 di 12 Aggiornata il 5 novembre 2026 Intermedio
In questa pagina
  1. Cosa cambia
  2. Abilitazione nell’API Responses
  3. Cosa riceve la tua applicazione
  4. Identificare i compiti che ne beneficiano
  5. Provala tu stesso
  6. Punti chiave

Stato al 5 novembre 2026. La famiglia GPT-6 eredita le capacità API di GPT-5.6, inclusa la Chiamata programmatica degli strumenti. L’API Agents lo abilita per impostazione predefinita (Lezione 10). OpenAI consiglia di verificare la scheda del modello prima di attivarlo.

Per capire cosa porta sul tavolo la Chiamata programmatica degli strumenti, devi prima osservare il costo della chiamata di funzione classica. Il modello richiede l’esecuzione di uno strumento, il tuo codice lo esegue e il risultato torna al modello, che lo legge e decide il passo successivo. Un round trip non è un grosso problema. Dieci round trip per un singolo compito sono tutta un’altra storia: ogni passo aggiunge latenza e ogni risultato intermedio, anche se voluminoso o irrilevante per la risposta finale, passa attraverso il contesto del modello e viene fatturato in token. Nei compiti ricchi di strumenti, questi round trip dominano sia la latenza che i costi.

Cosa cambia

La Chiamata programmatica degli strumenti è arrivata con GPT-5.6 il 9 luglio 2026, nell’API Responses. Invece di richiedere gli strumenti uno per uno, il modello scrive un piccolo programma JavaScript per coordinarli. Può avviare chiamate in parallelo, utilizzare cicli e condizioni e mantenere i risultati intermedi all’interno dell’ambiente di esecuzione. Solo il risultato ridotto, quello che conta per il passo successivo, torna nel contesto.

Prendi un’API paginata. Nella chiamata di funzione classica, ogni pagina di risultati attraversa il contesto affinché il modello possa decidere se richiedere la successiva. Con la Chiamata programmatica degli strumenti, il modello scrive un ciclo che itera attraverso le pagine, somma ciò che deve essere sommato e riporta solo i totali: meno token, meno latenza e meno codice di orchestrazione da mantenere per te.

OpenAI esegue ogni programma in un ambiente V8 fresco e isolato. Non c’è Node.js, nessuna installazione di pacchetti, nessun accesso diretto alla rete, nessun file system generale e nessuno stato conservato tra i programmi. Il programma interagisce con il mondo solo attraverso gli strumenti che gli esponi. Per l’API Responses, questo comportamento è compatibile con Zero Data Retention (ZDR), a condizione che ZDR sia abilitato per l’organizzazione o il progetto.

Abilitazione nell’API Responses

Due impostazioni sono sufficienti. Aggiungi lo strumento ospitato programmatic_tool_calling alla richiesta, quindi specifichi chi può chiamare ogni strumento idoneo usando allowed_callers: ["direct"] (il comportamento predefinito, in cui il modello chiama lo strumento stesso), ["programmatic"] (solo un programma può chiamarlo) o entrambi. La documentazione consiglia inoltre di descrivere l’output di ogni funzione con output_schema in modo che il codice generato possa fare affidamento sui suoi campi.

from openai import OpenAI

client = OpenAI()

tools = [
    {
        "type": "function",
        "name": "read_stock",
        "description": "Returns an object with sku (text) and units (number).",
        "parameters": {
            "type": "object",
            "properties": {"sku": {"type": "string"}},
            "required": ["sku"],
            "additionalProperties": False,
        },
        "output_schema": {
            "type": "object",
            "properties": {"sku": {"type": "string"}, "units": {"type": "number"}},
            "required": ["sku", "units"],
            "additionalProperties": False,
        },
        "allowed_callers": ["programmatic"],
    },
    {"type": "programmatic_tool_calling"},
]

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Check stock for SKUs A12, B07, and C33 and flag those under 10 units.",
    tools=tools,
)

I tipi di strumento che possono essere chiamati da un programma includono funzioni e strumenti personalizzati, strumenti MCP, apply_patch, shell locale o ospitata e l’interprete di codice. Per uno strumento MCP soggetto ad approvazione, il programma si mette in pausa finché non concedi il consenso.

Cosa riceve la tua applicazione

La risposta rimane un oggetto Responses standard con tre tipi di elementi da riconoscere. Un elemento program contiene il JavaScript generato. Gli elementi function_call corrispondono alle chiamate di funzione effettuate da quel programma; il loro campo caller identifica il programma chiamante. Infine, un elemento program_output fornisce il risultato finale del programma, con uno stato di completed o incomplete.

La tua applicazione non esegue mai il JavaScript; lo fa OpenAI. Tu esegui solo le tue funzioni, quindi restituisci ogni risultato in un function_call_output copiando il campo caller invariato in modo che il programma corretto possa riprendere. Ripeti questo ciclo finché la risposta non contiene più chiamate da eseguire.

Chi esegue cosa Tre passaggi: il modello scrive un programma JavaScript che OpenAI esegue in un ambiente isolato; la tua applicazione esegue le chiamate di funzione da quel programma e restituisce i risultati con il campo caller intatto; il programma fornisce un risultato ridotto in program_output. CHIAMATA PROGRAMMATICA DEGLI STRUMENTI Chi esegue cosa 1 Programma Scritto dal modello 2 Le tue funzioni Eseguite da te 3 Risultato program_output ridotto JavaScript viene eseguito su OpenAI, mai sul tuo lato. Le scritture sensibili rimangono dirette chiamate.
Basato sulla guida alla Chiamata programmatica degli strumenti nella documentazione API di OpenAI (novembre 2026).

Identificare i compiti che ne beneficiano

Non ogni integrazione di strumenti beneficia della migrazione. La guida di OpenAI offre una regola chiara: la Chiamata programmatica degli strumenti è adatta ai passaggi in cui il flusso è prevedibile e il codice può restituire un risultato più piccolo e strutturato. È progettata per filtrare, unire, ordinare, deduplicare, aggregare o convalidare più risultati, oppure per concatenare chiamate dipendenti in cui il flusso di dati è prevedibile. La chiamata diretta rimane preferibile per una singola ricerca o azione, per ricerche adattive in cui ogni risultato deve guidare la decisione successiva e per la convalida finale delle citazioni. Rimane inoltre la scelta predefinita per scritture e azioni che richiedono approvazione, al fine di mantenere un chiaro confine di autorizzazione.

Il criterio decisionale si riduce a una domanda: dove passa il tempo il tuo agente? Se la risposta è “in attesa di round trip degli strumenti”, la Chiamata programmatica degli strumenti è la prima area da valutare. Se le tue chiamate agli strumenti sono rare e i loro risultati brevi, mantieni la tua architettura attuale e concentra i tuoi sforzi altrove.

Provala tu stesso

Identifica un candidato. Prendi un flusso nel tuo agente che chiama più strumenti. Per ogni passaggio, annota il numero di chiamate, la dimensione dei risultati intermedi e se si tratta di una lettura o di una scrittura. Classifica ogni passaggio utilizzando la regola sopra. Per il passaggio più promettente, scrivi un prompt che specifichi gli strumenti consentiti, il formato del risultato atteso, la condizione di arresto, il numero massimo di tentativi e ciò che rimane una chiamata diretta.

Fonti ufficiali: Chiamata programmatica degli strumenti · Utilizzo di GPT-6 (documentazione API di OpenAI) · Annuncio di GPT-5.6 (OpenAI, 9 luglio 2026)

Punti chiave

  • Il modello scrive ed esegue JavaScript per coordinare i suoi strumenti in un ambiente isolato gestito da OpenAI
  • Abilitalo con lo strumento programmatic_tool_calling e il campo allowed_callers su ogni strumento
  • La tua applicazione esegue solo le sue funzioni e restituisce il campo caller intatto
  • Preferiscila per filtrare, aggregare o concatenare chiamate prevedibili; la chiamata diretta rimane la regola per scritture e approvazioni