← Toute la documentation
Guides pratiques

Une idée.
Quelques bulles.
Un premier résultat.

Quatre points de départ pour explorer Bubblai. Chaque guide montre les bulles à connecter, les étapes et un résultat à vérifier. Adaptez ensuite les exemples à votre propre univers.

Première visite ? Créez votre premier agent et choisissez son modèle.

Vous restez dans la conversation ; les bulles lui apportent les capacités dont vous avez besoin.

Créer un personnage qui a du caractère

Guide 01 · Personnages & compagnons

Résultat : un compagnon d’atelier dont vous pouvez faire évoluer la personnalité. À prévoir : un accès à un modèle de conversation ; la voix reste facultative.

Constellation : MietteL’agent Miette au centre, relié aux bulles Rôle, Instructions et Voix · option.RôleInstructionsVoix · optionAGENTMiette
Exemple de configuration : les traits représentent les bulles connectées à l’agent.
  1. Créez un agent nommé Miette. Ouvrez sa constellation.
  2. Ouvrez la bulle Rôle, collez le texte ci-dessous et enregistrez.
À placer dans Rôle
Tu es Miette, un compagnon d’atelier curieux et un peu malicieux.
Tu remarques les formes, les matières et les détails incongrus.
Tu aimes imaginer ce qu’un objet ordinaire pourrait devenir.
Ton caractère se révèle dans tes réactions et tes propositions.
  1. Dans Instructions, ajoutez ces quelques indications puis connectez les deux bulles.
À placer dans Instructions
Parle en français avec un ton vivant et naturel.
Rebondis sur ce que je dis sans répéter systématiquement ta présentation.
Laisse la conversation évoluer et propose des idées quand elles te viennent.
  1. Ouvrez un nouveau fil et envoyez : « J’ai trouvé une passoire tordue et une petite roue. Qu’est-ce que ça t’inspire ? »
  2. Observez son vocabulaire, ses réactions et ses propositions. Remplacez « malicieux » par « rêveur et distrait », puis comparez dans un autre fil.
  3. Si le personnage vous convient, conservez ses bulles dans la Bullethèque. Vous pourrez les réutiliser pour un autre compagnon.

Ajouter une voix

Une bulle Voix permet de lire les réponses avec le fournisseur choisi. Pour une conversation vocale en direct, configurez plutôt Realtime et le microphone. Validez d’abord le personnage en texte : cela facilite les ajustements.

Si le personnage devient répétitif : retirez les consignes redondantes, évitez de lui imposer une structure identique à chaque réponse et testez dans un nouveau fil.

Un assistant qui travaille avec vos documents

Guide 02 · Documents & vérification

Résultat : retrouver une information précise dans un fichier et contrôler la réponse. À prévoir : un accès au chat et le petit fichier d’exemple ci-dessous.

Constellation : AtelierL’agent Atelier au centre, relié aux bulles Rôle, Instructions et Documents.RôleInstructionsDocumentsAGENTAtelier
Exemple de configuration : les traits représentent les bulles connectées à l’agent.
  1. Téléchargez la fiche d’atelier d’exemple. Elle contient des données fictives : une durée, un nombre de participants et du matériel.
  2. Créez un agent nommé Atelier. Dans Rôle, indiquez : « Tu m’aides à consulter et organiser les informations de mes documents. »
  3. Dans Instructions, collez le texte ci-dessous et enregistrez.
À placer dans Instructions
Appuie tes réponses sur les documents fournis.
Indique le nom du fichier et un court passage qui justifie ta réponse.
Si une information est absente, dis-le sans inventer de valeur.
  1. Ajoutez une bulle Documents, importez fiche-atelier.txt et vérifiez qu’il apparaît dans la liste. Enregistrez et connectez la bulle à l’agent.
  2. Dans le chat, demandez : « Combien de personnes sont prévues et combien de temps dure l’atelier ? Cite le passage. »
  3. Vérifiez : la fiche indique 8 participants et 90 minutes. Demandez ensuite « Quel est le budget ? » : le budget n’est pas renseigné.
  4. Remplacez ensuite cet exemple par un document de votre choix. Commencez par une question dont vous connaissez déjà la réponse, puis demandez une synthèse.
