Comment construire une GPT personnalisée d’OpenAI avec une API tiers

Avec l’avènement de Les Grands Modèles de Langue (GML), l’interface de conversation a très rapidement gagné en popularité. Vous demandez simplement ce que vous cherchez, et ChatGPT produit une sortie. De plus, le modèle peut effectuer des actions en réponse à votre ordre ou à votre question et vous présenter les résultats. Cela a ouvert une immense opportunité pour créer une nouvelle classe d’interface où l’unique entrée est les mots de l’utilisateur — écrits ou prononcés.

C’est fantastique, comme vous pouvez imaginer les possibilités sont sans nombre. Ce que nous avons besoin est que les GML aient accès à autant de actions complexes et du monde réel que possible, qu’elles puissent ensuite appeler appropriément. C’est à cet endroit que les API de tierces parties entrent en jeu.

API des plateformes

Choisissez n’importe quelle populaire service internet et imaginez-y une API qui pourrait être invoquée pour effectuer les tâches habituellement effectuées par ce service. Chaque service fournit généralement une belle interface graphique (IG) — soit en tant que web app ou application mobile — et les utilisateurs se connectent pour l’utiliser. Mais à la place, imaginez que l’utilisateur n’a qu’à demander à une seule entité — l’interface de commande de la GML — par des commandes de texte ou audio ? Vous n’aurez pas besoin d’aucune autre interface.

C’est intéressant parce que maintenant, vous pouvez construire une version personnalisée de GPT qui sait comment effectuer certaines actions avec extrême habileté, en devenant un spécialiste en se rendant compte de l’existence de telles actions. Elle connecte l’intention de l’utilisateur avec l’action souhaitée et partage les résultats (sortie) de l’action effectuée.

Spécification YAML OpenAPI

Dans le cas de Custom GPT, cela est réalisé en enregistrant n’importe quelle API tiers en utilisant leur spécification OpenAPI. Par exemple, voici une spécification OpenAPI d’une plateforme pour le design intérieur assisté par AI. L’API permet de créer un nouveau design intérieur en utilisant juste une photo de la pièce. Bien que la plateforme offre sa propre application web où les utilisateurs peuvent télécharger la photo de la pièce et sélectionner des styles de design intérieur pour générer un nouveau design intérieur, vous pouvez amener cette fonctionnalité sur votre propre plateforme en la déployant en tant que Custom GPT.

Commençons à construire un Custom GPT avec cette API comme exemple. Vous pouvez embarquer n’importe quelle API tiers avec sa spécification OpenAPI. Il existe également des outils disponibles qui vous aideront à construire une spécification OpenAPI pour vos propres API de plateforme. Je pense qu’il s’agit d’une excellente manière de distribuer votre propre API sur plus de plateformes.

Obtenez l’API de plateforme

La plupart des plateformes SaaS offrent leur API pour que les développeurs puissent construire leurs applications. Elles publient également une spécification OpenAPI. Téléchargez la spécification. C’est un fichier YAML qui ressemble à :

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).

    ### Démarrage

    - **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).
  
    ### Connectez-vous à [Decor8 AI](https://prod-app.decor8.ai) et cliquez sur API dans le menu latéral de gauche

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

    ### Cliquez sur Générer une clé API
    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_2.jpg?raw=true)

    ### Testez la clé API 
    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.

Remarque : ceci n’est pas une spécification OpenAPI complète mais seulement quelques lignes du fichier pour vous donner une idée.

Ouvrir AI Custom GPT

Pour créer un Custom GPT, vous avez besoin d’un abonnement Open AI. Allez sur https://chat.openai.com/ et cliquez sur votre photo de profil dans le coin supérieur droit de la page.

Cliquez sur le menu « Mes GPTs ». Ici, nous créerons un nouveau Custom GPT (j’ai déjà créé un Custom GPT, et donc vous le voyez déjà sur cette page).

Cliquez sur « Créer un GPT ». Vous voyez alors un formulaire pour définir les propriétés de ce Custom GPT.

Cliquez sur l’onglet « Configurer ».

