Come costruire un OpenAI Personalizzato GPT con un’API di terze parti

Con l’avvento di i grandi modelli di linguaggio (LLM), l’interfaccia conversazionale è diventata molto popolare. Si può semplicemente chiedere ciò che si cerca, e ChatGPT produce un output. Inoltre, il modello può eseguire azioni in risposta al comando o alla domanda dell’utente e presentare il risultato. Questo ha aperto una nuova opportunità per costruire una nuova interfaccia dove l’unico input è le parole dell’utente — scritte o pronunciate.

Questo è fantastico, come potete immaginare le possibilità infinite. Ciò che serve è per i LLM di avere accesso a quanti più comportamenti complessi, reali possibili, che poi possano richiamare opportunamente. Ecco dove entra in gioco l’API di terze parti.

APIs delle piattaforme

Scegliete qualsiasi servizio internet popolare e immaginate una API per esso che possa essere richiamata per eseguire le attività solitamente eseguite da quel servizio. Ogni servizio offre solitamente una grafica utente (GUI) — sia come app web che mobile — e gli utenti devono accedere per utilizzarlo. Ma invece, cosa succederebbe se l’utente avesse solo bisogno di chiedere ad un’unica entità — l’interfaccia di comando dell’LLM — attraverso comandi testuali o audio? Non sarebbe necessaria alcuna altra interfaccia.

È interessante perché ora è possibile costruire una versione personalizzata di GPT che sa come eseguire certi comportamenti con estrema precisione, diventando unspecialista sapendo della loro esistenza. Connette l’intenzione dell’utente con l’azione desiderata e condivide i risultati (output) dell’azione eseguita.

Specifica OpenAPI YAML

Nel caso di Custom GPT, questo viene realizzato registrando qualsiasi API di terze parti utilizzando la loro specifica OpenAPI. Ad esempio, ecco una specifica OpenAPI di una piattaforma per il design d’interni AI. L’API ti permette di creare un nuovo design d’interni usando solo una foto della stanza. Mentre la piattaforma offre la propria applicazione web dove gli utenti possono caricare la foto della stanza e selezionare stili di design d’interni per generare un nuovo design, è possibile portare questa funzionalità sulla tua piattaforma distribuendola come un GPT personalizzato.

Costruiamo un GPT personalizzato con questa API come esempio. Puoi integrare qualsiasi API di terze parti con la sua specifica OpenAPI. Ci sono anche strumenti disponibili che ti aiuteranno a costruire una specifica OpenAPI per le API della tua piattaforma. Credo che sia un ottimo modo per distribuire la tua API su piattaforme più ampie.

Ottieni l’API della Piattaforma

La maggior parte delle piattaforme SaaS offre la propria API affinché gli sviluppatori possano costruire le loro app. Pubblicano anche una specifica OpenAPI. Scarica la specifica. È un file YAML che appare come:

openapi: 3.1.0
info:
  title: Decor8AI Virtual Staging & Interior Design API
  version: "1.0"
  description: >
    Decor8 AI is a state-of-the-art virtual staging solution designed for realtors and real estate app developers. It provides a suite of customization options to create and visualize appealing interiors from empty spaces. With its focus on enhancing marketability, it's an essential tool for showcasing property potential in a compelling way.
    Please reach out to [Decor8 AI Team](mailto:[email protected]) with questions or suggestions.

    Additional license information can be found [here](https://github.com/immex-tech/decor8ai-sdk/blob/main/API_LICENSE_NOTICE).

    ### Iniziare

    - **Authentication**: Each API request requires two headers:
      - `Content-Type: application/json`
      - `Authorization: Bearer `

    - **API Key**: Get your `` from your account at [prod-app.decor8.ai](https://prod-app.decor8.ai).
  
    ### Accedi a [Decor8 AI](https://prod-app.decor8.ai) e clicca su API dal menu laterale sinistro

    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_1.jpg?raw=true)

    ### Clicca su Genera API Key
    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_2.jpg?raw=true)

    ### Testa la Chiave AI 
    Once you have the key, run simple curl command to test the key.

    ```
    curl -X GET "https://api.decor8.ai/speak_friend_and_enter" -H "Authorization: Bearer "
    ``` 

  license:
    name: Decor8AI SDK License
    url: https://github.com/immex-tech/decor8ai-sdk/blob/main/LICENSE
servers:
  - url: https://api.decor8.ai
    description: Base API URL for all endpoints.

Nota: questa non è una specifica OpenAPI completa ma solo alcune righe del file per darti un’idea.

