Reescribirlo todo es cómo la documentación pierde su voz
Cuando corriges documentación desactualizada a gran escala, las páginas suelen reescribirse desde cero. Esa reescritura completa pierde las partes que hacían que la página valiera la pena conservar: el ejemplo en el que alguien pasó una tarde para dejarlo bien, la advertencia añadida después de una solicitud de soporte, o la redacción que un cliente te citó de vuelta.
Las correcciones útiles son estrechas: un nombre de parámetro, un valor por defecto y un paso que ahora ocurre en otro orden. El resto de la página se queda como lo escribió el autor original.
Para encontrar esa corrección pequeña, lees el código y la página, y luego detectas la oración concreta que está mal. Esa tarea es más difícil que regenerar la página. En este nivel de detalle, el agent propone ediciones y las muestra como un diff que un maintainer puede examinar en un minuto. Nada se publica. Quien posee la página decide.
Cómo se construye el agent en Agent Studio
Los prompt skills sostienen la titularidad de la documentación, tu guía de estilo y las páginas que marcaste de propósito como simplificadas, que nunca deben corregirse por exactitud.
El system prompt exige que cada edición sea lo más pequeña posible, y que cite tanto la oración original como el código que la contradice.
Prohíbe reestructurar, cambios de tono y cualquier edición que no sea una corrección. Las mejoras que se le ocurren al agent van a una nota, no al diff.
Si la contradicción no se puede derivar del código entregado, el agent deja la sección sin cambiar. No edita a partir de una conjetura.
El nodo GitHub entrega el código cambiado y la fuente de la documentación. El nodo Agent Chat lee ambos. El cambio concreto es la pregunta.
Las ediciones sugeridas se envían como un pull request por el nodo GitHub, un pull request por página, con la contradicción en la descripción.
No ocurre ninguna fusión. Un nodo Human in the Loop envía cada pull request al dueño de la página. Las páginas marcadas como simplificadas nunca entran a la cola.
De qué está hecho este agent
- Prompt skills: titularidad, guía de estilo y las páginas dejadas de propósito simplificadas.
- System prompt: ediciones mínimas, con la oración y el código que contradice citados.
- System prompt: sin reestructurar, sin cambios de tono. Las mejoras van a una nota.
- System prompt: sin edición donde la contradicción no se puede establecer.
- GitHub (Integration): el código cambiado y la fuente de la documentación juntos.
- Agent Chat (Util): lee ambos, con el cambio concreto como la pregunta.
- Cuando un ActionFlow basta: Si solo necesitas que se marquen las secciones que un cambio contradice, construye el flujo de trabajo. Muchos equipos quieren solo la marca.
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.