AI Assistant for your software product

Qu’est-ce que les superflows ?

Superflows est un ensemble d’outils d’assistant IA intégré destinés aux équipes de produits SaaS. Les utilisateurs peuvent interroger les données du produit en langage naturel, obtenir des réponses dans des documents, générer des graphiques analytiques, et, une fois confirmé, faire en sorte que l’assistant appelle l’API du produit pour effectuer les opérations.

Le projet propose en même temps des services cloud hébergés, une console de développement, des composants d’interface React et un backend open source sous licence Apache-2.0. Le site officiel est encore accessible, mais le site des documents officiels n’est pas disponible et les mises à jour du code datent de longtemps ; il convient de vérifier l’état de la maintenance et du support avant d’effectuer un achat en production.

Une phrase pour présenter

Superflows combine OpenAPI, la documentation du produit, l’analyse de code et une interface de chat pour créer un Copilot IA pouvant être intégré dans des applications SaaS.

Composants essentiels

Appel de l’API du produit en langage naturel

Superflows lit les spécifications OpenAPI d’un produit, comprend les endpoints disponibles, les paramètres et les réponses, puis choisit la requête à envoyer en fonction de la question de l’utilisateur. Il convient aux produits SaaS disposant déjà d’une API stable.

• Télécharger la spécification OpenAPI pour une importation rapide des endpoints
• Sélectionner les opérations API autorisées pour l’assistant
• Convertir les questions en langage naturel en appels d’endpoint
• Combiner plusieurs réponses pour effectuer des requêtes complexes
• Organiser les résultats de l’appel en réponses lisibles
• Donner des explications pour les échecs, les permissions et l’absence de données
• Voir le plan et le processus d’appel en mode développeur

Analyse de données et graphiques

L’assistant peut écrire du code en fonction des données retournées par l’API pour effectuer des calculs et générer les graphiques nécessaires aux utilisateurs. Ainsi, l’équipe de produit peut réduire le nombre de tableaux de bord développés séparément pour chaque problème temporaire.

• Calculer des totaux, des tendances, des proportions et des classements
• Comparaison des périodes, des segments de clients et des canaux commerciaux
• Analyse combinée de données provenant de plusieurs points d’extrémité
• Générer des graphiques visuels adaptés aux questions
• Expliquer par des mots les résultats clés et les anomalies
• Restreindre les ressources de exécution du code et les dépendances autorisées
• Vérifier le montant, la zone horaire et la définition des indicateurs

Q&R basé sur des documents

Superflows utilise des méthodes d’amélioration par recherche pour répondre aux questions sur les connaissances statiques des produits, en pouvant relier simultanément des données API et des documents. Les utilisateurs peuvent à la fois demander comment utiliser une fonctionnalité et consulter leurs propres données commerciales.

• Importer les descriptions de produits et le contenu d’aide
• Rechercher des extraits pertinents en fonction de la question de l’utilisateur
• Générer des réponses cohérentes avec les fonctionnalités du produit
• Intégrer les connaissances et les données en temps réel dans un dialogue
• Réduire la fréquence à laquelle les utilisateurs quittent les documents de recherche de produits
• Détecter les contenus manquants ou obsolètes à partir des retours.

Exécuter des opérations sur le produit

L’assistant non seulement répond aux questions, mais peut également préparer des opérations telles que la création, la mise à jour ou le déplacement de données. Pour les actions susceptibles d’avoir un impact, Superflows présente d’abord le plan et demande l’approbation de l’utilisateur.

• Créer des tâches, des rappels ou des notes professionnelles
• Mettre à jour l’état des clients, des transactions ou des flux de travail
• Ajuster en masse les données qui répondent aux critères
• Afficher les actions et les paramètres avant l’exécution
• Exiger une confirmation explicite de l’utilisateur pour les opérations potentiellement destructrices
• Enregistrer les résultats des appels et les raisons d’échec
• Définir un contrôle de permissions supplémentaire pour les endpoints sensibles

