ArticlesParcours de formation

Skills B-Coder : apprendre à l'agent à appeler un service extérieur, sans écrire une ligne de code

Comment créer, générer et utiliser des skills dans B-Coder : le mode Hybride, les champs, les paramètres, les clés d'API et les précautions à prendre.

Par l'équipe bmaster

· 20 min de lecture

1. Qu'est-ce qu'un skill ?

Quand vous travaillez avec l'agent du chat B-Coder, il sait lire et modifier votre projet. Mais il ne connaît pas vos outils : votre canal Slack, votre service d'envoi d'e-mails, votre tableur en ligne, votre outil de devis. Un skill comble ce manque. C'est une connexion vers un service extérieur, définie une fois, que l'agent peut ensuite appeler quand vous le lui demandez.

Concrètement, un skill tient en quelques champs : un nom, une description (c'est elle qui dit à l'agent quand s'en servir), une méthode (lire, envoyer, modifier, supprimer), une adresse et, si besoin, un corps à envoyer. L'agent voit chaque skill comme un outil à part entière.

Vous dites à l'agentLe skill qu'il utilise
« Préviens l'équipe sur Slack que le site est en ligne »Un skill qui envoie un message dans un canal
« Crée un ticket pour ce bug »Un skill qui appelle votre outil de suivi
« Déclenche mon scénario d'automatisation »Un skill qui appelle l'adresse de son déclencheur (webhook)
« Quelle est la météo à Genève ? »Un skill qui interroge un service météo
À retenir : un skill est une délégation. Vous donnez à l'agent le droit d'agir sur un service extérieur. Plus ce service est puissant (envoyer, supprimer, payer), plus la description et les protections comptent.

2. Ce qu'un skill n'est pas

  • Ce n'est pas du code de votre site. Un skill ne s'exécute pas quand un visiteur utilise votre site publié. Il aide l'agent pendant que vous travaillez dans le Studio.
  • Ce n'est pas une automatisation. Une automatisation B-Coder s'exécute à heure fixe sur les données de votre base, et elle n'a pas accès aux skills (voir Automatisation avec l'IA).
  • Ce n'est pas une fonction intégrée. Les comptes, le paiement, les e-mails et les réservations d'un site se règlent autrement : voir Réservation en ligne, comptes, paiement et e-mails du site.
  • Ce n'est pas une connexion à votre base de données. Pour une base externe, voir Connecter Supabase.

3. Dev, Operator, Hybrid : le mode qui change tout

Le chat B-Coder a trois modes, choisis avec l'icône de robot en bas du chat (l'infobulle indique « Mode : dev »). Ils ne donnent pas à l'agent les mêmes pouvoirs.

ModeCe que fait l'agentSkills
Dev (par défaut)Construit et modifie votre site : fichiers, pages, base de développementJamais appelés
OperatorGère les données de votre application : consulter, interrogerJamais appelés
HybridLes deux à la foisAppelés
Le piège le plus fréquent : vous créez un skill, vous le demandez à l'agent… et rien. Vérifiez le mode. Tant que vous êtes en Dev ou en Operator, le skill reste enregistré mais l'agent ne le voit pas. La fenêtre le dit d'ailleurs : « Outils HTTP que l'agent peut appeler en mode Hybride ».
  • Passez en Hybrid avant de demander l'utilisation d'un skill.
  • Revenez en Dev pour un travail de construction pur.
  • Le mode ne change pas vos données. Il change seulement les outils proposés à l'agent. Pour le mode Production, voir Modifier un site web avec le chat et Visual Edit.

4. Créer un skill, pas à pas

  1. 1Ouvrez votre projet dans le Studio.
  2. 2Cliquez sur l'icône « Skills » (un livre) au-dessus de la zone de saisie du chat. Elle est grisée si vous n'êtes pas propriétaire : « Réservé au propriétaire du projet ».
  3. 3Une liste s'ouvre. Vide, elle affiche « Aucun skill configuré. » et « Comment ça marche ? ». Cliquez sur « Créer mon premier skill » (ou « Nouveau skill » s'il y en a déjà).
  4. 4Deux voies : décrire ce que vous voulez et laisser l'IA remplir le formulaire (section 5), ou cliquer sur « Configurer manuellement ».
  5. 5Remplissez ou relisez le formulaire (section 6).
  6. 6Cliquez sur « Créer ». Le message « Skill créé » apparaît, et le skill s'ajoute à la liste.
  7. 7Vérifiez l'interrupteur du skill : il doit être actif.
  8. 8Passez en mode Hybrid et demandez à l'agent de l'utiliser.