Ce que ce test vérifie : l’utilisation du bon fichier et la distinction entre information présente et absente. Une bonne réponse sur cet exemple ne garantit pas une lecture exhaustive de tous vos documents.

Si le fichier est mal compris

Essayez un texte court ou un PDF dont le texte peut être sélectionné. Pour un tableur, exportez les données utiles en CSV. Si le document est long, ciblez une section et vérifiez le passage cité.

Composer un atelier de création visuelle

Guide 03 · Image & vidéo

Résultat : faire varier une même demande d’image en connectant et déconnectant plusieurs bulles d’instructions. À prévoir : un modèle de conversation, un fournisseur d’images configuré et les crédits nécessaires.

Une demande, plusieurs combinaisons

Une bulle demande du noir et blanc, une autre un arrière-plan flou. Connectez l’une, l’autre ou les deux à l’agent : leurs consignes se combinent pour guider la prochaine génération. Vous gardez vos réglages dans des bulles séparées et réutilisables.

Deux bulles d’instructions pour une génération d’image Noir et blanc et Arrière-plan flou sont connectées à l’agent Création. La bulle Image reste connectée. Les deux consignes se combinent. INSTRUCTIONS Noir et blanc Connectée INSTRUCTIONS Arrière-plan flou Connectée AGENT Création Image Toujours connectée ici

Consignes combinées : une image en noir et blanc avec un arrière-plan flou.

Schéma de principe. Trait bleu continu : bulle connectée ; trait gris pointillé : bulle déconnectée. Les boutons permettent de tester les combinaisons dans ce guide, sans lancer de génération d’image.

Préparer les bulles dans Bubblai

  1. Créez un agent nommé Création. Dans Rôle, écrivez : « Tu m’aides à explorer des idées visuelles, à préparer une composition et à affiner ses détails. »
  2. Ajoutez une bulle Image. Ouvrez ses réglages, choisissez le fournisseur et le modèle disponibles, puis renseignez la clé requise. Enregistrez et connectez cette bulle à l’agent. Elle restera connectée pendant tous les essais.
  3. Ajoutez deux bulles Instructions distinctes. Nommez-les « Noir et blanc » et « Arrière-plan flou ». Collez une consigne dans chacune et enregistrez.
Bulle Instructions · Noir et blanc
Pour chaque génération d’image, demande une image uniquement en noir et blanc, avec des nuances de gris et aucune couleur.
Bulle Instructions · Arrière-plan flou
Pour chaque génération d’image, demande un sujet principal net au premier plan et un arrière-plan flou.

Garder la même demande et changer les connexions

Connectez seulement « Noir et blanc » à l’agent, puis envoyez cette demande. Reprenez ensuite exactement le même texte pour les autres combinaisons.

La même demande dans le chat pour chaque essai
Génère une image d’un petit personnage en carton et métal récupéré, posé au premier plan sur un établi. Derrière lui, on distingue les outils et les étagères d’un atelier. Aucun lettrage dans l’image.
Les connexions changent, la demande reste la même
Noir et blancArrière-plan flouRésultat recherché
ConnectéeDéconnectéeUne image en noir et blanc ; aucun flou demandé par ces bulles.
DéconnectéeConnectéeUn personnage net et un fond flou ; aucune contrainte de noir et blanc.
ConnectéeConnectéeUne image en noir et blanc avec un personnage net et un fond flou.
DéconnectéeDéconnectéeLa demande de base, sans les deux consignes supplémentaires.

Pour comparer clairement, ouvrez un nouveau fil après avoir changé les connexions : les échanges précédents peuvent encore influencer l’agent. Relancez la génération, téléchargez les images et comparez les effets obtenus ; les détails peuvent varier selon le modèle.

Déconnecter conserve la bulle et son texte. Vous pourrez la reconnecter au prochain essai, sans réécrire sa consigne. Cela ne modifie pas les images déjà produites.

