Cómo resumir un Data Pipeline con Copilot en Fabric

Cuando un Data Pipeline en Microsoft Fabric crece hasta decenas de actividades, entender qué hace — y por qué falló de madrugada — puede llevar más tiempo que la propia corrección. Resumir un Data Pipeline con Copilot en Fabric elimina gran parte de ese problema en segundos: Copilot lee las actividades, las conexiones y las dependencias y devuelve una descripción en lenguaje natural. Es la forma más rápida de documentar un pipeline heredado y de entender un error de ejecución sin abrir actividad por actividad.

Requisitos previos

• Un workspace de Fabric en una capacidad donde Copilot esté disponible (F2 o superior, o P1 o superior).
• Copilot habilitado a nivel de tenant por el administrador de Fabric (la opción Copilot and Azure OpenAI Service en el portal de administración).
• Un Data Pipeline ya creado, con al menos dos o tres actividades (por ejemplo, una Copy data seguida de un Notebook).
• Permisos de edición en el workspace (rol Contributor o superior).

Paso 1: Comprobar que Copilot está disponible

Abre el workspace en Fabric y entra en tu Data Pipeline. En la barra superior del editor del pipeline busca el botón Copilot. Si no aparece, la causa suele ser una de estas tres: el administrador aún no ha habilitado Copilot en el tenant, el workspace está en una capacidad que no admite Copilot, o estás viendo el pipeline en modo de solo lectura. Confírmalo primero — te ahorra tiempo después.

Paso 2: Abrir el panel de Copilot en el pipeline

Haz clic en Copilot. Se abre un panel lateral con un cuadro de conversación. El contexto de Copilot es el pipeline que tienes abierto: "ve" las actividades, sus nombres, las conexiones y el orden de ejecución. No necesitas pegar nada — basta con preguntar.

Paso 3: Pedir el resumen del pipeline

Escribe una petición clara. Cuanto más concreto sea el prompt, más útil será la respuesta. Estos tres ejemplos funcionan bien y puedes usarlos tal cual:

Resume este pipeline: qué hace, en qué orden y de dónde vienen los datos.

Lista las actividades en orden de ejecución e indica las dependencias (on success / on fail).

Explica en 5 bullets qué hace este pipeline, para alguien que nunca lo ha visto.

El resumen suele describir los orígenes, los destinos (Lakehouse, Warehouse, ficheros) y el encadenamiento de las actividades. Léelo con atención: es un buen punto de partida, pero validarlo sigue siendo tarea tuya.

Paso 4: Pedir a Copilot que explique un error

Cuando una ejecución falla, ve a la pestaña Output (o a Monitor), abre los detalles de la actividad que falló y copia el mensaje de error. Pégalo en el panel de Copilot con una petición explícita:

Explica este error en lenguaje sencillo e indica las causas más probables:

ErrorCode=SqlFailedToConnect ... (pega aquí el mensaje completo)

Copilot traduce el código de error, explica qué suele provocarlo y sugiere dónde mirar (credenciales, firewall, nombre del servidor, tipo de datos incompatible). Es especialmente útil con mensajes largos y ruidosos.

Paso 5: Explicar expresiones de contenido dinámico

Los pipelines heredados suelen esconder expresiones poco obvias en parámetros y nombres de fichero. Pega la expresión en Copilot y pide una explicación:

@concat('ventas_', formatDateTime(utcnow(), 'yyyyMMdd'), '.parquet')

Una petición del tipo "Explica qué hace esta expresión y da un ejemplo del valor que genera hoy" devuelve la lectura paso a paso de cada función y un ejemplo concreto. Es una manera rápida de entender convenciones de nombres sin ejecutar el pipeline.

Paso 6: Guardar el resumen como documentación

Un resumen que se queda en el panel de Copilot se pierde en cuanto cierras la pestaña. Copia el texto y pégalo en un sitio permanente: la descripción del elemento (menú Settings del pipeline), la wiki del equipo, o un fichero Markdown en el repositorio donde guardas el código. Añade siempre la fecha y el nombre de quien lo validó.

Verificar el resultado

Compara el resumen con el lienzo del pipeline en pantalla: ¿existen realmente las actividades que menciona? ¿Es correcto el orden? ¿Los orígenes y destinos tienen sus nombres reales? Si Copilot menciona una actividad que no ves en el lienzo, descarta esa frase — los modelos de lenguaje pueden equivocarse y tu resumen solo vale si es verdadero. Una buena prueba final: dale el resumen a un compañero que nunca haya visto el pipeline y pregúntale qué cree que hace.

Conclusión

Con Copilot en Fabric, documentar un Data Pipeline deja de ser una tarea aplazada indefinidamente y pasa a ser un paso de cinco minutos al final de cada cambio. El siguiente paso natural es aplicar el mismo método a los Notebooks y a los Dataflows Gen2 del mismo workspace, hasta tener toda la solución descrita. Consejo: guarda tus mejores prompts en un fichero compartido del equipo — la diferencia entre un resumen inútil y uno excelente está casi siempre en el prompt. ¿Cuál es el pipeline de tu equipo que hoy nadie sabe explicar?