5. Générer avec l'IA, et ce qu'il faut vérifier

Plutôt que de remplir chaque champ, décrivez le skill en une phrase, par exemple : « Un skill qui envoie un message Slack dans un canal ». L'IA propose un nom, une description, une méthode, une adresse et un modèle de corps, puis vous laisse relire le formulaire avant d'enregistrer.

Relisez toujours l'adresse. L'IA rédige une adresse plausible, mais elle peut l'inventer ou la prendre dans une ancienne version du service. Ouvrez la documentation du service, comparez l'adresse, la méthode et le corps attendu, puis corrigez. Un skill qui pointe vers une adresse fausse échoue ; un skill qui pointe vers la mauvaise action peut faire un dégât.
  • Soyez précis dans votre description : le service, l'action, les informations à transmettre.
  • Ne collez pas de clé secrète dans la description : elle serait envoyée à l'IA.
  • Le résultat n'est qu'une proposition : rien n'est enregistré tant que vous n'avez pas cliqué sur « Créer ».

6. Les champs, un par un

ChampÀ quoi il sertConseil
Nom de l'outilLe nom sous lequel l'agent connaît le skillMinuscules et underscores seulement : envoyer_message_slack. Deux noms qui ne diffèrent que par la ponctuation donnent le même outil
DescriptionDit à l'agent quand et comment se servir du skillUne phrase claire : « Envoie un message texte dans le canal Slack de l'équipe. »
MéthodeLe type d'appel : GET (lire), POST (envoyer), PUT et PATCH (modifier), DELETE (supprimer)Choisissez celle que demande la documentation du service
URLL'adresse du serviceComplète, avec https. Des paramètres entre accolades simples peuvent s'y trouver
En-têtes (options avancées)Informations jointes à l'appel : type de contenu, clé d'accèsVoir la section 8
Template de corps (JSON)Ce qui est envoyé avec l'appelUtilisez des paramètres {param} : l'agent les remplit
Connecteur OAuthJoint automatiquement l'accès d'un compte connecté« Aucun connecteur (auth manuelle) » si vous gérez l'accès vous-même
  • La description est le champ le plus important. C'est elle qui décide si l'agent pense à utiliser le skill.
  • Pour une lecture simple (GET), le corps reste vide.
  • L'option « Importer OpenAPI » est désactivée pour le moment : un skill se crée un par un.

7. Les paramètres entre accolades

Un skill est rarement identique à chaque appel : la ville de la météo, le texte du message, le numéro du ticket changent. Vous le dites avec un paramètre entre accolades simples, dans l'adresse ou dans le corps. L'agent remplit chaque paramètre au moment de l'appel.

OùExempleCe que l'agent remplit
Dans l'adressehttps://exemple.com/meteo?ville={ville}La ville
Dans le corps{"text": "{message}"}Le texte du message
Dans les deuxAdresse avec {id}, corps avec {statut}L'identifiant et le statut
  • Une seule accolade de chaque côté : {ville}. Des doubles accolades ({{ville}}) ne sont pas comprises et donnent une adresse incorrecte.
  • Des noms simples, sans accent ni espace : {ville}, {message}, {numero_ticket}.
  • Chaque paramètre est obligatoire : l'agent doit lui donner une valeur.
  • Les valeurs sont du texte. Un nombre est transmis sous forme de texte.

8. Clés d'API, connecteurs : que mettre où

La plupart des services demandent une clé ou un accès. Trois façons de la fournir, avec leurs précautions.

FaçonCommentPrécaution
Dans les en-têtesUn en-tête « Authorization » avec votre cléLa clé est conservée avec le skill, et visible pour qui ouvre le skill : choisissez une clé à portée limitée
Avec un connecteurChoisir un compte connecté dans « Connecteur OAuth » : son accès est joint à chaque appelNe vaut que pour les services qui passent par ce compte
En paramètreMettre {cle} en en-tête : l'agent doit la fournirÀ éviter : la clé devrait être écrite dans le chat
Règle d'or : n'utilisez jamais une clé qui peut tout faire. Demandez au service une clé limitée : lecture seule, montant plafonné, une seule action. Si le skill est mal utilisé, les dégâts restent bornés. Et ne partagez pas le projet avec une personne qui ne doit pas voir cette clé.
  • Changez la clé si vous pensez qu'elle a fuité, puis modifiez le skill.
  • Ne mettez pas de clé dans la description ni dans un message du chat.
  • Les connecteurs proposés sont ceux de votre compte qui sont actifs : sans connecteur, la liste indique « Aucun connecteur ».

