Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Collega il tuo GPT alle API esterne

Lezione 9 di 17 Aggiornata il 5 novembre 2026 Intermedio
In questa pagina
  1. Oltre il GPT isolato
  2. Cos’è un’Azione?
  3. Lo schema OpenAPI
  4. Configurare un’Azione nell’editor GPT
  5. A te la parola: un’API pubblica
  6. Punti chiave

Stato al 5 novembre 2026: i GPT sono nelle loro ultime settimane. OpenAI disattiverà i GPT personalizzati l’11 dicembre 2026 (11 febbraio 2027 per alcuni workspace Enterprise con esenzione). Gli account Personal, Free, Go, Plus e Pro non possono più creare o pubblicare nuovi GPT; nei workspace Business, Enterprise ed Edu, la creazione dipende dalle impostazioni ed è cessata il 26 ottobre 2026 nei workspace Enterprise interessati. I GPT esistenti rimangono utilizzabili e modificabili se il tuo piano lo consente fino alla disattivazione; le conversazioni avute con loro resteranno accessibili anche dopo. La migrazione (Migrate to plugin, in My GPTs) converte le istruzioni in una skill, la base di conoscenza in file di riferimento e le app connesse in app; le azioni personalizzate non vengono trasferite. Questa lezione spiega come funzionano i GPT per aiutarti a mantenerli, migrarli e adattare i loro principi a un plugin (Lezioni 15–17).

Oltre il GPT isolato

Finora, il tuo GPT ha operato in un silos: le sue istruzioni definiscono il comportamento e la sua Knowledge fornisce i tuoi documenti. È potente, ma rimane tagliato fuori dal mondo reale. Non può consultare il tuo CRM in tempo reale, creare un evento in calendario o interrogare il tuo database: conosce solo ciò che hai caricato, congelato al momento del caricamento. Le Azioni rimuovono questo limite: permettono al tuo GPT di chiamare API esterne per leggere e scrivere dati nei tuoi strumenti durante una conversazione.

Cos’è un’Azione?

Un’Azione è un collegamento tra il tuo GPT e un servizio esterno tramite la sua API. Il flusso è sempre lo stesso: l’utente pone una domanda o dà un’istruzione, il GPT identifica che ha bisogno di dati esterni per rispondere, chiama l’API del servizio, riceve la risposta e la integra nella sua risposta finale. Pensa a un GPT per le vendite collegato a un CRM: quando un utente chiede “Qual è lo stato della pratica Dupont?”, il GPT interroga l’API del CRM, recupera la scheda cliente e risponde con i dati di oggi, non con il ricordo di un file caricato tre mesi fa. Tutto ciò avviene in modo trasparente per l’utente, che ha semplicemente la sensazione di parlare con un assistente ben informato.

Lo schema OpenAPI

Affinché il GPT chiami un’API, devi descriverla. È questo il ruolo dello schema OpenAPI (ex Swagger), un file JSON o YAML che funge da manuale d’istruzioni dell’API. Descrive gli endpoint (gli URL che il GPT può chiamare), i metodi associati (GET per leggere, POST per creare, PUT per aggiornare, DELETE per eliminare), i parametri attesi da ciascun endpoint e il formato delle risposte restituite. Sulla base di questo documento, il GPT decide autonomamente, durante la conversazione, quale endpoint chiamare e con quali parametri.

Ecco come appare uno schema minimo per un’API meteorologica fittizia:

openapi: 3.1.0
info:
  title: Weather API
  version: 1.0.0
servers:
  - url: https://example.com
paths:
  /forecast:
    get:
      operationId: getForecast
      summary: Get weather forecast for a city
      parameters:
        - name: city
          in: query
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Weather forecast

Buone notizie: quasi mai dovrai scrivere questo file da zero. Molti servizi pubblicano il loro schema OpenAPI direttamente nella documentazione delle API. In caso contrario, strumenti come Swagger Editor (o lo stesso ChatGPT, se gli descrivi l’API) possono generarlo. E se il tuo team tecnico lavora con Postman, le sue collezioni si esportano in formato OpenAPI.

