Corregir errores de flujos de trabajo con IA

Descripción

Cuando un paso de un flujo de trabajo falla o registra una advertencia, el asistente de corrección con IA lee ese error, determina qué lo causó y, cuando la causa es una configuración incorrecta del propio paso, propone una configuración corregida y la aplica una vez que usted la aprueba. Va más allá de explicar el error: puede hacer el cambio por usted.

Forma parte de Weave AI de PlaidCloud y se abre desde el visor de Registro del proyecto, ya dirigido al paso que falló. También se abre desde un problema en la pestaña Weave del proyecto.

Abrir el asistente de corrección

Desde la pestaña Registro del proyecto, junto a la entrada de registro sin procesar:

Abra el proyecto y haga clic en la pestaña Registro.
En la lista del registro, seleccione la entrada del paso que falló. Su mensaje completo (incluido cualquier seguimiento de pila) se abre en el panel de la derecha, en la pestaña Mensaje de registro.
Cambie ese panel a la pestaña Asistente de IA.

El chat del Asistente de IA se abre ya dirigido al flujo de trabajo y al paso de los que procede la entrada de registro seleccionada, por lo que empieza a diagnosticar de inmediato: no tiene que indicarle qué paso falló. Puede leer el error sin procesar en Mensaje de registro y conversar con el asistente en Asistente de IA en paralelo. Para algunos errores comunes, su primera respuesta es una explicación; consulte Errores comunes.

Desde la pestaña Weave

En la pestaña Weave del proyecto, haga clic en Corregir en la tarjeta de un problema que Weave encontró. El asistente se abre en su propia ventana, ya dirigido al paso del que trata el problema, y parte del problema tal como Weave lo informa ahora. Consulte Corregir un hallazgo con el asistente de IA para saber qué hallazgos ofrecen Corregir.

Cómo funciona

Diagnostica: lee la configuración del paso que falló y las tablas y columnas que utiliza, y verifica sus afirmaciones con sus datos en lugar de adivinar solo a partir del texto del error.
Propone: si encuentra una configuración incorrecta real, muestra el cambio en una tarjeta: Por qué falló en una frase y, después, un recuadro por cada configuración que cambia, con el nombre que tiene en el formulario del paso cuando es posible, con el valor actual en rojo y el valor nuevo en verde. Solo se enumera lo que cambia: en una lista de columnas, solo las columnas que cambian. En este punto no se guarda nada.
Usted aprueba: seleccione Aprobar N cambios en la tarjeta, o Ahora no para dejar el paso como está. También sirve responder con sus propias palabras. Los botones quedan disponibles cuando el asistente ha terminado su respuesta, y su aprobación siempre llega en un mensaje posterior a la propuesta.
Aplica: una vez que usted aprueba, escribe el cambio en el paso, a través de la misma vía que usa el editor de pasos. Lo que se guarda es el cambio de la tarjeta, y una aprobación lo guarda una sola vez. Justo antes de guardar, conserva una copia de la configuración del paso tal como está, para que pueda deshacer la corrección; consulte Deshacer una corrección.
Ofrece volver a ejecutar: una segunda tarjeta pregunta si desea volver a ejecutar el paso ahora para confirmar la corrección. Si la aprueba, el asistente ejecuta el paso e informa de si se completó correctamente, terminó con una advertencia o volvió a fallar; un nuevo fallo es un error que después diagnostica. Si el paso no ha terminado en dos minutos, lo indica, y el resultado aparece en el flujo de trabajo y en la pestaña Registro.

El asistente no ofrece volver a ejecutar un paso que contabiliza en un sistema ERP o ejecuta otro flujo de trabajo (vuelva a ejecutarlo desde su flujo de trabajo, donde elige el modo de contabilización en ERP), ni cuando el chat no está vinculado a un flujo de trabajo, ni cuando su rol no puede ejecutar flujos de trabajo. Si el flujo de trabajo ya se está ejecutando, no se ejecuta nada y el asistente ofrece intentarlo de nuevo.

Cada propuesta, su aprobación o rechazo y el propio cambio se registran en el historial de actividad de Weave del proyecto, con exactamente lo que el cambio reemplazó y escribió. Su aprobación se registra antes de que se haga el cambio. Si no se puede registrar, no se guarda nada y la tarjeta lo indica, y puede aprobarlo de nuevo más tarde.

Deshacer una corrección

La tarjeta de una corrección indica cuándo se puede deshacer: Weave conserva una copia de la configuración actual del paso, por lo que puede deshacer esto durante un tiempo limitado, a menos que el paso se cambie de nuevo antes. Una tarjeta sin esa línea no se puede deshacer. Si Weave no puede conservar la copia, no guarda nada y lo indica, y puede pedírselo de nuevo.

Una vez guardada la corrección, la tarjeta muestra Deshacer. La entrada de la corrección en el historial de actividad de Weave del proyecto tiene el mismo botón, por lo que puede deshacer una corrección después de cerrar su chat. Cualquier persona cuyo rol pueda cambiar pasos en el proyecto puede deshacer una corrección, no solo la persona que la aprobó.

Deshacer abre una ventana que muestra lo que se restaurará al deshacer: cada configuración que la corrección cambió, tal como está Actual y tal como quedará Después de deshacer. Luego elija:

Deshacer: restaura la configuración del paso tal como estaba justo antes de la corrección.
Deshacer y ejecutar: la restaura y luego ejecuta el paso. Se ofrece cuando su rol puede ejecutar flujos de trabajo, el paso sigue en el flujo de trabajo en el que se hizo la corrección (o, si no, está en un solo flujo de trabajo), puede abrir ese flujo de trabajo y el paso no contabiliza en un sistema ERP ni ejecuta otro flujo de trabajo. La ejecución en sí no se puede deshacer.
Cancelar: deja el paso como está.

