Composez votre agent.
Comprenez ses outils.
Bubblai place la conversation au centre d’une constellation de bulles. Personnalité, documents, images, voix ou outils : vous choisissez ce que votre agent peut utiliser, puis vous ajustez sa configuration visuellement.
Commencez avec un petit agent, puis ajoutez les capacités utiles. Les crédits de découverte et vos propres clés API sont deux modes d’accès aux modèles ; voir les prérequis et les coûts.
Documentation mise à jour le 22 septembre 2026.
Objectif : obtenir une réponse personnalisée avec seulement une bulle Rôle et une bulle Instructions.
- Ouvrez Bubblai et créez un agent, ou partez d’un agent proposé dans la bibliothèque. Donnez-lui un nom pour le retrouver.
- Dans sa constellation, ouvrez ou ajoutez une bulle Rôle. Décrivez son caractère ou sa spécialité : « Tu es un compagnon d’atelier inventif, qui m’aide à explorer des idées de fabrication. » Enregistrez.
- Ajoutez une bulle Instructions : « Réponds en français. Pose une question si une dimension essentielle manque. » Enregistrez, puis vérifiez que les deux bulles sont connectées à l’agent.
- Ouvrez la conversation. Utilisez les crédits de découverte s’ils sont disponibles, ou configurez votre fournisseur et votre clé API dans les réglages. La clé doit disposer d’un accès au modèle choisi.
- Envoyez : « Je veux fabriquer une petite créature en carton. Propose-moi trois caractères très différents. »
- Modifiez le Rôle, puis recommencez dans un nouveau fil pour comparer. Le contenu des échanges précédents peut continuer à influencer un fil existant.
Vous pouvez ensuite sauvegarder vos bulles dans la Bullethèque. Choisissez un guide pour aller plus loin →
Qu'est-ce qu'une bulle ?
Une bulle est un module de capacité autonome. Quand vous l'activez sur le canvas, elle s'injecte automatiquement dans le contexte de votre agent IA. La déconnecter retire cette capacité des prochains échanges concernés, mais n’efface ni sa configuration ni ce qui figure déjà dans l’historique.
Au-delà d'une simple capacité, chaque bulle est aussi un bloc d'instructions qui oriente le comportement du modèle. Les bulles se combinent et s'additionnent librement — leurs instructions se cumulent pour façonner un agent unique.
Comment ça marche
- Chaque bulle ajoute une capacité spécifique au LLM (mémoire, recherche web, voix, etc.)
- La constellation accepte jusqu’à 12 bulles ouvertes simultanément ; vous pouvez conserver et réutiliser d’autres bulles dans la Bullethèque
- Vous pouvez avoir plusieurs bulles du même type — par exemple 2 bulles Image avec des paramètres de sortie différents — pour comparer les images générées par l'agent
- Certaines fonctionnalités nécessitent la version Full (paiement unique)
Le canvas
Le canvas est l'interface visuelle où vous arrangez vos bulles autour de votre agent central. C'est votre "constellation d'IA" — une représentation des capacités que vous lui connectez. Les réglages des fournisseurs et les autorisations restent nécessaires pour utiliser les outils.
Description
La Bullethèque est la bibliothèque de bulles de Bubblai. Vous y trouvez des bulles officielles prêtes à l'emploi, et vous pouvez y enregistrer vos propres bulles pour les réutiliser d'un agent à l'autre — sans jamais les reconfigurer.
Fonctionnement
- Mes Bulles : vos bulles sauvegardées (avec un titre et un sous-titre), réutilisables sur tous vos agents
- Bubblai : les bulles officielles prêtes à l'emploi
- Partagées : les bulles de la communauté (bientôt)
- Recherche par nom, thème, métier ou mot-clé
Cas d'usage
- Repartir d'une bulle existante au lieu de repartir de zéro
- Réutiliser un pack de règles (ex : « Règles du prof d'histoire ») sur plusieurs agents
- Composer un agent rapidement à partir de bulles éprouvées
Choisir un moteur de conversation
Le sélecteur du chat permet de choisir un fournisseur et un modèle disponibles dans votre version de Bubblai. OpenAI, Anthropic, Google, xAI et Mistral font partie des fournisseurs proposés ; la liste des modèles évolue.
Conversation et outils ont leurs propres réglages
Le modèle du chat et celui d’une bulle Image, Vidéo, Voix ou Realtime peuvent être différents. Changer le moteur de conversation ne configure pas automatiquement tous ces services.
Contexte et consommation
Les messages, consignes et extraits de documents participent au contexte envoyé au modèle. Un long historique ou des documents volumineux peuvent augmenter la consommation. Les mécanismes de cache et de réduction du contexte dépendent du fournisseur et du parcours utilisé ; ne les considérez pas comme une garantie de coût fixe.
Description
La bulle Rôle définit la personnalité et l'identité de votre agent IA. Elle injecte un prompt système qui donne à l'agent un caractère, une expertise et un ton de communication précis.
Cas d'usage
- Créer un personnage avec son vocabulaire, ses envies et sa façon de réagir
- Définir un assistant commercial avec un ton chaleureux et vendeur
- Créer un compagnon de conversation ou un personnage de jeu de rôle
- Mettre en place un agent technique qui répond uniquement en code
Exemple de configuration
Description
La bulle Instructions permet de définir des règles comportementales précises et permanentes. Contrairement au Rôle qui définit "qui est" l'agent, les Instructions définissent "comment il doit se comporter" à chaque échange. Chaque bulle est un bloc de prompt granulaire : les instructions de plusieurs bulles s'additionnent pour former un comportement composé, précis et modulable.
Cas d'usage
- Imposer un format de réponse spécifique (listes, JSON, markdown…)
- Interdire certains sujets ou types de réponses
- Forcer l'agent à toujours demander une confirmation avant d'agir
- Définir la langue de réponse obligatoire
Exemple
Description
La bulle Mémoire donne à votre agent la capacité de se souvenir d'informations entre les sessions. Le fonctionnement est déclaratif : le moteur ne stocke un souvenir que lorsque vous lui demandez explicitement de retenir quelque chose. Rien n'est mémorisé automatiquement.
Cette mémoire est unique et commune à tous vos agents — un souvenir déclaré à un agent est accessible à tous les autres.
Caractéristiques
- Déclarative — stockage uniquement sur demande explicite (« retiens que… », « note que… »)
- Globale — un seul espace de mémoire, partagé entre tous vos agents
- Inter-session — les souvenirs persistent d'une conversation à l'autre
À noter — mémoire épisodique
Il existe par ailleurs une mémoire épisodique, distincte de cette bulle : lorsque vous ouvrez un projet, l'historique de ses fils de discussion est automatiquement rechargé en contexte. Ce mécanisme est natif, il ne nécessite aucune bulle et s'active sans action de votre part.
Cas d'usage
- Demander à l'agent de retenir vos préférences (« retiens que je préfère les réponses courtes »)
- Mémoriser des faits durables : nom, contexte pro, projets en cours
- Éviter de répéter le contexte à chaque nouvelle conversation
Description
La bulle Projet contextualise votre agent autour d'un projet spécifique. Elle injecte toutes les informations clés du projet (nom, objectifs, contraintes, équipe, deadlines) dans le contexte de l'agent dès le démarrage.
Cas d'usage
- Donner à l'agent le contexte complet d'un projet client
- Centraliser les informations produit pour un assistant de développement
- Configurer un agent qui s’appuie sur les informations fournies au sujet de votre entreprise
- Passer rapidement d'un projet à un autre sans reconfigurer
Exemple
Description
La bulle Web donne à votre agent la capacité de naviguer sur Internet en temps réel. Il peut effectuer des recherches, lire des pages web, récupérer des images et synthétiser des informations fraîches.
Providers phares
Perplexity · GPT Search (OpenAI) · Tavily
Capacités
- Recherche web en temps réel (Google, Bing…)
- Lecture et résumé de pages web à partir d'une URL
- Récupération d'images depuis le web
- Vérification de faits et données récentes
Cas d'usage
- Agent de veille concurrentielle automatique
- Assistant qui cite des sources vérifiées en temps réel
- Récupérer les dernières actualités d'un secteur
Description
La bulle Image permet à votre agent de générer et d'éditer des images directement depuis la conversation, à partir d'un prompt textuel ou d'une image existante.
Providers phares
GPT Image (OpenAI) · Imagen & Gemini (Google) · Grok Imagine (xAI) · Flux (Black Forest Labs)
Capacités
- Génération d'images à partir d'un texte descriptif
- Édition et modification d'images existantes
- Variations d'une image de référence
- Génération de logos, illustrations, mockups…
Cas d'usage
- Créer des visuels pour les réseaux sociaux à la demande
- Générer des illustrations pour des présentations
- Prototyper des interfaces rapidement
Description
La bulle Documents permet d'uploader des fichiers que votre agent peut lire, analyser et utiliser dans ses réponses. Le contenu exploitable dépend du format, de l’extraction et du modèle choisi. Commencez par un fichier texte court ou un PDF contenant du texte sélectionnable.
Formats supportés
- PDF, DOCX, TXT, MD
- CSV, TSV (données tabulaires sous forme de texte ; exportez votre tableur dans l’un de ces formats pour un premier essai)
- Images (PNG, JPG — analyse visuelle)
- Code source (JS, Python, HTML…)
Cas d'usage
- Analyser un contrat et en extraire les clauses clés
- Poser des questions ciblées sur un rapport, puis vérifier les passages cités
- Créer un agent qui s’appuie sur les extraits de votre documentation interne
Description
La bulle Voix permet à votre agent de parler. Elle active la synthèse vocale (Text-to-Speech) : chaque réponse de l'agent peut être lue à voix haute, avec le choix de la voix, du débit et du ton.
Providers phares
OpenAI TTS · Gemini TTS (Google) · xAI TTS
Capacités
- Synthèse vocale naturelle (Text-to-Speech)
- Choix de la voix (genre, accent, langue)
- Contrôle du débit et du volume
- Support multilingue
- Lecture automatique des réponses de l'agent
Cas d'usage
- Agent vocal qui lit ses réponses à voix haute
- Accessibilité pour les personnes malvoyantes
- Écouter les réponses sans regarder l'écran (conduite, sport…)
- Création de contenus audio à partir de texte
Note
La bulle Voix couvre uniquement la synthèse vocale (TTS). La reconnaissance vocale (STT / dictée) n'est pas incluse dans cette bulle.
Description
La bulle Realtime donne à votre agent une voix conversationnelle en temps réel : vous parlez, il écoute et répond instantanément, comme un appel naturel. Quand elle est activée, elle remplace le mode vocal classique.
Providers phares
OpenAI Realtime · xAI Realtime
Capacités
- Conversation voix → voix en temps réel (WebRTC / WebSocket)
- Interruption de l'IA quand vous parlez (barge-in)
- Transcription de la conversation dans le chat
- Choix de la voix, de la langue et de la réactivité (rapide / naturelle / patiente)
- Réduction de bruit adaptée au micro (proche / distant)
Cas d'usage
- Conversations naturelles avec votre agent
- Brainstorming et réflexion à voix haute
- Pratique d'une langue étrangère
- Assistant mains libres (cuisine, conduite, sport…)
Note
La bulle Realtime prend le relais du mode vocal classique. Le microphone et une connexion réseau sont nécessaires. Selon le fournisseur, la création de la session passe par un relais Bubblai ; voir la section Données et clés API.
Une liaison avec un appareil programmé pour recevoir vos commandes
Le parcours d’envoi direct documenté ici utilise Bluetooth Low Energy (BLE), GATT et le service UART Nordic. Un ESP32 équipé du bon firmware peut recevoir du texte envoyé par l’agent. La compatibilité dépend du firmware et des services exposés, pas seulement du nom de la carte.
Avant de commencer
- Utiliser un navigateur compatible Web Bluetooth, en HTTPS, et choisir l’appareil dans la fenêtre du navigateur.
- Vérifier une commande simple sur l’appareil avant d’ajouter la voix ou des mouvements.
- Décrire à l’agent les seules commandes que le firmware comprend réellement.
Autres modes
L’interface comporte aussi des entrées série/USB, Wi-Fi, WebSocket et REST. Elles ne garantissent pas un envoi prêt à l’emploi pour chaque appareil : un script et un protocole adaptés peuvent être nécessaires. MQTT et Bluetooth Classic ne sont pas documentés ici comme des connexions natives directement utilisables.
Description
La bulle Action permet à votre agent de déclencher des actions déclaratives dans vos outils externes. L'agent ne se contente plus de répondre — il agit directement dans votre écosystème applicatif.
Types d'actions
- Appels HTTP / API REST vers des services externes
- Déclenchement de webhooks
- Création, modification ou suppression de données
- Envoi de notifications ou d'emails
Cas d'usage
- Créer une tâche dans vos outils depuis la conversation
- Envoyer un email automatiquement après une décision
- Déclencher un pipeline de déploiement
- Mettre à jour une base de données à partir d'une instruction
Description
La bulle Connecteurs permet de brancher des services tiers à votre agent, qui peut alors agir dans ces services à votre demande. Les connexions passent par Composio, prestataire technique, ou directement avec vos propres clés ou autorisations selon le parcours utilisé.
Connecteurs disponibles
- Gmail — envoyer des emails, lire la boîte de réception et consulter un email
- Google Tasks — créer des tâches
- Google Calendar — créer des événements et consulter l'agenda
- Google Drive — lister, lire et télécharger des fichiers
Cas d'usage
- Agent qui envoie des emails à votre demande
- Assistant qui planifie vos réunions dans Calendar
- IA qui retrouve un document dans votre Drive
Description
La bulle Vidéo permet à votre agent de générer des vidéos à partir d'une image de référence ou d'une description textuelle. Donnez vie à vos idées visuelles en quelques secondes sans aucune compétence en montage.
Providers phares
Grok Video (xAI) · Seedance (ByteDance)
Modes de génération
- Image → Vidéo — anime une image fixe en clip vidéo
- Texte → Vidéo — génère une vidéo depuis une description
- Contrôle de la durée, du mouvement de caméra et du style
Cas d'usage
- Créer des vidéos courtes pour les réseaux sociaux
- Animer un logo ou une illustration statique
- Prototyper des publicités visuelles rapidement
- Générer des clips de présentation produit
JavaScript dans la page
La bulle Exécution (Code) lance un script JavaScript enregistré dans la bulle, à un moment choisi du dialogue. Elle peut créer ou modifier des éléments visuels dans la page du navigateur.
Déclencheurs
before_llm: avant l’appel au modèle.after_llm: après la réponse du modèle.before_tts: avant la synthèse vocale.
Périmètre
Ce parcours ne fournit pas un terminal Python, Bash ou Node.js. Un bloc de code écrit dans le chat n’est pas, à lui seul, une configuration de la bulle. Le script enregistré est limité à 5 000 caractères et passe par des contrôles qui restreignent notamment le stockage global et certains accès réseau.
Le code agit dans la page avec accès au DOM : ces contrôles ne constituent pas un système d’exploitation isolé. Activez uniquement des scripts dont vous comprenez l’effet.
Description
La bulle Skill permet d'ajouter des compétences réutilisables à ton agent : des prompts experts, sauvegardés et chargés automatiquement quand l'agent en a besoin.
Fonctionnement
- Crée une compétence avec un titre, une description de son usage et son contenu (prompt expert)
- L'agent charge la compétence automatiquement quand elle est pertinente
- Une compétence peut être configurée pour être chargée dès le début de la session
Cas d'usage
- Un prompt expert réutilisable (rédaction, code, traduction…)
- Une procédure métier que l'agent doit suivre à la lettre
- Un savoir-faire que tu partages entre plusieurs agents
Partager un agent dans Bubblai
L’export d’agent produit un JSON ou un ZIP, réimportable dans Bubblai. Vous choisissez d’inclure ou non le contenu des bulles Documents. Un ZIP peut aussi servir à transporter les éléments visuels de l’agent.
Dans ce parcours de partage, la bulle Mémoire est exclue et les champs de clés API sont filtrés. Relisez néanmoins les textes et documents que vous choisissez d’inclure.
Héberger un widget — Full
L’export d’intégration produit un ZIP avec un fichier PHP, une page HTML de test et, si nécessaire, des documents. Il nécessite un hébergement exécutant PHP et un accès à l’API du fournisseur. Ce widget n’est pas une copie complète de toutes les fonctions de Bubblai.
Référence technique
Les réglages, les données et les limites à connaître pour construire un agent qui fonctionne.
Une clé API donne accès à un fournisseur de modèles. Elle ne remplace pas les crédits ou l’activation de facturation éventuellement nécessaires chez ce fournisseur.
| Mode | Ce qu’il apporte |
|---|---|
| Crédits de découverte | Un essai sans clé personnelle, dans les limites et capacités affichées par Bubblai. Leur disponibilité n’implique pas l’accès à tous les outils. |
| Votre clé API (BYOK) | L’accès aux modèles autorisés par votre compte fournisseur. La consommation de conversation, d’image, de vidéo ou de voix est facturée selon son offre. |
| Licence Full | Débloque notamment les connecteurs Composio et l’intégration d’un agent dans un site. Elle ne fournit pas un crédit API illimité. |
Configurer puis vérifier
- Créez une clé dans la console officielle du fournisseur que vous souhaitez utiliser.
- Dans les réglages de Bubblai, choisissez le fournisseur correspondant, renseignez la clé et enregistrez-la. Attendez le résultat de la validation.
- Sélectionnez un modèle accessible à ce compte, puis envoyez un message court.
- Pour Image, Vidéo ou Realtime, ouvrez aussi la bulle correspondante et vérifiez son fournisseur et ses réglages.
Si la clé est valide mais que la requête échoue, vérifiez les crédits, les droits d’accès au modèle et les limites du fournisseur. Un abonnement à une application de chat ne suffit pas nécessairement à activer son API.
L’essai gratuit peut imposer des temps d’attente. La limite de 12 bulles dans la constellation est une limite d’interface, distincte des crédits et de la licence.
Stockage local ne signifie pas traitement entièrement hors ligne. Bubblai conserve des configurations et contenus dans le navigateur, puis transmet les informations nécessaires aux services sollicités.
| Information | Stockage ou transmission |
|---|---|
| Agents, bulles et conversations | Persistance locale via localStorage et IndexedDB selon le contenu. Changer de navigateur, de profil ou de domaine ne transfère pas automatiquement ces données. |
| Message et contexte utile | Envoyés au modèle choisi pour obtenir une réponse : consignes, historique retenu et extraits utiles peuvent en faire partie. |
| Clés API | Enregistrées dans le navigateur. Certains parcours les transmettent aux relais PHP de Bubblai, notamment pour leur validation ou pour créer une session xAI Realtime. |
| Documents, images et voix | Des extraits, médias ou flux audio sont transmis aux services utilisés pour les analyser, les générer ou les traiter. |
| Services connectés | Les demandes passent par le service connecté et, selon le parcours, par Composio et les endpoints Bubblai. |
Avant d’effacer les données du navigateur, conservez les exports utiles. L’export d’un agent n’est pas une sauvegarde complète de tous vos fils et souvenirs. Les règles de conservation des prestataires relèvent de leurs propres politiques ; consultez aussi la politique de confidentialité de Bubblai.
- Rôle et Instructions apportent le personnage, le ton et les règles enregistrés dans les bulles connectées.
- Skill présente les compétences disponibles. Leur contenu peut être chargé à la demande du modèle ; une option permet aussi le chargement en début de session.
- Documents fournit des extraits sélectionnés selon la question. Cela ne garantit pas que toutes les pages d’un fichier sont présentes dans chaque requête.
- Mémoire et projet complètent le contexte selon le parcours actif. La mémoire déclarative est distincte des messages déjà présents dans un fil.
- Outils ajoutent des actions disponibles. Le modèle peut demander leur exécution ; le résultat est ensuite utilisé dans la conversation.
Comparer proprement deux configurations
Changez une seule bulle à la fois et recommencez dans un nouveau fil. Déconnecter une bulle n’annule pas les informations déjà échangées. Si deux consignes se contredisent, simplifiez-les et rendez leurs priorités explicites.
Pour une question documentaire, demandez le nom du fichier et un passage court justificatif. Si un PDF est un scan, l’extraction de texte peut être insuffisante ; testez d’abord une page lisible ou une version texte.
La bulle Action décrit une opération personnalisée. Pour appeler un service HTTP, il faut une définition comprenant un nom, une requête (URL et méthode), les paramètres attendus et l’authentification nécessaire. Un texte qui décrit une action ne configure pas à lui seul une API.
La bulle Connecteurs propose des services déjà intégrés, notamment Gmail, Google Calendar, Google Tasks et Google Drive. Le parcours Composio demande une licence Full et une autorisation de connexion au compte concerné.
Premier essai
- Connectez un seul service et vérifiez le compte utilisé.
- Commencez par une opération de lecture, par exemple consulter une liste de fichiers.
- Vérifiez le résultat retourné par l’outil et sa présence dans la conversation.
- Pour une écriture, identifiez d’abord l’objet précis et le résultat souhaité. Une phrase de l’agent annonçant une réussite ne remplace pas le résultat du service.
Les requêtes peuvent échouer à cause des autorisations, d’une URL incorrecte, des règles CORS ou des limites de l’API. Le code prévoit un repli par relais pour certains appels GET ; cela ne garantit pas la compatibilité avec toutes les API ni toutes les méthodes.
Dans une bulle Exécution, choisissez after_llm, enregistrez le script suivant et connectez la bulle. Envoyez ensuite un message à l’agent et acceptez l’avertissement d’exécution si vous souhaitez lancer ce code.
let badge = document.getElementById('bubblai-guide-badge');
if (!badge) {
badge = document.createElement('div');
badge.id = 'bubblai-guide-badge';
badge.style.cssText = 'position:fixed;bottom:16px;left:16px;z-index:1000;padding:10px 14px;background:#151e3c;color:#e8f0f8;border:1px solid #00d4ff;border-radius:10px;pointer-events:none';
document.body.appendChild(badge);
}
badge.textContent = 'Dernière réponse : ' + responseText.length + ' caractères';
Résultat attendu : un petit indicateur apparaît en bas de la page après une réponse. Une nouvelle réponse met à jour le même élément. Déconnectez la bulle pour arrêter les prochains déclenchements ; rechargez la page pour retirer l’élément visuel.
| Variable | Usage |
|---|---|
userText, responseText | Message utilisateur et réponse, lorsqu’ils sont fournis par le déclencheur. |
currentSentence, voiceConfig | Contexte de synthèse vocale lorsque disponible. |
conversationHistory, hookName | Historique fourni au script et nom du déclencheur. |
bubble | Espace propre à cette bulle pendant la vie de la page ; ce n’est pas une sauvegarde durable. |
Une variable peut être vide selon le déclencheur. Évitez de supposer qu’un événement représente exactement un tour de conversation : une mise à jour de la page peut provoquer plusieurs appels. L’exemple réutilise donc un élément identifié au lieu de créer un nouveau badge à chaque passage.
Le parcours ci-dessous utilise l’exemple Meccanoid G15 + ESP32. Il faut le firmware de ce projet et son montage ; une carte ESP32 vierge ne comprend pas ces commandes.
- Ouvrez Bubblai en HTTPS dans Chrome sur un système compatible Web Bluetooth. Activez le Bluetooth et allumez l’ESP32.
- Ouvrez la bulle Communication, choisissez Bluetooth et lancez le scan. Sélectionnez Mecanoid dans la fenêtre du navigateur.
- Envoyez
[YEUX_BLEU]dans le champ de commande. Vérifiez que les yeux du robot deviennent bleus avant de tester des mouvements. - Enregistrez la configuration. Donnez à l’agent les commandes réellement disponibles, puis testez leur déclenchement depuis la conversation.
- Ajoutez ensuite Realtime si vous souhaitez une conversation vocale. La connexion BLE et la session vocale sont deux liaisons distinctes.
| Service UART Nordic | 6e400001-b5a3-f393-e0a9-e50e24dcca9e |
|---|---|
| Écriture vers l’appareil | 6e400002-b5a3-f393-e0a9-e50e24dcca9e |
| Format envoyé | Texte UTF-8 suivi d’un saut de ligne (\n). |
Compatibilité et diagnostic
Web Bluetooth exige un contexte sécurisé et une action de l’utilisateur pour choisir l’appareil. Chrome sur Android ou sur un ordinateur compatible est le point de départ de ce guide. Sous Linux, consultez le réglage expérimental indiqué par la documentation officielle Chrome. N’assimilez pas BLE à Bluetooth Classic.
Pour vérifier une liaison, observez l’effet réel de la commande. Le bouton de test générique de la bulle ne constitue pas un accusé de réception matériel. Ajouter un appareil manuellement ne donne pas au navigateur une capacité Bluetooth qu’il n’a pas.
L’envoi direct BLE ne garantit pas la remontée de tous les messages du firmware dans le chat. Pour les autres cartes et les modes série, Wi-Fi ou REST, il faut vérifier le protocole, le script et les permissions du navigateur. Les possibilités de Web Serial ne prouvent pas à elles seules qu’un parcours Bubblai est configuré.
| Export | Contenu et destination |
|---|---|
| Agent JSON/ZIP | Configuration destinée à être importée dans Bubblai. Mémoire exclue ; champs de secrets filtrés. Documents inclus seulement si vous le choisissez. Des éléments visuels peuvent entraîner la création d’un ZIP même sans documents. |
| Widget PHP — Full | Paquet d’hébergement avec PHP, page HTML de test et éventuels documents. Contient une clé API encodée de façon réversible et peut inclure des souvenirs ; gardez les fichiers sources privés. |
Vérifier un agent à partager
- Ouvrez l’agent à exporter et enregistrez vos changements.
- Lancez son export et choisissez explicitement avec ou sans documents.
- Importez le fichier téléchargé dans Bubblai. Ouvrez les bulles Rôle, Instructions et Documents pour vérifier leur contenu.
- Renseignez les clés et reconnectez les services nécessaires dans l’environnement de destination.
- Testez une demande simple avant de transmettre l’export à quelqu’un d’autre.
Préparer un widget
Décompressez le paquet dans un environnement PHP de test privé et suivez son fichier README. Vérifiez les documents et souvenirs inclus, la facturation des appels et l’accès aux fichiers avant d’ouvrir le widget au public. Un simple hébergement de fichiers HTML ne suffit pas à exécuter PHP.
La mémoire exclue de l’export d’agent ne doit pas être confondue avec le contenu possible du widget. N’utilisez pas le paquet d’hébergement comme un fichier de partage public.
| Symptôme | Premier contrôle |
|---|---|
| Le caractère ne change pas | Vérifiez l’agent sélectionné, le contenu enregistré et la connexion de la bulle Rôle. Comparez dans un nouveau fil. |
| L’agent décrit une image mais ne la génère pas | Vérifiez la bulle Image, son fournisseur et sa clé. Demandez explicitement de générer l’image. |
| Une information du document manque | Vérifiez que le fichier est présent, actif et lisible. Posez une question sur une phrase précise avant de demander une synthèse générale. |
| Le modèle refuse la requête | Relevez le message exact ; vérifiez la clé, les crédits et l’accès au modèle. Réessayez avec un message court. |
| Realtime ne démarre pas | Vérifiez le fournisseur de la bulle, la clé, les droits du microphone et le réseau. Testez d’abord le chat texte. |
| Le robot reste muet | Vérifiez le firmware, l’appareil BLE choisi et une commande manuelle connue. Déconnectez l’autre application éventuellement reliée au robot. |
| Les données semblent avoir disparu | Vérifiez le navigateur, son profil et le domaine utilisés. Une session privée ou un autre appareil ne reprend pas automatiquement le stockage local. |
Pour signaler un problème, indiquez le navigateur, le système, les bulles utilisées, les étapes et le message d’erreur exact à contact@bubblai.fr. Retirez les clés API et les documents privés de vos captures.