Panoramica

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

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

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

Limitazioni

Se la tua area di lavoro consente zero domini di azione, le azioni personalizzate dei GPT non possono essere eseguite perché nessun dominio di azione può superare i controlli della allowlist. Questo non significa necessariamente che tutta la visibilità o l’accesso ai GPT siano bloccati.

Le azioni non sono disponibili in modalità Pro: creare un GPT con azioni personalizzate farà sì che al suo interno siano disponibili per la selezione solo i modelli Instant e Thinking.

Crea un’azione

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

Quindi configurerai come il tuo GPT si collega a un’API esterna e la utilizza.

Dopo aver configurato un’azione, testala in Anteprima per confermare che si comporti come previsto.

Autenticazione

L’autenticazione controlla come il tuo GPT si collega a un’API esterna.

Opzioni disponibili:

• Nessuna: Nessuna autenticazione richiesta

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

• OAuth: Usa l’accesso dell’utente per un accesso basato sull’account

Chiave API

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

• Basic

• Bearer

• Header personalizzato

OAuth

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

• Client ID e Client Secret

• Authorization URL e Token URL

• Scope e metodo di scambio del token

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

Schema

Lo schema definisce cosa può fare la tua API. Comunica 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.

Aggiungere uno schema

Puoi aggiungere uno schema in tre modi:

• Incollandolo direttamente nell’editor

• Importandolo da un URL

• Partendo 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.

Limitazioni 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 nessun dominio è consentito, non puoi usare le azioni.

Per i controlli a livello di area di lavoro su azioni e limitazioni dei domini, vedi: Gestire l’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 può essere chiesto di approvare le azioni prima che vengano eseguite.

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

Ulteriore assistenza

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