Open AI Custom GPT

Hai bisogno di un abbonamento Open AI per creare un Custom GPT. Vai su https://chat.openai.com/ e clicca sulla tua immagine del profilo nell’angolo in alto a destra della pagina. 

Clicca sul menu “My GPTs”. Qui, creeremo un nuovo Custom GPT (ne avevo già creato uno e quindi lo vedi già su questa pagina).

Clicca su “Create a GPT”. Ti viene presentato un modulo per definire le proprietà di questo GPT personalizzato.

Clicca sulla scheda “Configure”.

Fornisci il Logo, il Nome, la Descrizione e le istruzioni iniziali.

Nelle istruzioni, è importante definire le regole di base. Ad esempio, vorresti definire cosa dovrebbe fare GPT quando gli utenti fanno domande al di fuori dell’esperienza di GPT. GPT potrebbe dire, “Non lo so,” o far sapere all’utente cosa può fare per loro. Questo è molto utile per impostare le corrette aspettative degli utenti.

Scorri verso il basso nella sezione “Actions”.

Un’azione è come GPT saprà “cosa invocare” quando certe condizioni sono soddisfatte. Ognuna delle chiamate API potrebbe diventare un’azione. Qui è dove avremo bisogno del file YAML della specifica OpenAPI che abbiamo scaricato in precedenza. 

• Autenticazione: Scegli API Key

• Scegli Tipo di Autenticazione: Bearer

Ottieni la Chiave API

Tipicamente, ogni API di una piattaforma fornisce un metodo di autenticazione che prevede l’uso di una chiave API. Ottieni la chiave accedendo a quella piattaforma. Ad esempio, nel caso di Decor8 AI, effettua il login su https://prod-app.decor8.ai e clicca sul menu API. Qui puoi creare una chiave API. Copia e incolla la chiave nel popup Autenticazione.

Successivamente, copia e incolla il contenuto del file YAML della specifica OpenAPI nella casella di testo “Schema”.

Se la specifica è ben formattata, vedrai un elenco delle chiamate API descritte nella specifica. Ora puoi testarle singolarmente. Se clicchi sul pulsante “Test”, verrà tentata l’invocazione dell’API con i parametri di input corretti, come descritto nella specifica. Se ha bisogno di ottenere il valore di un parametro di input, te lo chiederà.

Nel caso dell’API di Decor8 AI, testiamo l’API “checkAuthentication” (che non è necessaria per GPT stesso). La sua invocazione con successo significa che tutto è stato configurato correttamente tra Custom GPT e la piattaforma di destinazione (in questo caso, Decor8 AI).

Puoi testare le API rimanenti una per una per garantire che GPT abbia compreso correttamente le azioni. Ciò che verificherai è se GPT ti chiede input aggiuntivi nel caso non siano stati forniti quando esegue l’azione. Questa è la parte più interessante di Custom GPT: “sa” come chiamare l’API e costruire i parametri di input secondo la specifica, e se mancano degli input, chiede all’utente. Ecco come appare l’interfaccia utente conversazionale:

Qui, ho chiesto di progettare un interno per camera da letto con uno stile di interni rustici. Questo è per richiamare una delle API che, data una foto di una stanza, il tipo di stanza e lo stile di design, genera un nuovo progetto di interni e restituisce un’immagine.

Ecco l’immagine originale di una stanza vuota (da URL come menzionato nella screenshot soprastante):

Se clicco sul “Visualizza progetto camera da letto rustica”, vediamo:

Adesso, puoi testare altre API per assicurarti che tutto funzioni come ti aspetti.

Crea e pubblica la personalizzazione GPT

Assicurati di rivedere tutte le proprietà per questa personalizzazione GPT. Ecco un esempio di vari attributi di configurazione che ho impostato per la mia personalizzazione GPT e penso sia pronto per essere pubblicato.

Clicca sul pulsante “Crea” o “Aggiorna” in alto a destra e il tuo GPT è in vita sul web.

Ad esempio, la mia personalizzazione GPT ora è in vita. (Devi accedere a OpenAI per accedervi.)

Chiudi!

Creare personalizzazioni GPT con API di terze parti come Decor8 AI è piuttosto semplice. Puoi creare il tuo GPT e aggiungere piattaforme di eccellenza. Questo renderà il tuo GPT un chatbot più avanzato e sofisticato che può fare molte attività utili.

Spero tu abbia apprezzato questo tutorial, se hai domande o feedback, lasciali nella sezione dei commenti.