9. Utiliser un skill dans le chat

  1. 1Passez en mode Hybrid (icône de robot).
  2. 2Demandez en français, avec les informations que le skill attend : « Envoie un message à l'équipe : le site est en ligne. »
  3. 3L'agent choisit le skill d'après sa description, remplit les paramètres, et vous voyez « Skill [nom] » dans le chat.
  4. 4L'appel part des serveurs bmaster, pas de votre ordinateur.
  5. 5La réponse du service revient à l'agent : le code de statut (réussite ou erreur) et le début du contenu.
  6. 6L'agent vous explique le résultat. Vérifiez dans le service lui-même que l'action a bien eu lieu.
  • Pas de confirmation : l'appel part dès que l'agent le décide. Écrivez des demandes claires.
  • Une réponse trop longue est tronquée (environ trois mille caractères).
  • Une erreur du service est transmise à l'agent, qui peut essayer autrement ou vous en parler.

10. Tester, modifier, désactiver, supprimer

ActionComment
TesterEn mode Hybrid, demandez à l'agent d'utiliser le skill avec un cas sans conséquence (un canal de test, un service en lecture)
ModifierCliquez sur le skill dans la liste : le formulaire s'ouvre. « Enregistrer » → message « Skill mis à jour »
DésactiverInterrupteur du skill : il reste enregistré, mais l'agent ne le voit plus
SupprimerCorbeille : immédiat et sans confirmation
  • Testez toujours avec un cas sans conséquence avant de l'utiliser pour de vrai.
  • Désactivez plutôt que supprimez si vous hésitez : la suppression est immédiate.
  • Après une modification de la description, reposez la demande : l'agent relit la nouvelle description.

11. Exemples prêts à adapter

BesoinMéthodeAdresse (à adapter)Paramètres
Message dans un canal SlackPOSTL'adresse de webhook fournie par Slack{message}
Déclencher un scénario d'automatisation externePOSTL'adresse de déclenchement du scénario{donnees}
Créer un ticketPOSTL'adresse d'envoi de votre outil de suivi{titre}, {description}
Lire la météoGETL'adresse du service météo avec ?ville={ville}{ville}
Récupérer un client dans un outil externeGETL'adresse de l'outil avec /clients/{id}{id}

Bien décrire un skill

« Envoie un message texte dans le canal Slack de l'équipe. À utiliser quand l'utilisateur demande de prévenir l'équipe. Le paramètre message contient le texte à envoyer. »

Une bonne description dit ce que fait le skill, quand l'utiliser et ce que contient chaque paramètre.

12. Demander à l'agent de créer un skill

Vous pouvez aussi dire à l'agent : « Crée un skill qui envoie un message Slack. » Il enregistre le skill dans le projet. Trois précautions.

  • Le skill n'est utilisable qu'en mode Hybrid. L'agent peut le créer depuis le mode Dev, mais il ne pourra s'en servir qu'après passage en Hybrid.
  • Vérifiez les paramètres : l'agent peut les écrire avec des doubles accolades, que le système ne comprend pas. Ouvrez le skill dans la fenêtre « Skills » et remplacez-les par des accolades simples.
  • Relisez l'adresse et la description dans la fenêtre, comme pour un skill généré.

13. Ce que bmaster contrôle, ce qui reste à vous

bmasterVous
Refuse les adresses internes : réseau privé, machine locale, services internesChoisissez des services de confiance et des adresses publiques
Vérifie aussi les adresses vers lesquelles un service vous redirigeLisez la documentation du service et ses conditions
Limite l'ouverture de la fenêtre Skills au propriétaire du projetNe donnez pas la propriété d'un projet à quelqu'un que vous ne connaissez pas
Ne donne les skills à l'agent qu'en mode HybrideDécidez quand passer en Hybrid
—Choisissez des clés à portée limitée et changez-les en cas de doute
—Testez avec des cas sans conséquence avant de vous en servir en vrai
—Respectez les règles du service appelé (volumes, données personnelles)

Aucune protection n'est absolue. Pour la sécurité d'un projet en général, voir Cybersécurité d'un site créé avec l'IA.

