Ir al contenido
PlaidCloud

Corrija un flujo de trabajo con el asistente de IA

~20 minutos · un paso fallido, un diagnóstico de IA, una corrección aplicada

Ejecuta un flujo de trabajo, un paso se pone en rojo y el texto del error por sí solo no le dice qué cambiar. Este tutorial recorre ese momento exacto: abre el Asistente de IA integrado de PlaidCloud, deja que diagnostique el paso fallido contra sus datos reales, aprueba la corrección que propone y vuelve a ejecutar para confirmarla. Después usa el mismo asistente para escribir un paso Extraer SQL a partir de una descripción en lenguaje natural.

Este es el Asistente de IA integrado en el producto que le ayuda a crear y corregir flujos de trabajo. No es lo mismo que conectar un agente de programación con IA externo (Claude Code, Cursor, MCP) a su inquilino; esa vía complementaria se describe en Conecte un agente de programación con IA.

Qué hará

Sección titulada «Qué hará»
Etapa Qué usará
Ver cómo falla el paso y leer el error La pestaña Registro del proyecto
Diagnosticar y corregir el paso fallido El asistente de correcciones, en la pestaña Asistente de IA de la entrada del registro
Confirmar la corrección Responder que sí cuando el asistente ofrezca volver a ejecutar el paso
Agregar una consulta nueva sin escribir SQL Generate SQL with AI en un paso Extraer SQL

Requisitos previos

Sección titulada «Requisitos previos»
  • Un espacio de trabajo de PlaidCloud (inicie una prueba gratuita si no tiene uno) y un proyecto que pueda editar.
  • Un flujo de trabajo con al menos un paso; idealmente uno que falle o que usted pueda hacer fallar (un nombre de columna mal escrito en una transformación basta para reproducir el escenario).

El asistente corrige con sus permisos. Solo puede modificar un paso que usted mismo ya podría editar, y cada cambio que hace es reversible, ya sea volviendo a ejecutarlo o editando el paso directamente. Consulte Corrección de errores de flujos de trabajo con IA.

Paso 1: ejecute el flujo de trabajo y encuentre el error

Sección titulada «Paso 1: ejecute el flujo de trabajo y encuentre el error»

Cuando un paso falla, aparece un indicador de error tanto en el flujo de trabajo como en el paso que falló, y el fallo se escribe en el registro del flujo de trabajo.

  1. Abra su proyecto y ejecute el flujo de trabajo (o el paso individual que está probando).
  2. Cambie a la pestaña Registro del proyecto. El registro enumera los eventos a medida que se ejecutan los pasos, incluidas advertencias y errores.
  3. 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.

¿No tiene a mano un flujo de trabajo roto? Cree uno en 30 segundos. En cualquier paso de transformación, edite la expresión de una columna para que haga referencia a una columna que no existe (por ejemplo, cambie net_amount por net_amnt) y guarde. Ejecute el paso y falla con un error en el registro que indica que la columna net_amnt no existe. Es una configuración incorrecta genuina que el asistente de correcciones está diseñado para detectar, así que es una forma limpia de seguir este tutorial de principio a fin.

Para saber más sobre cómo se muestran los errores y las opciones para manejarlos, consulte Administración de errores de pasos y Visualización del registro del flujo de trabajo.

Paso 2: abra el asistente de correcciones

Sección titulada «Paso 2: abra el asistente de correcciones»

El asistente de correcciones está justo junto al error sin procesar, ya apuntando al paso que falló.

  1. Con la entrada fallida del registro seleccionada, localice el panel de la derecha que muestra Mensaje de registro.
  2. Cambie ese panel a la pestaña Asistente de IA.

El chat del Asistente de IA se abre ya apuntando al flujo de trabajo y al paso de los que proviene la entrada del registro seleccionada, de modo que 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, lado a lado.

En la mayoría de los errores comienza a diagnosticar de inmediato. En algunos comunes, como una expresión que nombra una columna que no existe, la primera respuesta es, en cambio, una breve explicación que PlaidCloud ya tiene para ese tipo de error: qué lo causa habitualmente, qué palabras del mensaje de error conviene mirar y cómo corregirlo. Esa explicación no examina su paso. Responda (por ejemplo, “Revisa este paso y corrígelo, por favor”) y el asistente continúa desde ahí. Consulte Errores comunes.

Paso 3: deje que diagnostique y proponga una corrección

Sección titulada «Paso 3: deje que diagnostique y proponga una corrección»

El asistente trabaja en un orden fijo, y no se guarda nada hasta que usted lo autorice:

  1. Diagnostica: lee la configuración del paso fallido y las tablas y columnas que toca, comprobando sus afirmaciones contra sus datos en lugar de adivinar solo a partir del texto del error.
  2. Propone: si encuentra una configuración incorrecta genuina, muestra la configuración corregida del paso y explica con claridad qué cambió y por qué. En este punto no se escribe nada.
  3. Usted aprueba: espera su autorización explícita. Una respuesta ambigua no se toma como aprobación.
  4. Aplica: una vez que usted aprueba, escribe la configuración corregida en el paso, por la misma ruta que usa el editor de pasos.
  5. Ofrece volver a ejecutar: pregunta si desea volver a ejecutar el paso ahora. Responda que sí y ejecuta el paso y le dice si la corrección funcionó.