Deshacer cambia solo la configuración del paso. Los datos que ya han escrito las ejecuciones del paso permanecen como están: vuelva a ejecutar el paso para reconstruirlos.

Weave no deshará una corrección, y no cambiará nada, cuando:

El paso ha cambiado desde la corrección. Deshacer restauraría una configuración obsoleta, por lo que la ventana muestra el paso como está Actual junto a su configuración Antes del cambio de Weave, y usted puede cambiarlo por su cuenta.
El paso ya tiene la configuración que tenía antes de la corrección.
La copia ya no se conserva. Las copias se conservan durante un tiempo limitado.
Su rol no puede cambiar el paso, o el proyecto está bloqueado.
Weave no pudo registrar la acción de deshacer. Inténtelo de nuevo más tarde.

Una acción de deshacer se registra en el historial de actividad como un cambio propio, por ejemplo Hecho según lo aprobado: deshacer el cambio de Weave en la configuración de un paso.

Errores comunes

Cuando un paso falla con uno de estos errores comunes, la primera respuesta es una explicación que PlaidCloud ya tiene para ese tipo de error, por lo que aparece de inmediato.

En cualquier tipo de paso:

una expresión que usa una columna que no está en la tabla que lee el paso
una asignación de columnas cuya columna de origen no está en la tabla que lee el paso
una configuración que el paso necesita y que se dejó vacía, como la conexión que usa o la tabla que lee
un flujo de trabajo que ejecuta el paso y que falló: lo más probable es que la causa esté en uno de los pasos de ese flujo de trabajo, así que revise el registro de ese flujo de trabajo
una tabla que el paso nombra y que no se encuentra
un almacén de Snowflake o Databricks que bloquea la dirección de PlaidCloud, rechaza su inicio de sesión, ha agotado su cuota, no se encuentra o no se puede usar, o carece de un privilegio que necesita el rol de PlaidCloud

En un paso SQL Extract:

SQL que no se puede leer tal como está escrito, como una palabra clave mal escrita o un paréntesis sin cerrar
una función que la base de datos no reconoce
una tabla que no existe
una función a la que se le da un tipo de valor con el que no puede trabajar, como sumar una columna de texto (en Databend)
un valor que no se puede convertir al tipo que pidió el SQL, como texto donde se esperaba un número o una fecha (en Databend)

En un paso Table Extract, con correcciones que apuntan a las pestañas y campos propios del paso en lugar de a SQL:

una tabla de origen que aún no existe, o que ya no existe (en Databend)
una expresión que usa una función que la base de datos no reconoce (en Databend)
una función a la que se le da un tipo de valor con el que no puede trabajar, como sumar una columna de texto en una expresión o con Resumir (en Databend)
un paso sin columnas de salida, como uno al que se le quitaron todas las columnas

La explicación indica qué suele causar el error, en qué palabras del mensaje de error debe fijarse y cómo corregirlo. Es general: no comprueba su paso ni cambia nada. Para que el asistente examine el propio paso, responda. A partir de ese momento funciona como se describe en Cómo funciona, con la explicación como parte de la conversación.

Cualquier otro error pasa directamente al diagnóstico propio del asistente. Eso incluye los errores de base de datos enumerados arriba cuando proceden de cualquier otro tipo de paso.

Qué puede corregir

El asistente repara la configuración del único paso del que procede el error, por ejemplo un nombre de columna o de función mal escrito, una expresión no válida, un tipo de datos o una conversión incorrectos, o SQL con formato incorrecto. Cambia lo mínimo que corrige el error: un fallo, un cambio específico, y el resto de la configuración queda como estaba.

Una expresión que falla (en una columna, un filtro o una cláusula having) se entrega al mismo especialista en expresiones que acompaña al Editor de expresiones, con el error y las columnas de la tabla de origen. La expresión corregida que devuelve se comprueba antes de proponerse, y la propuesta sigue siendo un cambio en ese único campo del paso, aprobado igual que cualquier otro.

Qué no hará

Su única palanca es la configuración de ese paso, y es claro cuando el problema está en otro lugar en vez de forzar una edición para que parezca una solución.

Edita la configuración de un solo paso y nada más: no creará, eliminará ni reordenará pasos, no creará tablas, no editará un paso distinto ni cambiará sus datos.
Muchos fallos no son problemas de configuración: datos de origen ausentes o con formato incorrecto, un paso anterior que falló primero, un error transitorio o de infraestructura, un problema de permisos, Python defectuoso en una UDF o en un paso de código de usuario, un archivo ausente en una cuenta de documentos, o un límite de recursos o de tiempo. En esos casos explica lo que encontró y le indica dónde está la solución real.
Las advertencias suelen ser inofensivas y no requieren ningún cambio: lo dirá con claridad en lugar de inventar una edición.
Cuando no está seguro de que un cambio vaya a funcionar, lo dice y nombra de qué no está seguro en lugar de presentar una suposición como una certeza.

Consejos

El diagnóstico se basa en la configuración activa de su paso y en los metadatos de las tablas, por lo que refleja el proyecto tal como está ahora, no una forma almacenada en caché ni supuesta.
Después de aplicar una corrección, responda que sí cuando el asistente ofrezca volver a ejecutar el paso, o vuelva a ejecutarlo usted, para confirmar que el error está resuelto.
Si el asistente dice que la causa está fuera de la configuración del paso (datos incorrectos, un fallo anterior, un problema de permisos), esa es la respuesta: corríjala donde realmente se encuentra en lugar de pedirle al asistente que edite el paso de todos modos.