14. Ce qui n'est pas possible

  • Importer un schéma OpenAPI : désactivé pour le moment.
  • Utiliser un skill en mode Dev ou Operator.
  • Utiliser un skill dans une automatisation B-Coder.
  • Appeler un service sur un réseau privé ou une adresse locale.
  • Faire appeler un skill par un visiteur de votre site.
  • Confirmer avant l'appel : il n'y a pas d'étape de confirmation.
  • Partager un skill entre deux projets : ils appartiennent à un projet.

15. Limites à connaître

  • Mode Hybride obligatoire.
  • Réservé au propriétaire du projet.
  • Aucune confirmation avant l'appel.
  • Réponse tronquée à environ trois mille caractères.
  • Suppression immédiate et sans confirmation.
  • Clés d'API conservées avec le skill.
  • Doubles accolades non comprises (le chat peut en écrire).
  • Deux noms trop proches donnent le même outil.
  • L'adresse proposée par l'IA peut être fausse.
  • Un skill n'ajoute rien au site publié.
  • Aucun résultat n'est garanti.

16. Messages courants

MessageSignification
« Aucun skill configuré. »La liste est vide
« Le nom, la description et l'URL sont requis »Un de ces champs est vide
« Skill créé » / « Skill mis à jour »L'enregistrement a réussi
« Échec de l'enregistrement »L'enregistrement n'a pas abouti : réessayez
« Échec de la génération IA »L'IA n'a pas pu proposer de skill : reformulez ou configurez à la main
« Réservé au propriétaire du projet »Seul le propriétaire ouvre cette fenêtre
« Skill [nom] » dans le chatL'agent est en train d'appeler ce skill
« ERROR: Adresse interne non autorisée »L'adresse vise un réseau interne : utilisez l'adresse publique
« ERROR (code) » suivi d'un texteLe service a refusé l'appel ou signalé une erreur
« OK (code) » suivi d'un texteLe service a accepté l'appel

17. Dépannage

Vous constatezCause probableQue faire
L'agent n'utilise jamais mon skillVous êtes en mode Dev ou Operator, ou le skill est désactivéPassez en Hybrid et vérifiez l'interrupteur
L'agent dit ne pas connaître d'outil pour celaLa description est trop vagueRéécrivez la description : ce que ça fait, quand l'utiliser
Erreur 401 ou 403Clé absente, fausse ou sans droitVérifiez l'en-tête ou le connecteur, et les droits de la clé
Erreur 404Adresse incorrecte (fréquent avec un skill généré)Comparez avec la documentation du service
Erreur 400 ou 422Le corps envoyé ne correspond pas à ce que le service attendCorrigez le modèle de corps
L'adresse contient des accolades à la place d'une valeurParamètre écrit avec des doubles accoladesRemplacez-les par des accolades simples
« Adresse interne non autorisée »L'adresse vise un service privé ou localUtilisez l'adresse publique du service
Le message part deux foisL'agent a rappelé le skill après une erreur ou une réponse peu clairePrécisez dans la demande « une seule fois »
La réponse semble coupéeRéponse tronquéeDemandez un service ou une option qui renvoie moins de données
Le skill a disparuIl a été supprimé, ou il appartient à un autre projetRecréez-le dans le bon projet

18. Liste de contrôle

  • Je sais ce que le skill fait, et je l'ai testé sur un cas sans conséquence.
  • J'ai comparé l'adresse, la méthode et le corps à la documentation du service.
  • Ma description dit ce que fait le skill, quand l'utiliser et ce que contient chaque paramètre.
  • Mes paramètres sont entre accolades simples.
  • Ma clé est à portée limitée, et elle n'est ni dans la description ni dans le chat.
  • L'interrupteur du skill est actif et je suis en mode Hybrid.
  • Je préfère des skills qui lisent à des skills qui suppriment ou paient.
  • Je vérifie dans le service lui-même que l'action a bien eu lieu.
  • Je n'ai donné la propriété du projet qu'à des personnes de confiance.

19. Questions fréquentes

Qu'est-ce qu'un skill B-Coder ?

Une connexion vers un service extérieur que vous apprenez à l'agent du chat : une adresse, une méthode (lire, envoyer, modifier, supprimer) et ce qu'il faut transmettre. Une fois créé, l'agent peut l'utiliser dans vos conversations, par exemple pour envoyer un message dans un canal Slack, créer un ticket ou appeler un webhook Zapier.

Pourquoi mon skill n'est-il jamais utilisé ?

