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: 17 hours ago

Prevediamo di ritirare i GPT personalizzati e di aiutarti a sviluppare ulteriormente i flussi di lavoro che hai già creato. Invece dei GPT personalizzati, ti consigliamo di trasferire i tuoi flussi di lavoro nei plugin. I plugin consentono di combinare istruzioni riutilizzabili e app connesse, affinché le tue indicazioni possano operare insieme agli strumenti e alle informazioni necessari per un'attività. È previsto un processo di migrazione per aiutarti a effettuare il passaggio.

Per le aree di lavoro Enterprise interessate, il ritiro è previsto per l'11 dicembre 2026. I GPT esistenti resteranno utilizzabili fino ad allora. Inizia a preparare i flussi di lavoro che vuoi conservare per la migrazione ai plugin. L'esperienza di migrazione è prevista per il 17 settembre 2026 e potrebbe non essere disponibile contemporaneamente per tutti gli account o tutte le aree di lavoro. Prima di effettuare il passaggio, esegui la migrazione, testa la soluzione sostitutiva e verificane gli accessi.

Gli altri piani dovrebbero seguire la stessa tempistica: consulta gli avvisi relativi al tuo account o alla tua area di lavoro non appena disponibili. Sono inclusi anche i GPT pubblici creati nelle aree di lavoro Enterprise interessate, persino quando vengono utilizzati da un altro piano. Scopri di più.

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.

Crea un’azione

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

Configurerai quindi il modo in cui il tuo GPT si connette a un’API esterna e la usa.

Dopo aver configurato un’azione, testala in Anteprima per confermare che si comporti 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?