Actions et API dans les Custom GPTs : schémas et webhooks

1Le fonctionnement des Actions OpenAPI et le format JSON Schema

Le fonctionnement des Actions OpenAPI et le format JSON Schema dotent ChatGPT de bras opérationnels pour interagir avec le monde extérieur. Lorsqu'un utilisateur pose une question exigeant des données fraîches, le modèle analyse le schéma OpenAPI fourni, identifie la route adaptée, formule la requête HTTP au format JSON et envoie l'appel.

Dès réception de la réponse du serveur tiers, ChatGPT extrait les champs utiles et les restitue dans un langage naturel impeccable. Pour sécuriser ce pont technique, OpenAI exige que chaque appel soit validé par l'utilisateur ou autorisé de manière permanente pour le domaine concerné.

Touchez pour agrandir

2Connecter un GPT au gestionnaire de tickets d'assistance interne

Connecter un GPT au gestionnaire de tickets d'assistance interne permet aux collaborateurs de vérifier le statut de leurs demandes sans solliciter l'équipe informatique par message direct.

Un collaborateur demande : « Où en est mon ticket concernant le remplacement de mon écran ? ».

Schéma d'action minimal (YAML).

openapi: 3.0.0
info:
  title: API Helpdesk Interne
  version: 1.0.0
servers:
  - url: https://support.novatech-sas.exemple.fr/api
paths:
  /tickets:
    get:
      operationId: chercherTickets
      summary: Recherche les tickets d'un collaborateur
      parameters:
        - name: email
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Liste des tickets trouvés
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                    statut:
                      type: string
                    description:
                      type: string

Ce qui change. Le GPT interroge directement la base de support en temps réel et annonce : « Votre ticket #1482 est actuellement en cours de préparation par l'équipe logistique ».

3Rédiger et tester un schéma d'action d'interrogation simple

Rédiger et tester un schéma d'action d'interrogation simple vous donne les clés pour concevoir des passerelles entre ChatGPT et vos outils métiers en respectant les principes du Model Context Protocol (MCP).

Pour vous exercer sans exposer de système de production, voici la spécification d'un annuaire interne d'entreprise (société fictive NovaTech SAS) :

[Spécification API Annuaire Interne - NovaTech SAS (Environnement de test)]
GET https://annuaire.novatech-sas.exemple.fr/api/collaborateurs?nom={nom}
Réponse JSON type :
[
  {"id": 412, "nom": "Sophie Martin", "service": "Expérience Client & Opérations", "email": "s.martin@exemple.fr", "bureau": "B-204"}
]

Le bouton « Charger l'exercice » du composeur préremplit l'objectif avec le prompt de départ faible :

« Interroge l'API interne pour afficher le statut des tickets ouverts. »

À partir de ce point de départ, complétez le prompt avec le composeur pour concevoir l'assistant d'annuaire. Définissez le rôle, configurez le schéma OpenAPI en lecture seule (GET /collaborateurs), imposez l'extraction ciblée (nom, service, bureau) et intégrez la règle de sécurité MCP essentielle : toute action d'écriture ou de modification (POST, DELETE) exige impérativement une validation humaine explicite (Human-in-the-Loop) avant d'être exécutée.

Collez votre schéma dans l'onglet « Actions » de l'éditeur de GPT et cliquez sur le bouton « Tester » dans le panneau de prévisualisation.

Grille d'auto-évaluation : (a) le schéma OpenAPI est validé sans erreur de syntaxe ; (b) la méthode GET est reconnue sans paramètre destructif ; (c) l'appel de test renvoie la structure JSON conforme.

Ouvrir le composeur de prompt