Le livrable de valeur, c'est la liste des questions auxquelles vous ne pouvez pas répondre
Une FAQ écrite de l'intérieur répond aux questions que l'équipe trouve intéressantes. Les utilisateurs en ont d'autres, regroupées à des endroits prévisibles : limites, bords de tarifs, pannes, et ce que le produit ne fait pas. La documentation y est la plus mince.
Générer les questions à partir de la documentation seule reproduit l'angle mort. Les générer à partir de quelqu'un qui n'a pas utilisé le produit, non, parce que ce lecteur interroge les frontières plutôt que les fonctions.
Ensuite, chaque question est répondue strictement à partir de la source, ou pas du tout. Une question que la documentation ne peut pas étayer n'est pas un échec du flux. C'est la découverte.
Deux sorties apparaissent : une FAQ publiable et une liste classée de ce qui manque à la documentation. La liste d'écarts se périme vite et vaut davantage.
Comment l'ActionFlow s'exécute sur le canevas
La documentation entre dans le flux via Document Upload, ou un nœud Scrappey quand la doc est publiée sur le web. PDF4me gère celles qui arrivent en PDF.
Un nœud Generate Object produit des questions candidates, instruit d'écrire depuis la position d'un évaluateur de première fois plutôt que d'un mainteneur. Il les renvoie comme un tableau avec une estimation de la fréquence de chacune.
Un nœud Loop parcourt les questions. Dedans, un nœud Generate Text tente une réponse en n'utilisant que la documentation fournie et renvoie un vide explicite quand la source n'en étaye pas une.
Un nœud Filter scinde les questions répondues des non répondues. Les paires répondues vont dans Notion comme FAQ publiable. Les questions sans réponse vont vers un ticket Linear ou Jira comme travail de documentation, ordonnées par l'estimation de fréquence.
Un nœud Validate se place avant publication et rejette toute réponse qui contient une affirmation sans passage d'appui, c'est le contrôle qui empêche une FAQ générée d'inventer une limite en silence.
Lancer ceci après chaque version significative garde la liste d'écarts à jour. La documentation change, les questions non. C'est pourquoi la liste d'écarts est la partie qui bouge.
Nœuds utilisés par cet ActionFlow
- Document Upload (Data) : ingère les fichiers de documentation. Scrappey (Util) récupère la doc publiée à la place.
- PDF4me (Data) : extrait le contenu de la documentation PDF.
- Generate Object (AI Core) : produit des questions candidates depuis une position d'extérieur, comme un tableau classé.
- Loop (Control) : parcourt les questions une à la fois.
- Generate Text (AI Core) : répond strictement à partir de la source, en renvoyant vide là où il ne peut pas.
- Validate (Data) : rejette les réponses qui affirment quoi que ce soit que la source n'étaye pas.
- Filter (Data) : scinde les paires répondues de la liste d'écarts.
- Notion (Integration) : reçoit la FAQ publiable. Linear ou Jira reçoit les écarts de documentation.
Questions fréquentes
Newsletter
Recevoir les mises à jour produit
Nouveaux nœuds, agents et notes produit. Nous n'envoyons un e-mail que lorsqu'il vaut la peine de l'ouvrir.