
La salida valiosa es la lista de preguntas que no puedes responder
Un FAQ escrito desde adentro responde preguntas que el equipo encuentra interesantes. Quienes usan el producto tienen otras, agrupadas en lugares predecibles: límites, bordes de precios, fallas y lo que el producto no hace. Ahí la documentación es más delgada.
Generar preguntas solo a partir de la documentación reproduce el punto ciego. Generarlas desde alguien que no usó el producto no, porque esa lectora o lector pregunta por los bordes, no por las funciones.
Luego cada pregunta se responde de forma estricta a partir de la fuente, o no se responde. Una pregunta que la documentación no puede sostener no es un fallo del flujo. Es el hallazgo.
Surgen dos salidas: un FAQ publicable y una lista ordenada de lo que le falta a la documentación. La lista de huecos caduca rápido y vale más.
Cómo se ejecuta el ActionFlow en el lienzo
La documentación entra al flujo por Document Upload o por un nodo Scrappey cuando los docs están publicados en la web. PDF4me atiende los que llegan como PDF.
Un nodo Generate Object produce preguntas candidatas, con la instrucción de escribir desde la posición de quien evalúa por primera vez y no de quien mantiene. Las devuelve como un array con una estimación de qué tan común es cada una.
Un nodo Loop recorre las preguntas. Dentro, un nodo Generate Text intenta una respuesta usando solo la documentación suministrada y devuelve un vacío explícito cuando la fuente no sostiene una.
Un nodo Filter separa las preguntas respondidas de las no respondidas. Los pares respondidos van a Notion como un FAQ publicable. Las preguntas sin respuesta van a un issue de Linear o Jira como trabajo de documentación, ordenadas por la estimación de frecuencia.
Un nodo Validate se sienta antes de la publicación y rechaza cualquier respuesta que contenga una afirmación sin un pasaje de respaldo, que es el chequeo que impide que un FAQ generado invente un límite en silencio.
Correr esto después de cada release significativo mantiene actualizada la lista de huecos. La documentación cambia, las preguntas no. Por eso la lista de huecos es la parte que se mueve.
Nodos que usa este ActionFlow
- Document Upload (Data): ingiere archivos de documentación. Scrappey (Util) trae docs publicados en su lugar.
- PDF4me (Data): extrae el contenido de documentación en PDF.
- Generate Object (AI Core): produce preguntas candidatas desde la posición de alguien de afuera, como un array ordenado.
- Loop (Control): recorre las preguntas de a una.
- Generate Text (AI Core): responde de forma estricta a partir de la fuente y devuelve vacío donde no puede.
- Validate (Data): rechaza respuestas que afirman cualquier cosa que la fuente no sostiene.
- Filter (Data): separa los pares respondidos de la lista de huecos.
- Notion (Integration): recibe el FAQ publicable. Linear o Jira recibe los huecos de documentación.
Preguntas frecuentes
Empieza a crear flujos de IA
Crea una cuenta gratuita, abre una plantilla o un lienzo en blanco y ejecuta tu primer ActionFlow.
Boletín
Recibe actualizaciones del producto
Nodos nuevos, agents y notas de producto. Solo enviamos correo cuando merece la pena abrirlo.