Le plus souvent parce que vous n'êtes pas en mode Hybride. Les skills ne sont proposés à l'agent qu'en mode Hybrid (menu à icône de robot, en bas du chat). En mode Dev, qui est le mode par défaut, et en mode Operator, ils restent enregistrés mais l'agent ne les appelle pas.

Un skill ajoute-t-il une fonction à mon site publié ?

Non. Un skill aide l'agent pendant que vous travaillez avec lui dans le Studio. Il ne s'exécute pas quand un visiteur utilise votre site. Pour des fonctions sur le site (comptes, paiement, e-mails, réservations), voir l'article sur les fonctions intégrées.

Qui peut créer et modifier des skills ?

Le propriétaire du projet. L'icône est désactivée pour les autres personnes (« Réservé au propriétaire du projet »). Les skills appartiennent à un projet : ils ne passent pas automatiquement d'un projet à l'autre.

Puis-je faire générer un skill par l'IA ?

Oui : décrivez ce que le skill doit faire, l'IA propose un nom, une description, une méthode, une adresse et un corps. Relisez tout avant d'enregistrer : l'adresse proposée peut être inventée ou périmée. Comparez-la à la documentation du service.

Comment fonctionnent les paramètres entre accolades ?

Dans l'adresse ou dans le corps, un mot entre accolades simples, comme {ville}, devient un champ que l'agent remplit au moment de l'appel. Utilisez des accolades simples : des doubles accolades comme {{ville}} ne sont pas comprises et donnent une adresse incorrecte.

Où mettre ma clé d'API ?

Dans les en-têtes du skill, ou, si le service passe par un compte connecté, via un connecteur. La clé est conservée avec le skill : choisissez une clé à portée limitée (lecture seule, montant plafonné), jamais une clé qui peut tout faire. Ne la mettez pas en paramètre : l'agent devrait alors la recevoir dans le chat.

L'agent demande-t-il confirmation avant d'appeler un skill ?

Non. Un skill qui envoie un message, supprime une donnée ou déclenche un paiement agit dès que l'agent l'appelle. Préférez des skills qui lisent, écrivez des descriptions précises, et testez d'abord avec un service sans conséquence.

Les skills fonctionnent-ils dans les automatisations B-Coder ?

Non. Une automatisation B-Coder travaille uniquement sur les données de la base du projet. Elle n'a pas accès aux skills. Voir l'article sur les automatisations.

Puis-je importer un schéma OpenAPI ?

Pas pour le moment : le bouton d'import est désactivé. Créez vos skills un par un, à la main ou avec l'IA.

Pourquoi un skill est-il refusé avec « Adresse interne non autorisée » ?

Parce que l'adresse vise un réseau privé, la machine locale ou un service interne. Par mesure de sécurité, bmaster n'appelle que des adresses publiques sur Internet. Utilisez l'adresse publique du service.

Que voit l'agent de la réponse du service ?

Le code de statut (réussite ou erreur) et le début de la réponse, tronquée au bout d'environ trois mille caractères. Un service qui renvoie de très longs résultats n'est donc lu qu'en partie.

Puis-je désactiver un skill sans le supprimer ?

Oui, avec son interrupteur : il reste enregistré mais l'agent ne le voit plus. La suppression, elle, est immédiate et sans confirmation.

Le résultat est-il garanti ?

Non. Un service peut changer, refuser l'appel ou répondre autrement que prévu, et l'agent peut mal interpréter la réponse. Testez, relisez ce qui est envoyé, et gardez des sauvegardes.

20. Glossaire

  • Skill : une connexion vers un service extérieur, définie une fois et appelée par l'agent du chat
  • Mode Hybride : le mode de l'agent où il construit votre site, gère vos données et utilise vos skills
  • API : la porte d'entrée d'un service, qu'un programme peut appeler
  • Webhook : une adresse qui déclenche une action quand on l'appelle
  • Méthode (GET, POST, PUT, PATCH, DELETE) : le type d'appel : lire, envoyer, remplacer, modifier, supprimer
  • En-tête : une information jointe à un appel, comme une clé d'accès
  • Corps : les données envoyées avec un appel
  • Paramètre : un mot entre accolades simples que l'agent remplace par une valeur au moment de l'appel
  • Connecteur : un compte connecté (par exemple Google ou Dropbox) dont l'accès peut être joint à un skill
  • Clé d'API : un code secret qui donne accès à un service

À lire aussi sur bmaster

Un skill bien décrit, une clé limitée, un test sans conséquence.

Créez votre premier skill, passez en mode Hybride, puis vérifiez dans le service que l'action a bien eu lieu.