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'agent | Le 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 |
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.
| Mode | Ce que fait l'agent | Skills |
|---|---|---|
| Dev (par défaut) | Construit et modifie votre site : fichiers, pages, base de développement | Jamais appelés |
| Operator | Gère les données de votre application : consulter, interroger | Jamais appelés |
| Hybrid | Les deux à la fois | Appelés |
- 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
- 1Ouvrez votre projet dans le Studio.
- 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 ».
- 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à).
- 4Deux voies : décrire ce que vous voulez et laisser l'IA remplir le formulaire (section 5), ou cliquer sur « Configurer manuellement ».
- 5Remplissez ou relisez le formulaire (section 6).
- 6Cliquez sur « Créer ». Le message « Skill créé » apparaît, et le skill s'ajoute à la liste.
- 7Vérifiez l'interrupteur du skill : il doit être actif.
- 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.
- 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 sert | Conseil |
|---|---|---|
| Nom de l'outil | Le nom sous lequel l'agent connaît le skill | Minuscules et underscores seulement : envoyer_message_slack. Deux noms qui ne diffèrent que par la ponctuation donnent le même outil |
| Description | Dit à l'agent quand et comment se servir du skill | Une phrase claire : « Envoie un message texte dans le canal Slack de l'équipe. » |
| Méthode | Le type d'appel : GET (lire), POST (envoyer), PUT et PATCH (modifier), DELETE (supprimer) | Choisissez celle que demande la documentation du service |
| URL | L'adresse du service | Complè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ès | Voir la section 8 |
| Template de corps (JSON) | Ce qui est envoyé avec l'appel | Utilisez des paramètres {param} : l'agent les remplit |
| Connecteur OAuth | Joint 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ù | Exemple | Ce que l'agent remplit |
|---|---|---|
| Dans l'adresse | https://exemple.com/meteo?ville={ville} | La ville |
| Dans le corps | {"text": "{message}"} | Le texte du message |
| Dans les deux | Adresse 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çon | Comment | Précaution |
|---|---|---|
| Dans les en-têtes | Un 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 connecteur | Choisir un compte connecté dans « Connecteur OAuth » : son accès est joint à chaque appel | Ne vaut que pour les services qui passent par ce compte |
| En paramètre | Mettre {cle} en en-tête : l'agent doit la fournir | À éviter : la clé devrait être écrite dans le chat |
- 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
- 1Passez en mode Hybrid (icône de robot).
- 2Demandez en français, avec les informations que le skill attend : « Envoie un message à l'équipe : le site est en ligne. »
- 3L'agent choisit le skill d'après sa description, remplit les paramètres, et vous voyez « Skill [nom] » dans le chat.
- 4L'appel part des serveurs bmaster, pas de votre ordinateur.
- 5La réponse du service revient à l'agent : le code de statut (réussite ou erreur) et le début du contenu.
- 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
| Action | Comment |
|---|---|
| Tester | En mode Hybrid, demandez à l'agent d'utiliser le skill avec un cas sans conséquence (un canal de test, un service en lecture) |
| Modifier | Cliquez sur le skill dans la liste : le formulaire s'ouvre. « Enregistrer » → message « Skill mis à jour » |
| Désactiver | Interrupteur du skill : il reste enregistré, mais l'agent ne le voit plus |
| Supprimer | Corbeille : 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
| Besoin | Méthode | Adresse (à adapter) | Paramètres |
|---|---|---|---|
| Message dans un canal Slack | POST | L'adresse de webhook fournie par Slack | {message} |
| Déclencher un scénario d'automatisation externe | POST | L'adresse de déclenchement du scénario | {donnees} |
| Créer un ticket | POST | L'adresse d'envoi de votre outil de suivi | {titre}, {description} |
| Lire la météo | GET | L'adresse du service météo avec ?ville={ville} | {ville} |
| Récupérer un client dans un outil externe | GET | L'adresse de l'outil avec /clients/{id} | {id} |
Bien décrire un skill
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
| bmaster | Vous |
|---|---|
| Refuse les adresses internes : réseau privé, machine locale, services internes | Choisissez des services de confiance et des adresses publiques |
| Vérifie aussi les adresses vers lesquelles un service vous redirige | Lisez la documentation du service et ses conditions |
| Limite l'ouverture de la fenêtre Skills au propriétaire du projet | Ne donnez pas la propriété d'un projet à quelqu'un que vous ne connaissez pas |
| Ne donne les skills à l'agent qu'en mode Hybride | Dé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
| Message | Signification |
|---|---|
| « 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 chat | L'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 texte | Le service a refusé l'appel ou signalé une erreur |
| « OK (code) » suivi d'un texte | Le service a accepté l'appel |
17. Dépannage
| Vous constatez | Cause probable | Que faire |
|---|---|---|
| L'agent n'utilise jamais mon skill | Vous ê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 cela | La description est trop vague | Réécrivez la description : ce que ça fait, quand l'utiliser |
| Erreur 401 ou 403 | Clé absente, fausse ou sans droit | Vérifiez l'en-tête ou le connecteur, et les droits de la clé |
| Erreur 404 | Adresse incorrecte (fréquent avec un skill généré) | Comparez avec la documentation du service |
| Erreur 400 ou 422 | Le corps envoyé ne correspond pas à ce que le service attend | Corrigez le modèle de corps |
| L'adresse contient des accolades à la place d'une valeur | Paramètre écrit avec des doubles accolades | Remplacez-les par des accolades simples |
| « Adresse interne non autorisée » | L'adresse vise un service privé ou local | Utilisez l'adresse publique du service |
| Le message part deux fois | L'agent a rappelé le skill après une erreur ou une réponse peu claire | Précisez dans la demande « une seule fois » |
| La réponse semble coupée | Réponse tronquée | Demandez un service ou une option qui renvoie moins de données |
| Le skill a disparu | Il a été supprimé, ou il appartient à un autre projet | Recré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
Modifier un site web avec le chat et Visual Edit
Le chat B-Coder, ses modes et le mode production.
DécouvrirAutomatisation avec l'IA
Les tâches planifiées du compte et de B-Coder.
DécouvrirRéservation en ligne, comptes, paiement et e-mails
Les fonctions intégrées d'un site.
DécouvrirCybersécurité d'un site créé avec l'IA
Vérifier la protection d'un projet avant de le publier.
Découvrir