Lea el cambio propuesto antes de aprobarlo. El asistente repara la configuración del único paso del que proviene 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 mal formado) y cambia lo mínimo que corrige el error.

Es honesto sobre lo que no puede corregir. Su única palanca es la configuración de ese paso. No creará, eliminará ni reordenará pasos, no editará otro paso ni cambiará sus datos. Muchos fallos no son problemas de configuración en absoluto: datos de origen faltantes o mal formados, un paso anterior que falló primero, un error transitorio o de infraestructura, un problema de permisos o una lógica rota dentro de una transformación o una UDF. En esos casos explica lo que encontró y le indica dónde está la corrección real, en lugar de forzar una edición para que parezca una solución.

Paso 4: apruebe y vuelva a ejecutar

Sección titulada «Paso 4: apruebe y vuelva a ejecutar»
  1. Cuando la configuración propuesta le parezca correcta, confirme el cambio de forma explícita. El asistente lo aplica al paso.
  2. Cuando el asistente pregunte si desea volver a ejecutar el paso, responda que sí. Ejecuta el paso y le dice si tuvo éxito o si volvió a fallar. También puede volver a ejecutar usted mismo el paso o el flujo de trabajo.

Si el asistente le indicó 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íjalo donde realmente está, en lugar de pedirle al asistente que edite el paso de todos modos.

Las advertencias suelen ser inofensivas. Si la entrada del registro es una advertencia y no un fallo grave, el asistente con frecuencia le dirá que no hace falta ningún cambio en lugar de inventar una edición. Es un resultado válido, no un callejón sin salida.

Paso 5: genere un paso Extraer SQL con IA

Sección titulada «Paso 5: genere un paso Extraer SQL con IA»

Ahora use el mismo asistente de base para agregar trabajo nuevo, no solo repararlo. El paso Extraer SQL ejecuta un SELECT de solo lectura y escribe el resultado en una tabla nueva, y el editor del paso puede escribir esa consulta por usted.

  1. En la vista Pasos del flujo de trabajo, haga clic en Crear paso y elija Tables → Extract SQL o AI → SQL Extract (AI Assisted). Ambos abren el mismo editor, que incluye un panel Generate SQL with AI en la parte superior de la página Parámetros de extracción de SQL.
  2. (Opcional) Elija las tablas de origen. En la lista Tablas de origen, seleccione una o más tablas de las que debe leer la consulta. Déjela vacía para que el Asistente examine el proyecto y elija por sí mismo las tablas pertinentes.
  3. Describa lo que quiere. En el cuadro Describir, escriba el resultado en lenguaje natural; por ejemplo, “clasifica cada cuenta del libro mayor en un conjunto de actividad según el rango de su número de cuenta”.
  4. Haga clic en Generar SQL. El Asistente escribe un único SELECT de solo lectura, lo valida ejecutándolo y completa el editor Consulta SQL SELECT y la página de asignación Selección de datos de la tabla con las columnas detectadas. Si dejó vacía la lista de orígenes, las tablas que eligió se seleccionan de nuevo en la lista para que vea cuáles utilizó.

No hay nada que configurar. Esto usa el mismo modelo integrado que el Asistente de IA; no necesita configurar un agente de IA ni una conexión de LLM por espacio de trabajo para ello.

Paso 6: revise y guarde el paso

Sección titulada «Paso 6: revise y guarde el paso»

El SQL generado es un punto de partida, no una caja negra.

  1. Edítelo libremente. El editor de SQL es totalmente editable: perfeccione la consulta, agregue una combinación o cambie la lista de columnas antes de guardar.
  2. Elija una tabla de destino. Elija o asigne un nombre a la Tabla de destino en la que el paso escribe su resultado.
  3. Guarde el paso. Se guarda como un paso Extraer SQL normal y se ejecuta como parte del flujo de trabajo igual que cualquier otro.

El Asistente solo escribe instrucciones SELECT de solo lectura, nunca INSERT, UPDATE, DELETE ni otro SQL que modifique datos. La generación solo redacta y muestra una vista previa; el paso se crea cuando usted lo guarda y se ejecuta cuando se ejecuta el flujo de trabajo. Si una consulta generada no se ejecuta, el editor muestra el SQL junto con el error para que pueda corregirlo, o bien ajustar su descripción y generar de nuevo. Encontrará todos los detalles en Generación de pasos Extraer SQL con IA.

Eso es la asistencia. Ha diagnosticado un paso fallido contra datos reales, aprobado y aplicado la corrección de la IA, la ha confirmado con una nueva ejecución y ha generado un paso Extraer SQL funcional a partir de una frase en lenguaje natural: el mismo asistente reparando lo que está roto y construyendo lo nuevo.

Qué sigue

Sección titulada «Qué sigue»