Ajoutez ensuite vos propres bulles : « Lumière de fin de journée », « Dessin au trait » ou « Cadrage rapproché ». Conservez celles qui vous plaisent dans la Bullethèque pour les recombiner avec d’autres agents.

Retoucher une image obtenue

Désignez l’image à modifier et demandez un changement précis, par exemple « Garde le personnage, mais remplace l’établi par une table ronde ». Choisissez un modèle compatible avec l’édition si nécessaire et vérifiez quelles bulles d’instructions sont connectées pour cette retouche.

Prolonger en vidéo

Ajoutez une bulle Vidéo, configurez son fournisseur et ses crédits, puis placez l’image de référence dans la conversation. Demandez une animation courte, par exemple un mouvement léger de la lumière. Vérifiez que le modèle choisi accepte bien l’image en entrée. Durée, format, temps d’attente et coût dépendent du service.

Si l’agent répond seulement par du texte : vérifiez la connexion de la bulle, son fournisseur et sa clé, puis formulez « Génère l’image ». Si une erreur apparaît, partez de son message exact.

Préparer un dossier et créer ses fichiers

Guide 04 · PDF, CSV et actions enchaînées

Résultat : une fiche d’atelier PDF et une liste de matériel CSV, téléchargeables depuis le chat. À prévoir : un modèle de conversation disponible et la fiche d’exemple du guide Documents.

1. Préparer et vérifier le contenu

Reprenez l’agent Atelier du guide Documents, avec sa fiche connectée. La génération des fichiers est une action du chat : elle ne demande pas d’ajouter une bulle Exécution ni une bulle Web.

Première demande dans le chat
À partir de fiche-atelier.txt, prépare une fiche de préparation avec le titre, la durée, le nombre de participants et le matériel mentionné. Reprends uniquement les informations du document. Marque les informations absentes comme « non renseigné ». Présente-moi d’abord le contenu dans le chat.

Vérifiez notamment 8 participants, 90 minutes et l’absence de budget. Corrigez le contenu dans la conversation avant de produire les fichiers.

2. Demander les deux fichiers

Après validation du contenu
Crée deux fichiers téléchargeables à partir du contenu que nous venons de valider :
1. fiche-atelier.pdf : une fiche lisible avec les informations de l’atelier et le matériel.
2. materiel-atelier.csv : un tableau avec les colonnes « matériel » et « quantité ». Quand une quantité n’est pas indiquée, écris « non renseigné ».
Fournis les deux fichiers dans la conversation.

Attendez l’apparition des fichiers ou de leurs boutons de téléchargement. Une phrase annonçant « c’est prêt » ne suffit pas : ouvrez le PDF et le CSV, puis contrôlez les noms, le texte, les valeurs et la mise en page.

3. Récupérer et réutiliser le résultat

Téléchargez les fichiers et regroupez-les dans votre dossier d’atelier. Ici, le dossier désigne votre ensemble de documents : la création de fichiers dans le chat ne donne pas à l’agent un accès général aux répertoires de votre ordinateur.

Vous pouvez ensuite demander une autre version, un DOCX modifiable ou une liste complémentaire. Les fichiers peuvent servir à une étape suivante dans la même conversation ; les formats et les noms exacts aident l’agent à retrouver le bon résultat.

Enchaîner un petit workflow

Après un premier essai réussi, réunissez la préparation et la production dans une demande : « Lis cette fiche, prépare une synthèse et crée le PDF et le CSV correspondants. » L’agent peut enchaîner des appels d’outils, puis utiliser leurs résultats. Contrôlez les étapes et les fichiers produits ; une erreur de modèle ou d’outil peut interrompre le parcours.

Si aucun fichier n’apparaît : demandez d’abord un petit fichier TXT avec un contenu explicite, puis un PDF court. Vérifiez les erreurs affichées, l’accès au modèle et le chargement des outils. Si un PDF est vide ou illisible, ne le considérez pas comme terminé.

Et pour les makers ?

Ajoutez du JavaScript à votre interface ou connectez un appareil BLE. Le volet technique détaille les prérequis, les commandes et les limites de chaque parcours.

Bubblai / VuillierNicolas © · Guides du 22 septembre 2026