Orquestrar migrações do Alteryx com MCP

O servidor MCP do PlaidCloud permite que um agente de IA coordene uma migração de muitos fluxos de trabalho do Alteryx. O agente pode ajudar a preparar e organizar ficheiros em Documentos, inventariar pacotes de fluxos de trabalho, chamar o conversor do Alteryx, organizar os fluxos de trabalho gerados, executar fluxos de trabalho de validação e resumir o progresso para a equipa de migração.

Quando utilizar o MCP

Utilize a orquestração por MCP quando estiver a migrar muitos fluxos de trabalho ou quando pretender que um agente de IA ajude em tarefas de migração repetíveis:

Inventariar os ficheiros do Alteryx preparados em Documentos.
Carregar, copiar, mover, mudar o nome e organizar ficheiros de migração através das ferramentas de Documentos.
Trabalhar a partir de uma conta de armazenamento partilhado ligada, como OneDrive, Google Drive, SharePoint, S3, Azure Blob ou SFTP.
Agrupar fluxos de trabalho, aplicações e macros em lotes de migração.
Converter cada ficheiro .yxmd, .yxwz ou .yxmc para o PlaidCloud.
Acompanhar os resultados da conversão em todo o portefólio.
Executar fluxos de trabalho convertidos ou fluxos de trabalho de validação.
Produzir um resumo da migração para revisão.

Para um único fluxo de trabalho, o formulário de importação é frequentemente o caminho mais rápido. Para um portefólio, o MCP dá ao agente uma forma estruturada de coordenar repetidamente as mesmas capacidades do PlaidCloud.

O que o agente pode chamar

O catálogo de ferramentas MCP inclui uma ferramenta de conversão do Alteryx chamada alteryx_convert. Cria fluxos de trabalho do PlaidCloud a partir de ficheiros do Alteryx armazenados em Documentos.

A chamada de conversão inclui:

A conta de documentos e o caminho de origem do ficheiro do Alteryx.
O projeto de destino do PlaidCloud.
A conta de documentos e o caminho de destino dos artefactos da conversão.
Prefixos opcionais de fluxo de trabalho, passo e tabela. O prefixo de tabela predefinido é o nome do próprio fluxo de trabalho, o que evita que duas conversões no mesmo projeto colidam nas tabelas; passe um prefixo vazio para obter os nomes simples.
O tipo de fluxo de trabalho, sendo o fluxo de trabalho avançado o predefinido.

O agente pode combinar isto com as ferramentas MCP normais de projeto, fluxo de trabalho, Documentos, execução de fluxos de trabalho e tabelas para gerir a migração mais ampla.

Preparar ficheiros com o agente

Um agente ligado por MCP pode ajudar no trabalho de preparação de ficheiros em torno da conversão:

Encontrar ficheiros .yxmd, .yxwz e .yxmc em Documentos.
Identificar prováveis ficheiros de entrada, ficheiros de macros, recursos de relatórios, ficheiros auxiliares espaciais e saídas esperadas.
Criar uma estrutura de pastas de migração limpa.
Copiar, mover ou mudar o nome dos ficheiros para essa estrutura.
Manter juntos os ficheiros relacionados de fluxos de trabalho, macros, dados, espaciais, relatórios e validação.
Resumir o pacote antes da conversão.

Isto é útil quando um pacote de migração contém muitas pastas ou quando as equipas pretendem que o agente produza um inventário repetível antes de a conversão começar.

Utilizar armazenamento partilhado sem carregar

Não tem de carregar ficheiros para uma nova pasta pertencente ao PlaidCloud antes da migração. Os Documentos do PlaidCloud podem ligar-se diretamente ao armazenamento partilhado que já contém o pacote de migração do Alteryx.

As opções comuns incluem:

Depois de a conta de documentos estar ligada, o agente pode trabalhar a partir dessa conta de documentos e caminho. Isto mantém a migração junto do armazenamento partilhado existente do cliente e pode eliminar uma fase de carregamento separada.

Preparar ou selecionar ficheiros em Documentos

Antes de pedir a um agente que oriente a migração, escolha um destes caminhos:

Ligue uma localização de armazenamento partilhado existente como conta de documentos.
Carregue os pacotes de fluxos de trabalho para uma conta de documentos.
Peça ao agente que organize os ficheiros já disponíveis em Documentos.

Depois confirme:

Os fluxos de trabalho, as aplicações, as macros, os ficheiros de entrada, os ficheiros auxiliares espaciais, os relatórios e as saídas esperadas estão disponíveis através de Documentos.
O projeto de destino está selecionado.
O caminho de Documentos para as dependências e os artefactos dos fluxos de trabalho convertidos está selecionado.
O agente tem permissão para utilizar as ferramentas MCP de Documentos e de fluxos de trabalho relevantes.

O agente pode então referenciar caminhos estáveis de Documentos quando chama o conversor.

Prompt sugerido para o agente

Utilize um prompt como este com um agente ligado 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 o nome do projeto, o caminho de origem, o caminho de destino e o prefixo ao seu lote de migração.

Fluxo de orquestração recomendado

Para migrações de portefólio, peça ao agente que siga este fluxo:

Ligar ou selecionar a conta de documentos que contém o pacote de migração.
Inventariar a pasta de origem em Documentos.
Identificar os ficheiros .yxmd, .yxwz e .yxmc.
Organizar os ficheiros em grupos de fluxos de trabalho, macros, entradas, espaciais, relatórios e saídas esperadas.
Agrupar os fluxos de trabalho e as macros relacionados.
Confirmar o projeto de destino e o caminho de saída em Documentos.
Converter as macros e os fluxos de trabalho em fluxos de trabalho avançados.
Abrir ou descrever os fluxos de trabalho gerados.
Executar a validação estrutural.
Executar a validação de paridade das saídas quando houver saídas esperadas disponíveis.
Resumir os fluxos de trabalho convertidos, as macros geradas, os artefactos e o estado da validação.

Isto dá à equipa de migração um relatório de progresso único para todo o portefólio, continuando a utilizar o importador nativo do PlaidCloud em cada conversão.

Rever as chamadas que alteram dados

A maioria dos clientes MCP mostra as chamadas de ferramentas antes de estas serem executadas. Reveja as chamadas de conversão e de execução de fluxos de trabalho antes de as aprovar, sobretudo em projetos de produção.

Para migrações de teste, utilize um projeto de migração e uma pasta de Documentos dedicados. Após a validação, promova os fluxos de trabalho convertidos para o projeto de produção.

Acompanhar os resultados

Peça ao agente que produza uma tabela de migração com:

O ficheiro de origem do Alteryx.
O fluxo de trabalho do PlaidCloud gerado.
Os fluxos de trabalho de macros gerados.
O estado da conversão.
O nível de validação.
O caminho de saída em Documentos.
As notas para acompanhamento.

Este resumo é útil para a elaboração de relatórios do projeto, a passagem de testemunho e a revisão da prontidão para produção.