Connecter Votre GPT à des API Externes

Dépasser les limites du GPT autonome

Jusqu’ici, votre GPT fonctionne avec ses instructions et ses fichiers. C’est déjà puissant, mais il reste isolé : il ne peut pas consulter votre CRM en temps réel, créer un événement dans votre calendrier ou interroger votre base de données.

Les Actions changent la donne. Elles permettent à votre GPT d’appeler des API externes pour lire et écrire des données dans vos outils.

Qu’est-ce qu’une Action ?

Une Action est une connexion entre votre GPT et un service externe via son API. Concrètement :

1. L’utilisateur pose une question ou donne une instruction
2. Le GPT identifie qu’il a besoin de données externes
3. Il appelle l’API du service concerné
4. Il reçoit la réponse et l’intègre dans sa réponse à l’utilisateur

Tout cela se passe de manière transparente pour l’utilisateur.

Le schéma OpenAPI

Pour connecter une API, vous devez fournir un schéma OpenAPI (anciennement Swagger). C’est un fichier JSON ou YAML qui décrit :

• Les endpoints : les URLs de l’API que votre GPT peut appeler
• Les méthodes : GET (lire), POST (créer), PUT (modifier), DELETE (supprimer)
• Les paramètres : les données attendues par chaque endpoint
• Les réponses : le format des données renvoyées

Exemple de schéma simplifié

openapi: 3.1.0
info:
  title: API Météo
  version: 1.0.0
servers:
  - url: https://api.meteo-exemple.com
paths:
  /previsions:
    get:
      operationId: obtenirPrevisions
      summary: Obtenir les prévisions météo pour une ville
      parameters:
        - name: ville
          in: query
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Prévisions météo

Où trouver le schéma ?

• Documentation de l’API : beaucoup de services publient leur schéma OpenAPI
• Génération automatique : des outils comme Swagger Editor ou ChatGPT lui-même peuvent vous aider à le créer
• Collections Postman : exportables en format OpenAPI

Configurer une Action dans le GPT Builder

1. Ouvrez l’onglet Configurer de votre GPT
2. Descendez jusqu’à Actions et cliquez sur Créer une action
3. Collez votre schéma OpenAPI dans le champ prévu
4. Configurez l’authentification (leçon suivante)
5. Testez l’action avec le panneau de prévisualisation

Bonnes pratiques pour le schéma

• Donnez des noms explicites aux operationId (le GPT les utilise pour décider quelle action appeler)
• Écrivez des descriptions claires pour chaque endpoint et paramètre
• Limitez-vous aux endpoints nécessaires — n’exposez pas toute l’API si votre GPT n’a besoin que de 2-3 routes

Mise en pratique

Connectez votre GPT à une API publique pour vous entraîner :

1. Choisissez une API gratuite (météo, taux de change, actualités)
2. Récupérez ou créez le schéma OpenAPI
3. Ajoutez-le comme Action dans votre GPT
4. Dans les instructions, précisez quand utiliser cette action : « Quand l’utilisateur demande la météo, utilise l’action obtenirPrevisions »
5. Testez avec plusieurs requêtes

Erreurs courantes

• Un schéma mal formaté : une virgule manquante dans le JSON bloque tout. Validez votre schéma avec un outil comme Swagger Editor avant de le coller.
• Des descriptions absentes : sans description, le GPT ne sait pas quand utiliser une action. Décrivez chaque endpoint en langage clair.
• Trop d’endpoints : chaque action disponible prend de la place dans le contexte du GPT. Exposez uniquement ce qui est nécessaire.
• Ignorer les erreurs de l’API : dans vos instructions, prévoyez le comportement du GPT quand l’API renvoie une erreur (« Si l’API ne répond pas, dis à l’utilisateur de réessayer plus tard »).
• Ne pas tester en conditions réelles : le panneau de prévisualisation n’est pas suffisant. Testez avec des données réelles.

Points clés

• Les Actions connectent votre GPT à des services externes via leurs API
• Vous devez fournir un schéma OpenAPI décrivant les endpoints disponibles
• Les descriptions dans le schéma sont essentielles — le GPT s’en sert pour décider quelle action appeler
• Commencez par une API publique gratuite pour vous familiariser avec le processus
• Limitez les endpoints exposés au strict nécessaire pour votre cas d’usage