Contrôle du comportement et format des réponses

L’équipe produit peut valider le format des réponses que l’assistant est autorisé à générer et contrôler les endpoints auxquels il a accès. Cela permet de réduire le risque que des réponses générées de manière libre s’écartent de la logique du produit.

• Prévoir des réponses, des tableaux et des graphiques comme formats possibles
• Restreindre la plage des points d’extrémité, des méthodes et des paramètres
• Appliquer des droits différents aux différents utilisateurs ou locataires
• Définir les chemins de confirmation, de refus et de support manuel
• Comparer le comportement attendu et le comportement réel dans Playground
• Collecter les retours positifs et négatifs des utilisateurs sur les réponses
• Élargir progressivement les capacités par des tests et des configurations

Developer Dashboard

La console des développeurs sert à télécharger les spécifications API, à configurer les actions, à gérer l’authentification des connexions, à utiliser un assistant de test et à consulter les statistiques d’utilisation. C’est l’entrée principale pour déployer rapidement une solution hébergée.

• Télécharger ou saisir manuellement l’endpoint API
• Sélectionner les actions que l’assistant peut appeler
• Configurer les paramètres d’authentification et de multi-locataires
• Envoyer des questions de test sur Playground
• Utiliser des réponses Mock pour valider les endpoints non connectés
• Vérifier le processus de planification en mode développeur
• Voir le nombre de recherches et les retours des utilisateurs

Composant de chat React

Le dépôt officiel chat-ui propose des composants React prédéfinis, qui peuvent être intégrés à l’aide de boutons, de fenêtres de chat, de boîtes modales ou de barres latérales. Ces composants s’intègrent rapidement et permettent aux équipes de produit de personnaliser les interactions.

• Utilisez SuperflowsButton pour une connexion rapide
• Utilisez SuperflowsChat pour obtenir une personnalisation accrue
• Contrôler le point d’entrée par Modal ou Sidebar
• Adapter la couleur du produit, le layout et le style de la marque
• Transférer le contexte de l’utilisateur actuel et du locataire
• Gestion des réponses en flux, des confirmations et des interactions de retour

Support SaaS multi-locataires

La solution Scale propose officiellement une API multi-locataires et un nombre illimité de comptes. Lors de sa mise en œuvre, il est impératif de s’assurer que chaque appel comporte l’identité du locataire correcte, afin d’éviter toute fuite de données entre clients.

• Associer les utilisateurs connectés au bon locataire
• Émission de preuves d’accès à court terme par le backend
• Vérifier les permissions du serveur à chaque point d’extrémité
• Interdiction de laisser le modèle juger seul des droits sur les données
• Enregistrer les locataires, les utilisateurs, les points d’extrémité et les résultats des opérations
• Utiliser des tests automatisés pour couvrir les tentatives d’accès non autorisé

Soutien aux modèles

La documentation du dépôt open source indique que le projet a pris en charge divers modèles tels que la série GPT, Mixtral, Llama, etc., et il est également possible d’utiliser des modèles ouverts dans des solutions auto-hébergées. Les versions compatibles actuelles doivent être confirmées par des tests de code et de déploiement.

• Choisir différents modèles en fonction de la planification, de l’analyse et des coûts
• Comparaison de la qualité entre les modèles gérés et ouverts
• Contrôler le contexte, la longueur de sortie et les frais de appel
• Concevoir des stratégies de fallback en cas d’indisponibilité du modèle
• Créer un ensemble d’évaluation à l’aide de tâches API réelles
• Éviter de considérer les modèles des anciens README comme une promesse de support continu

Scénarios d'utilisation typiques