Configurare un’Azione nell’editor GPT

La configurazione avviene nell’editor web del tuo GPT: vai alla sezione Actions, clicca su Create new action, incolla il tuo schema OpenAPI nel campo predisposto, configura l’autenticazione (trattata nella prossima lezione), quindi testa l’azione dal pannello di anteprima.

La qualità del tuo schema determina la qualità delle chiamate. Tieni a mente tre abitudini. Primo, dai nomi espliciti ai valori operationId: il GPT si basa su questi per decidere quale azione chiamare, e getForecast lo guida molto meglio di op_42. Secondo, scrivi descrizioni chiare per ogni endpoint e parametro, in linguaggio naturale, come se stessi spiegando l’API a un collega. Infine, esponi solo gli endpoint di cui hai realmente bisogno: se il tuo GPT necessita solo di due o tre route, non esporre tutte le quaranta route dell’API completa. Ogni endpoint esposto occupa spazio nel contesto del GPT e aumenta il rischio che ne scelga uno sbagliato.

Un'azione in quattro passaggi Quattro passaggi: descrivi l'API con uno schema OpenAPI in JSON o YAML; scegli l'autenticazione, nessuna, chiave o OAuth; testa in anteprima; il GPT chiama poi l'API quando utile. COLLEGA UN'API Un'azione in quattro passaggi 1 Schema OpenAPI, JSON o YAML 2 Accesso Nessuna, chiave o OAuth 3 Test Nell' anteprima 4 Utilizzo Il GPT chiama l'API Nessuna azione in modalità Pro e le azioni non vengono trasferite a un plugin.
Basato sull'articolo "Configuring actions in GPTs" dell'OpenAI Help Center (novembre 2026).

A te la parola: un’API pubblica

La tua prima azione, o il suo piano. Il terreno di allenamento migliore è un’API pubblica e gratuita (meteo, tassi di cambio, notizie) che non richieda autenticazioni complesse. Scegline una, recupera o crea il suo schema OpenAPI e aggiungila come Azione al tuo GPT. Non dimenticare di collegare l’Azione alle tue istruzioni specificando quando usarla: “Quando l’utente chiede il meteo, usa l’azione getForecast”. Quindi testa con diverse formulazioni per verificare che il GPT attivi la chiamata al momento giusto.

Alcune insidie attendono i primi tentativi. Uno schema malformato (una singola virgola mancante nel JSON) blocca tutto: valida sempre il tuo schema in Swagger Editor prima di incollarlo. Descrizioni mancanti lasciano il GPT cieco: senza di esse, non sa quando un’azione è rilevante. Prevedi anche gli errori API, che prima o poi accadranno: specifica il comportamento nelle tue istruzioni, ad esempio “Se l’API non risponde, dì all’utente di riprovare più tardi”; altrimenti il GPT improvviserà, a volte inventando dati. E non affidarti solo al pannello di anteprima: testa in condizioni reali, con dati reali e formulazioni reali degli utenti.

Conosci due limiti prima di iniziare: un GPT utilizza app connesse o azioni, non entrambe, e le azioni non funzionano in modalità Pro. Soprattutto, le azioni personalizzate non vengono trasferite a un plugin durante la migrazione: verifica prima se la directory dei plugin offre già un’app per il servizio target; in caso contrario, dovrai ricostruire l’integrazione, ad esempio con un server MCP.

Fonti ufficiali: Configuring actions in GPTs (OpenAI Help Center: autenticazione, schema OpenAPI, test, limiti) · Custom GPT retirement and migration FAQ (le azioni non vengono trasferite) · OpenAPI Specification (formato schema)

Punti chiave

  • Le azioni collegano il tuo GPT a servizi esterni tramite le loro API
  • Devi fornire uno schema OpenAPI che descriva gli endpoint disponibili
  • Le descrizioni nello schema sono essenziali: il GPT le usa per decidere quale azione chiamare
  • Inizia con un’API pubblica gratuita per familiarizzare con il processo
  • Limita gli endpoint esposti allo stretto necessario per il tuo caso d’uso