Fournissez le Logo, Nom, Description et les instructions initiales.

Dans les instructions, il est important de définir les règles de base. Par exemple, vous pourriez définir ce que le GPT doit faire quand les utilisateurs posent des questions en dehors des domaines de compétence du GPT. Le GPT pourrait dire « Je ne sais pas » ou informer l’utilisateur de ce qu’il peut faire pour eux. Cela est très utile pour fixer des attentes utilisateur correctes.

Défilez vers le bas de la section « Actions ».

Une action est la manière dont le GPT saura « quoi invoquer » lorsque certaines conditions sont remplies. Chaque appel API pourrait devenir une action. C’est ici que nous aurons besoin du fichier YAML OpenAPI spec que nous avons téléchargé plus tôt.

• Authentification : Choisissez Clé API

• Choisissez le Type d’authentification : Jeton

Obtenir la clé API

Typiquement, chaque API de plateforme fournit une méthode d’authentification qui implique l’utilisation d’une clé API. Obtenez la clé en vous connectant à cette plateforme. Par exemple, dans le cas de Decor8 AI, connectez-vous à https://prod-app.decor8.ai et cliquez sur le menu API. Ici, vous pouvez créer une clé API. Copiez-collez la clé dans le popup Authentication.

Ensuite, copiez-collez le contenu du fichier YAML de la spécification OpenAPI dans la zone de texte « Schema ».

Si la spécification est bien formatée, vous verrez une liste des appels API décrits dans la spécification. Vous pouvez maintenant les tester individuellement. Si vous cliquez sur le bouton « Test », il essaiera d’invoquer l’API avec les paramètres d’entrée corrects comme décrit dans la spécification. Si l’API a besoin de récupérer la valeur du paramètre d’entrée, elle vous le demandera.

Dans le cas de l’API Decor8 AI, testons l’API « checkAuthentication » (qui n’est pas nécessaire pour GPT lui-même). Son invocation réussie signifie que tout a été correctement configuré entre Custom GPT et la plateforme cible (Decor8 AI, dans ce cas).

Vous pouvez tester les API restantes une par une pour vous assurer que GPT a bien compris les actions. Ce que vous allez vérifier, c’est si GPT vous demande des informations supplémentaires si elles n’ont pas été fournies lorsqu’il exécute l’action. C’est la partie la plus intéressante de Custom GPT : il « sait » comment appeler l’API et construire les paramètres d’entrée selon la spécification et si des entrées manquent, demander à l’utilisateur. Voici à quoi ressemble l’interface utilisateur conversationnelle :

ici, je l’ai demandé de concevoir l’intérieur d’une chambre à coucher avec un style d’intérieur rustique. C’est pour invoquer l’une des appels d’API qui, en recevant une photo d’une pièce, le type de pièce et le style de design, peut générer un nouvel intérieur et retourner une image.

Voici l’image originale d’une pièce vide (à partir de l’URL mentionnée dans la capture d’écran ci-dessus):

Si je clique sur « Afficher le design de chambre à coucher rustique », nous voyons:

Maintenant, vous pouvez tester d’autres API pour vous assurer que tout fonctionne comme prévu.

Créer et publier le GPT personnalisé

Assurez-vous de revoir toutes les propriétés pour ce GPT personnalisé. Voici un exemple de diverses propriétés de configuration que j’ai définies pour mon GPT personnalisé et je pense qu’il est prêt à être publié.

Cliquez sur le bouton « Créer » ou « Mettre à jour » en haut à droite et votre GPT est en direct sur Internet.

Par exemple, mon GPT personnalisé est maintenant en direct. (Vous devez vous connecter à OpenAI pour y accéder.)

Fin du tutoriel!

Construire un GPT personnalisé avec une API tiers comme Decor8 AI est assez simple. Vous pouvez construire votre GPT et ajouter les meilleures plateformes du marché. Cela rendra votre GPT plus avancé et sophistiqué, ce qui pourra faire beaucoup d’activités utiles.

J’espère que vous avez apprécié ce tutoriel, si vous avez des questions ou des commentaires, laissez-les dans la section des commentaires.