• L’utilisateur CRM consulte les transactions et crée des tâches de suivi.
• Analyser les utilisateurs du produit pour générer des graphiques temporaires via la conversation
• Utilisateurs de logiciels financiers pour consulter les revenus, les coûts et les anomalies
• Mise à jour en masse des états de workflow pour les utilisateurs de la plateforme opérationnelle
• Les logiciels B2B complexes fournissent des guides d’utilisation intégrés au produit.
• Les produits de données permettent aux utilisateurs non techniques d’accéder à l’analyse du langage naturel
• Le SaaS vertical transforme les opérations API courantes en points d’entrée pour des dialogues.

Exemple de CRM Copilot

Le site officiel utilise CRM Copilot pour illustrer la valeur du produit : les utilisateurs peuvent demander quelles transactions doivent être priorisées, comparer les stratégies de acquisition de clients, et faire en sorte que l’assistant crée des tâches de rappel.

• Classer les opportunités par montant de la transaction et probabilité de clôture
• Analyser les liens historiques et recommandations pour la suite
• Créer un appel de suivi ou une tâche
• Contribution des indices selon différentes stratégies de prospection
• Utiliser des étapes de confirmation pour éviter des modifications massives erronées
• Laisser les permissions et l’audit suivre les règles du backend CRM.

Pour quels types d’équipes

• Entreprise SaaS disposant d’une API de produit stable et de spécifications OpenAPI
• Équipe de produits souhaitant valider rapidement un assistant IA intégré
• Applications nécessitant de répondre simultanément aux questions liées aux documents et aux données en temps réel
• Équipe d’ingénierie disposée à maintenir les permissions, l’évaluation et les contrôles de sécurité
• Entreprises ayant besoin de code open source ou d’une option self-hébergée
• Les équipes qui ne souhaitent pas développer à partir de zéro l’infrastructure de planification, de chat et de feedback

Prix de Superflows

Le site officiel présente actuellement trois plans : Testing, Scale et Enterprise. Le plan Scale coûte 999 dollars par mois, tandis que pour l’Enterprise il est nécessaire de contacter le service des ventes ; la description des fonctionnalités d’entreprise sur le site indique « All Growth features », ce qui ne correspond pas au nom actuel Scale ; une confirmation écrite doit être obtenue au moment de l’achat.

Vérifier le mode de mesure

Le site officiel définit une « Chat-to-API Query » comme un message envoyé par l’utilisateur depuis l’interface de chat qui déclenche une requête vers l’API du produit. La manière de mesurer les questions successives, les multiples endpoints, les tentatives de réessai en cas d’échec et les messages ne déclenchant pas l’API doit être précisée dans le contrat.

• Distinction entre les quotas de requêtes API et de requêtes de documentation
• Vérifier si l’appel d’un message à plusieurs endpoints est compté une seule fois.
• Méthode de calcul en cas d’échec de vérification, de tentative de réessai et de test du trafic
• Vérifier les prix en cas de dépassement, les limites de vitesse et les stratégies de désactivation
• Surveiller la consommation par locataire et utilisateur
• Estimer la concurrence en période de pointe et savoir si les coûts du modèle sont inclus

Services de validation conceptuelle

Le site officiel propose des ateliers et un processus de PoC de deux semaines : l’équipe évalue les besoins, crée un prototype adapté au scénario du client, qui est ensuite testé et ajusté par ce dernier avant de décider s’il est mis en production. Le délai réel dépend de la qualité de l’API, des certifications et de l’étendue des besoins.

1. Atelier de définition des besoins avec l’équipe Superflows.
2. Sélectionnez un petit nombre de requêtes et d’opérations à haute valeur.
3. Fournit des spécifications OpenAPI, des comptes de test et de la documentation.
4. L’équipe construit un PoC en environ deux semaines.
5. Évaluation à l’aide de tâches d’utilisateurs représentatifs.
6. Ajuster le format, les points d’extrémité et les règles de validation.
7. Mise en ligne après validation de la sécurité et du produit.

Guide rapide d’accès à la version gérée

