Documenter Google AppSheet avec Teamapps

Documenter une appli en No-Code/Low-Code, qu’il s’agisse d’AppSheet ou d’une autre plateforme, est un travail exigeant. Et c’est un exercice primordial : qu’il s’agisse de transmettre l’appli à quelqu’un d’autre, ou à soi-même (tu sais, quand il faudra la faire évoluer dans un mois – tu vois de quoi je parle !), la documentation s’avère toujours utile.

Chez Codergo nous utilisons autant que possible l’outil Whimsical pour une approche essentiellement visuelle de la documentation. Cependant, cela n’exclut pas de rédiger de façon plus traditionnelle un document structuré.

Nous avons testé chez Codergo un outil fantastique, basé sur ChatGPT-3.5, en alpha-test. Et le résultat est prometteur !

Note : au moment d’accéder à la version alpha de Teamapps, OpenAI rendait publique le nouveau moteur ChatGPT-4.

Comment fonctionne Teamapps ?

Teams fonctionne très simplement : il faut installer une extension sur Google Chrome, créer son compte et accorder les autorisations demandées, puis ouvrir la page My Apps de Google AppSheet.

Une icône en bas à droite de la fenêtre indique que la structure des applis est en train d’être analysée.

Une fois terminé, on peut aller sur le site de Teamapps : on retrouve la liste de toutes les applis auxquelles nous avons accès, et qui ne demandent qu’à être documentées.

Une fois l’application sélectionnée, l’interface de documentation s’affiche.

Cette interface est constituée de différentes sections :

• Purpose (Objet de l’application)
• Description
• Data Source Summary (Synthèse des sources de données)
• Liste des tables et des slices
• Liste des actions utilisateurs

Au départ, chaque section est vide : il revient à l’utilisateur de cliquer sur le bouton “Generate” (Générer) pour chacune des sections. Celui-ci lance alors la génération de la documentation pour la section concernée !

Une fois la génération terminé, nous avons la possibilité de re-générer, modifier le texte, puis l’enregistrer.

Note : la génération de cette documentation utilise un certain nombre de jetons (“tokens”). Ceux-ci sont achetables, mais dans le cadre de mon essai j’ai pu utiliser un crédit de 30 000 tokens. Lors de mon essai, une génération consommait environ 1000 tokens.

Quel bilan de l’essai ?

Très prometteur !

Actuellement, la génération va fonctionner pour les tables, les slices et les actions “simples”. La partie concernant les robots n’est pour l’instant pas gérée. Dans le cas d’actions complexes du type groupe d’actions ou “lancer une action sur un groupe de lignes”, la génération fonctionne mais sera imprécise.

Et c’est normal ! ChatGPT n’est pas à proprement parler une Intelligence Artificielle au sens où le moteur n’interprète pas la sémantique de ce qu’on lui demande, mais va générer un texte qui correspond à la plus forte probabilité de réponse correcte selon un corpus de référence donné. De nombreux utilisateurs sur le web se sont d’ailleurs amusés à tester, illustrer et exploiter cet outil en connaissance de cause.

A titre personnel, j’ai énormément apprécié l’outil. En effet, le texte généré peut comporter des erreurs. Je n’ai donc qu’à lire et éventuellement corriger le texte s’il me paraît incorrect, ce qui est une moindre peine. Sur la dizaine de paragraphes générés, je n’ai constaté qu’une seule incohérence. Le gain de temps est immense !

Perspectives

J’ai pu faire une visio avec Damien Hugues, le fondateur Australien de Teamapps, pour partager mon ressenti en tant qu’alpha-testeur. Il a vu très juste sur l’intérêt de son outil !

Parmi les retours qu’il a eus d’autre utilisateurs, il lui a été rapporté que l’outil serait utile en termes de générateur de mode d’emploi. C’est un excellent cas d’usage possible !

Nous avons pu échanger sur l’opportunité d’obtenir une représentation visuelle de l’appli, un peu comme ce qui existe déjà dans la section Manage > Data > Relationships de l’éditeur d’applications déjà accessible nativement (celle-ci laisse cependant à désirer).

Damien m’a indiqué qu’avec la sortie d’une prochaine version de Teamapps utilisant la version de ChatGPT-4, il sera a priori possible d’aller plus loin : interface de génération un peu différente, gestion plus fine des autorisations d’analyse, génération d’une documentation plus harmonieuse, génération de schéma de fonctionnement, et utilisation du matériau qu’on jugera bon de fournir à l’outil (image ou texte).

Conclusion

Cette version alpha de Teamapps utilisant ChatGPT-3.5 est plutôt réussie, et pourra servir pour des usages simples. Elle est très prometteuse pour la suite !

Chez Codergo nous attendons la sortie de la prochaine version alpha utilisant cette fois ChatGPT-4 pour exploiter à fond ses nouvelles capacités ! Sortie qui est d’ailleurs imminente, nous referons un article à cette occasion !

Et vous, que pensez-vous de cet outil ?

Vous avez un projet pour une appli ou une formation AppSheet ? C’est ici que ça se passe !