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.