1. Nettoyer et télécharger la dernière spécification OpenAPI.
2. Activer uniquement les endpoints lus nécessaires au projet pilote.
3. Vérifier la planification à l’aide de réponses Mock dans Playground.
4. Connecter l’API de test à des identifiants d’authentification à court terme.
5. Téléchargez les documents du produit ayant été vérifiés.
6. Installer le composant de chat React et transmettre le contexte de l’utilisateur.
7. Configuration de la confirmation, du feedback et du retour en cas d’erreur.
8. Mettre en ligne un faible débit et surveiller les requêtes ainsi que les résultats des opérations.

Tutoriel d’autogestion

1. Vérifier le code Apache-2.0, les dépendances et l’état des commits actuels.
2. Préparer Docker, l’environnement Node et Supabase local.
3. Créer une configuration d’variables d’environnement indépendantes à partir du fichier d’exemple.
4. Configurer la base de données, les identités, l’e-mail et les clés de modèle.
5. Démarrer le backend et les services associés dans un réseau isolé.
6. Importer les spécifications API et exécuter des tests de sécurité.
7. Mettre en place des processus pour les journaux, les sauvegardes, les mises à niveau et la correction des vulnérabilités.
8. Terminer les validations de licence, de performances et de reprise après sinistre avant la production.

Tutoriel sur la sécurité API

1. Classer les points d’entrée et de sortie en fonction du niveau de risque.
2. Par défaut, seules les opérations de lecture minimales nécessaires sont autorisées.
3. Vérification des droits des utilisateurs et des locataires par le backend du produit.
4. Une confirmation claire est requise pour l’action d’écriture.
5. Ajouter une clé d’idempotence, une vérification des paramètres et une limitation de vitesse.
6. Enregistrer chaque planification, appel et résultat final.
7. Couvre les dépassements de droits, l’injection de prompts et les tests de paramètres malveillants.
8. Vérifier régulièrement les modifications des endpoints et des spécifications OpenAPI.

Test et évaluation

L’équipe de produits doit créer des ensembles de test distincts pour les questions-réponses sur les documents, l’analyse de données et les actions d’écriture. Un succès uniquement lors des démonstrations ne suffit pas à prouver la fiabilité en production.

• Vérifier le choix des points d’extrémité et l’intégrité des paramètres
• Vérifier le calcul des valeurs, les fuseaux horaires et la définition des indicateurs
• Vérifier la cohérence entre le graphique comparatif et les données brutes
• Test sans données, délai d’attente et refus d’accès
• Valider une action dangereuse exige toujours une autorisation.
• Injection de suggestions simulées et accès entre locataires
• Enregistrer les retours des utilisateurs et les corrections manuelles
• Régression après mise à jour du modèle, de l’API ou de la documentation

Sécurité et confidentialité

Superflows gère les spécifications API des produits, les questions des utilisateurs, les réponses commerciales et le contexte d’authentification, ce qui constitue une intégration hautement sensible. Le site officiel des documents étant actuellement indisponible, les entreprises doivent demander directement les derniers documents relatifs à la sécurité, à la confidentialité et au traitement des données.

• Ne mettez pas de secrets à long terme directement dans les composants du navigateur
• Utiliser des tokens serveur à court terme avec les permissions minimales
• Vérifier à nouveau toutes les autorisations via l’API métier
• Données personnelles et commerciales sensibles limitant la visibilité du modèle
• Règles de conservation et de masquage pour les journaux et les retours
• Vérifier le fournisseur du modèle et la région de stockage des données
• Mettre en place des processus pour la suppression, l’exportation et les événements de sécurité
• Les clients self-hostés assument eux-mêmes les correctifs et la sécurité de l’infrastructure.

Évaluation de l’efficacité

Avantages du produit

• Assistant IA intégré spécialement conçu pour les produits SaaS
• Les actions de produit peuvent être importées rapidement à partir de la spécification OpenAPI.
• Prend en charge simultanément les appels API, les questions-réponses documentaires et l’analyse de données
• Être capable d’écrire du code pour calculer et générer des graphiques
• Mettre en place une confirmation par l’utilisateur pour les opérations potentiellement destructrices
• La console des développeurs prend en charge le mock et le débogage.
• Fournit des composants de chat React open source personnalisables
• Le backend principal est sous licence Apache-2.0
• Les chemins gérés et auto-gérés sont tous deux disponibles

