OpenAI
Questa pagina è stata tradotta automaticamente. Visualizza l'articolo originale in inglese.

Configurare le azioni nei GPT

Come collegare il tuo GPT ad API esterne usando le azioni, incluse configurazione, autenticazione e configurazione dello schema.

Aggiornato: 24 minutes ago

Prevediamo di dismettere i GPT personalizzati e di aiutare chi li crea a trasferire i propri flussi di lavoro ai plugin. I plugin riuniscono istruzioni riutilizzabili, file di riferimento e app connesse.

Per le aree di lavoro Enterprise interessate, la creazione di nuovi GPT è stata disabilitata il 26 ottobre 2026. Le aree di lavoro FedRAMP sono escluse da questa restrizione e possono ancora creare GPT. I GPT esistenti non ancora migrati restano utilizzabili e modificabili fino alla rispettiva data di dismissione. Dopo la migrazione, il GPT originale diventa di sola lettura. La data di dismissione standard è fissata all'11 dicembre 2026. Per le aree di lavoro FedRAMP e per quelle che soddisfano i requisiti e hanno ottenuto una proroga, la data di dismissione è l'11 febbraio 2027.

La transizione riguarda tutti i piani ChatGPT, ma le restrizioni alla creazione e l'accesso alla migrazione dipendono dall'account o dall'area di lavoro. Segui le indicazioni dell'avviso relativo al tuo account o alla tua area di lavoro. Per le date, i passaggi della migrazione e i cambiamenti previsti per gli altri piani, consulta: Domande frequenti sulla dismissione e sulla migrazione dei GPT personalizzati.

Panoramica

Questo articolo spiega come configurare le azioni in un GPT, incluso come connettersi ad API esterne, definire cosa può fare il GPT e gestire autenticazione, schemi e restrizioni dell’area di lavoro.

Per configurare un’azione, ti serviranno i dettagli API del servizio che vuoi connettere, incluse le informazioni di autenticazione e uno schema OpenAPI. Un GPT può usare app o azioni, ma non entrambe contemporaneamente.

Ogni azione è definita da due componenti principali: il modo in cui il GPT si autentica con l’API e uno schema che definisce cosa può fare l’API.

Limitazioni

Se la tua area di lavoro non consente alcun dominio di azione, le azioni personalizzate dei GPT non possono essere eseguite perché nessun dominio di azione può superare i controlli dell’elenco di consentiti. Questo non significa necessariamente che tutta la visibilità o l’accesso ai GPT sia bloccato.

Le azioni non sono disponibili per la modalità Pro. Quando crei o modifichi un GPT con azioni personalizzate, il selettore del modello mostra solo i modelli non Pro che supportano le azioni.

Migrazione ai plugin

Le azioni personalizzate non vengono trasferite automaticamente quando un GPT viene migrato a un plugin. Configura e testa un'integrazione sostitutiva prima di affidarti al plugin. Le istruzioni riportate di seguito continuano a valere per i GPT esistenti non ancora migrati che hai il permesso di modificare. Per indicazioni sulla migrazione, consulta: Domande frequenti sul ritiro e sulla migrazione dei GPT personalizzati.

Creare un'azione

Nell'editor dei GPT, vai alla sezione Azioni e seleziona Crea nuova azione.

Potrai quindi configurare il modo in cui il tuo GPT si connette a un'API esterna e la utilizza.

Dopo aver configurato un'azione, testala in Anteprima per verificare che funzioni come previsto.

Autenticazione

L’autenticazione controlla il modo in cui il tuo GPT si connette a un’API esterna.

Opzioni disponibili:

  • Nessuna: non è richiesta alcuna autenticazione

  • Chiave API: usa una chiave segreta per autorizzare le richieste

  • OAuth: usa l’accesso dell’utente per l’accesso basato su account

Chiave API

Usa l’autenticazione con chiave API per l’accesso server-to-server. Può essere configurata come:

  • Basic

  • Bearer

  • Intestazione personalizzata

OAuth

Usa OAuth quando le azioni richiedono account utente. OAuth richiede:

  • ID client e segreto client

  • URL di autorizzazione e URL token

  • Ambito e metodo di scambio dei token

L’editor fornisce un URL di callback per completare il flusso OAuth.

Schema

Lo schema definisce cosa può fare la tua API. Indica a ChatGPT:

  • Quale server chiamare

  • Quali endpoint sono disponibili

  • Quali parametri accettano

  • Come viene identificata ogni azione (ID operazione)

Lo schema deve essere fornito come specifica OpenAPI in JSON o YAML.

Aggiungi uno schema

Puoi aggiungere uno schema in tre modi:

  • Incollalo direttamente nell’editor

  • Importalo da un URL

  • Parti da un esempio integrato:

    • Meteo (JSON)

    • Negozio di animali (YAML)

    • Modello vuoto

Se lo schema è valido, l’editor mostra le azioni rilevate. Se non è valido, vengono visualizzati gli errori di convalida.

Restrizioni dell’area di lavoro (Enterprise ed Edu)

Se vedi il messaggio:


«Nessun dominio è consentito dalle impostazioni della tua area di lavoro».

Significa che le azioni sono limitate dalle impostazioni della tua area di lavoro.

  • Gli amministratori possono consentire tutti i domini o limitare le azioni ai domini approvati.

  • Se non è consentito alcun dominio, non puoi usare le azioni.

Per i controlli a livello di area di lavoro sulle azioni e sulle restrizioni dei domini, vedi: Gestione dell’accesso ai GPT nelle aree di lavoro Enterprise ed Edu.

Privacy e controlli utente

  • Ogni azione può includere un URL dell’Informativa sulla privacy.

  • I GPT pubblici (link o GPT Store) con azioni devono includere un URL valido dell’informativa sulla privacy.

  • Agli utenti potrebbe essere chiesto di approvare le azioni prima che vengano eseguite.

  • Per le azioni OAuth, gli utenti possono rivedere e gestire gli account connessi.

Aiuto aggiuntivo

Per assistenza nella scrittura o nel debug delle azioni, usa l’ActionsGPT ufficiale.

Questo articolo è stato utile?