Orquestar migraciones de Alteryx con MCP

El servidor MCP de PlaidCloud permite que un agente de IA coordine una migración que abarca muchos flujos de trabajo de Alteryx. El agente puede ayudar a preparar y organizar archivos en Document, inventariar paquetes de flujos de trabajo, llamar al convertidor de Alteryx, organizar los flujos de trabajo generados, ejecutar flujos de trabajo de validación y resumir el progreso para el equipo de migración.

Cuándo usar MCP

Use la orquestación con MCP cuando migre muchos flujos de trabajo o cuando quiera que un agente de IA le ayude con tareas de migración repetibles:

Inventariar los archivos de Alteryx preparados en Document.
Cargar, copiar, mover, cambiar de nombre y organizar archivos de migración mediante las herramientas de Document.
Trabajar desde una cuenta de almacenamiento compartido conectada, como OneDrive, Google Drive, SharePoint, S3, Azure Blob o SFTP.
Agrupar flujos de trabajo, aplicaciones y macros en lotes de migración.
Convertir cada archivo .yxmd, .yxwz o .yxmc en PlaidCloud.
Hacer un seguimiento de los resultados de la conversión en toda la cartera.
Ejecutar flujos de trabajo convertidos o flujos de trabajo de validación.
Elaborar un resumen de la migración para su revisión.

Para un solo flujo de trabajo, el formulario de importación suele ser el camino más rápido. Para una cartera, MCP ofrece al agente una forma estructurada de coordinar repetidamente las mismas capacidades de PlaidCloud.

Qué puede llamar el agente

El catálogo de herramientas de MCP incluye una herramienta de conversión de Alteryx llamada alteryx_convert. Crea flujos de trabajo de PlaidCloud a partir de archivos de Alteryx almacenados en Document.

La llamada de conversión incluye:

La cuenta de documentos y la ruta de origen del archivo de Alteryx.
El proyecto de PlaidCloud de destino.
La cuenta de documentos y la ruta de destino para los artefactos de la conversión.
Prefijos opcionales para flujos de trabajo, pasos y tablas. El prefijo de tabla es, de forma predeterminada, el propio nombre del flujo de trabajo, lo que evita que dos conversiones de un mismo proyecto se pisen las tablas; pase un prefijo vacío para obtener los nombres sin prefijo.
El tipo de flujo de trabajo, con flujos de trabajo avanzados como valor predeterminado.

El agente puede combinar esta herramienta con las herramientas habituales de MCP para proyectos, flujos de trabajo, Document, ejecuciones de flujos de trabajo y tablas para gestionar el conjunto de la migración.

Preparar los archivos con el agente

Un agente conectado por MCP puede ayudar con el trabajo de preparación de archivos que rodea a la conversión:

Buscar archivos .yxmd, .yxwz y .yxmc en Document.
Identificar los probables archivos de entrada, archivos de macros, recursos de informes, archivos espaciales complementarios y salidas esperadas.
Crear una estructura de carpetas de migración limpia.
Copiar, mover o cambiar el nombre de los archivos dentro de esa estructura.
Mantener juntos los archivos relacionados de flujos de trabajo, macros, datos, espaciales, informes y validación.
Resumir el paquete antes de la conversión.

Esto resulta útil cuando un paquete de migración contiene muchas carpetas o cuando los equipos quieren que el agente elabore un inventario repetible antes de empezar la conversión.

Usar almacenamiento compartido sin cargar archivos

No es necesario cargar archivos en una carpeta nueva propiedad de PlaidCloud antes de la migración. Document de PlaidCloud puede conectarse directamente al almacenamiento compartido que ya contiene el paquete de migración de Alteryx.

Entre las opciones habituales se incluyen:

Una vez conectada la cuenta de documentos, el agente puede trabajar a partir de esa cuenta de documentos y de la ruta. Así la migración se mantiene cerca del almacenamiento compartido que ya usa el cliente y se puede evitar un paso de carga independiente.

Preparar o seleccionar archivos en Document

Antes de pedir a un agente que orqueste la migración, elija una de estas vías:

Conecte una ubicación de almacenamiento compartido existente como cuenta de documentos.
Cargue los paquetes de flujos de trabajo en una cuenta de documentos.
Pida al agente que organice los archivos que ya están disponibles en Document.

A continuación, confirme lo siguiente:

Los flujos de trabajo, las aplicaciones, las macros, los archivos de entrada, los archivos espaciales complementarios, los informes y las salidas esperadas están disponibles a través de Document.
Se ha seleccionado el proyecto de destino.
Se ha seleccionado la ruta de Document para las dependencias y los artefactos de los flujos de trabajo convertidos.
El agente tiene permiso para usar las herramientas de MCP de Document y de flujos de trabajo pertinentes.

Entonces el agente puede hacer referencia a rutas estables de Document cuando llame al convertidor.

Indicación sugerida para el agente

Use una indicación como esta con un agente conectado por MCP:

In PlaidCloud, migrate the Alteryx workflows in the connected Document account
"Migration Share" under /q4-alteryx-package into the project "Q4 Migration".

First inventory the .yxmd, .yxwz, and .yxmc files. Organize the package by
workflow, macro, input, spatial, report, and expected-output files. Group macros
with the workflows that call them. Then convert the workflows as Advanced
workflows using the Document output path /q4-alteryx-converted. Prefix created
workflows with "Q4 - ". After each conversion, summarize the generated workflow,
macros, readiness notes, and next validation step. Ask before making mutating calls.

Ajuste el nombre del proyecto, la ruta de origen, la ruta de destino y el prefijo a su lote de migración.

Flujo de orquestación recomendado

En las migraciones de carteras, pida al agente que siga este flujo:

Conectar o seleccionar la cuenta de documentos que contiene el paquete de migración.
Inventariar la carpeta de origen de Document.
Identificar los archivos .yxmd, .yxwz y .yxmc.
Organizar los archivos en grupos de flujos de trabajo, macros, entradas, archivos espaciales, informes y salidas esperadas.
Agrupar los flujos de trabajo y las macros relacionados.
Confirmar el proyecto de destino y la ruta de salida de Document.
Convertir las macros y los flujos de trabajo en flujos de trabajo avanzados.
Abrir o describir los flujos de trabajo generados.
Ejecutar la validación estructural.
Ejecutar la validación de paridad de salida cuando haya salidas esperadas disponibles.
Resumir los flujos de trabajo convertidos, las macros generadas, los artefactos y el estado de la validación.

Así el equipo de migración dispone de un único informe de progreso para toda la cartera, sin dejar de usar el importador nativo de PlaidCloud en cada conversión.

Revisar las llamadas que modifican datos

La mayoría de los clientes MCP muestran las llamadas a herramientas antes de ejecutarlas. Revise las llamadas de conversión y de ejecución de flujos de trabajo antes de aprobarlas, especialmente en proyectos de producción.

Para las migraciones de prueba, use un proyecto de migración y una carpeta de Document dedicados. Tras la validación, promueva los flujos de trabajo convertidos al proyecto de producción.

Hacer un seguimiento de los resultados

Pida al agente que elabore una tabla de migración con:

El archivo de Alteryx de origen.
El flujo de trabajo de PlaidCloud generado.
Los flujos de trabajo de macros generados.
El estado de la conversión.
El nivel de validación.
La ruta de salida de Document.
Notas para el seguimiento.

Este resumen es útil para los informes del proyecto, el traspaso y la revisión de preparación para producción.