Restrictions d'utilisation et précautions

• Le prix de Scale est de 999 dollars par mois, ce qui représente un coût élevé pour les petites équipes.
• L’abonnement gratuit ne comprend que un environnement de test et 50 requêtes.
• Les textes des forfaits sur le site officiel présentent une incohérence entre les termes « Growth » et « Scale ».
• Le site des documents officiels n’est pas disponible actuellement et le certificat est expiré.
• Les dernières mises à jour des principaux dépôts open source datent de 2024.
• Le pied de page du site indique qu’il y a eu un changement de direction dans l’activité de l’entreprise.
• Les guides d’autogestion restent incomplets et exigent de fortes compétences en ingénierie.
• Le code et l’analyse générés par l’IA peuvent présenter des erreurs de calcul.
• L’écriture via API et l’isolation multi-locataires doivent être strictement contrôlées par le backend.
• Avant d’acheter, il convient de vérifier le soutien offert, la feuille de route et les capacités actuelles du service client.

GitHub et le monde du logiciel open source

Superflows dispose d’une organisation officielle sur GitHub. Les dépôts principaux Superflows et chat-ui sont tous deux sous licence Apache-2.0, ce qui permet de les utiliser, de les modifier et de les distribuer conformément aux exigences de la licence.

Les organisations publiques comprennent également des dépôts de documents, d’agents de modèles, d’extensions de navigateur, etc. Le dépôt principal est bien que open source, mais il y a peu de contributions récentes ; avant le déploiement, il convient d’auditer les dépendances, les vulnérabilités de sécurité et la compatibilité avec les interfaces des modèles actuels.

Informations de base

Indice de recommandation

3,9 / 5. L’assistant piloté par OpenAPI de Superflows, l’analyse de données, le mécanisme de validation et le code Apache-2.0 restent utiles pour les équipes SaaS en termes de référence et d’hébergement auto-géré ; cependant, l’indisponibilité du site de documentation, le ralentissement des mises à jour du dépôt et l’incohérence dans la description des forfaits exigent une étude approfondie supplémentaire pour les achats en production.

Questions fréquentes

Qu’est-ce que Superflows fait principalement ?

Il aide les produits SaaS à intégrer des assistants IA capables d’appeler des API métier, de répondre aux questions documentaires et d’analyser des données.

Les Superflows peuvent-ils exécuter des opérations ?

Oui, il peut appeler l’endpoint d’écriture et demander la confirmation de l’utilisateur avant toute opération potentiellement destructrice.

Superflows prend-il en charge OpenAPI ?

Soutien : possibilité de télécharger des spécifications OpenAPI pour configurer rapidement les endpoints disponibles de l’assistant.

Combien coûte Superflows ?

Le test est gratuit, Scale coûte 999 dollars par mois, et pour Enterprise, il faut contacter le service des ventes pour obtenir un devis.

Qu’est-ce qu’une requête Chat-to-API ?

C’est un message que l’utilisateur envoie dans l’interface de chat et qui déclenche une requête vers l’API du produit.

Les Superflows peuvent-ils être auto-hébergés ?

C’est possible, mais la documentation officielle pour l’hébergement auto-géré est incomplète ; l’équipe doit configurer elle-même Supabase, les modèles, l’envoi d’e-mails et l’exploitation.

Superflows est-il encore entretenu ?

Le site officiel est toujours en ligne, mais le site des documents n’est pas accessible et les principaux dépôts ont été mis à jour il y a longtemps ; il est conseillé de se renseigner auprès des responsables avant d’effectuer des achats ou des déploiements.

Superflows est-il open source ?

Open source, le backend principal et les composants de chat React sont tous soumis à la licence Apache-2.0.