Los consumidores que conoces no son la lista
Cambiar un endpoint es una decisión que se toma contra una lista mental de consumidores, y la lista mental siempre es corta. El servicio interno que todos recuerdan, el cliente móvil, tal vez un socio. La integración armada hace dos años por un equipo que desde entonces se disolvió no está en ella.
La lista real está en dos lugares: el historial de la especificación, que dice cuál era el contrato, y los logs de acceso, que dicen quién la usó y qué tan reciente.
La rotura tampoco es uniforme. Un campo opcional quitado rompe al consumidor que lo lee y a nadie más. Saber cuál es cuál convierte un anuncio amplio en tres conversaciones concretas.
Producir la lista antes del cambio es barato. Producirla después es un incidente.
Cómo se ejecuta el ActionFlow en el lienzo
Los archivos de especificación los lee un nodo GitHub en ambas versiones. Un nodo Extract Data reduce cada una a su superficie: endpoints, parámetros, marcas de requerido y campos de respuesta.
Un nodo Generate Object los compara y devuelve el conjunto de cambios como diferencias tipadas (quitado, renombrado, ahora requerido, tipo cambiado), no como un diff textual.
Un nodo HTTP Request extrae identidad de consumidores y patrones de llamada de tu gateway o analítica del período que fijaste. Un nodo Uniq los reduce a consumidores distintos.
Un nodo Loop recorre esos consumidores. Por cada uno, un nodo Generate Object devuelve cuáles de las diferencias tipadas aplican a lo que ese consumidor de hecho envía y lee.
Comparar contra llamadas observadas, no contra la especificación, es la decisión que hace verdadera la salida. La mayoría de los consumidores usan una fracción de un endpoint.
Un nodo Filter descarta a los consumidores a los que nada toca, que suele ser la mayoría. Un nodo Sort ordena el resto por severidad.
Un nodo Create Excel produce la tabla de impacto. Un nodo Linear abre la tarea de migración.
Un nodo Email del grupo Human in the Loop retiene el aviso al consumidor para tu aprobación. Nada va a un desarrollador externo sin que una persona lo libere.
Nodos que usa este ActionFlow
- GitHub (Integration): archivos de especificación en ambas versiones.
- Extract Data (Data): reduce cada versión a su superficie.
- Generate Object (AI Core): diferencias tipadas, no un diff textual.
- HTTP Request (Util): identidad de consumidores y patrones de llamada del gateway.
- Uniq (Control): consumidores distintos a partir de registros crudos de llamadas.
- Loop (Control) con Generate Object (AI Core): impacto por consumidor, contra llamadas observadas.
- Create Excel (Data): la tabla de impacto, ordenada por severidad.
- Email (Human in the Loop): los avisos externos esperan a una persona.
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.