Como resumir um Data Pipeline com o Copilot no Fabric

Quando um Data Pipeline no Microsoft Fabric cresce para dezenas de atividades, perceber o que ele faz — e porque falhou de madrugada — pode demorar mais tempo do que a própria correção. Resumir um Data Pipeline com o Copilot no Fabric resolve grande parte desse problema em segundos: o Copilot lê as atividades, as ligações e as dependências e devolve uma descrição em linguagem natural. É a forma mais rápida de documentar um pipeline herdado e de perceber um erro de execução sem abrir atividade a atividade.

Pré-requisitos

• Um workspace do Fabric numa capacidade onde o Copilot esteja disponível (F2 ou superior, ou P1 ou superior).
• O Copilot ativado no tenant pelo administrador do Fabric (definição Copilot and Azure OpenAI Service no portal de administração).
• Um Data Pipeline já criado, com pelo menos duas ou três atividades (por exemplo, uma Copy data seguida de um Notebook).
• Permissões de edição no workspace (função Contributor ou superior).

Passo 1: Confirmar que o Copilot está disponível

Abre o workspace no Fabric e entra no teu Data Pipeline. Na barra superior do editor do pipeline procura o botão Copilot. Se não o vires, quase sempre a causa é uma destas três: o administrador ainda não ativou o Copilot no tenant, o workspace está numa capacidade que não suporta Copilot, ou estás a ver o pipeline em modo de leitura. Confirma primeiro isto — poupas tempo antes de avançar.

Passo 2: Abrir o painel do Copilot no pipeline

Clica em Copilot. Abre-se um painel lateral com uma caixa de conversa. O contexto do Copilot é o pipeline que tens aberto: ele "vê" as atividades, os nomes, as ligações e a ordem de execução. Não precisas de colar nada — basta perguntar.

Passo 3: Pedir o resumo do pipeline

Escreve um pedido claro. Quanto mais concreto for o prompt, mais útil é a resposta. Estes três exemplos funcionam bem e podem ser usados tal como estão:

Resume este pipeline: o que faz, por que ordem e de onde vêm os dados.

Lista as atividades por ordem de execução e indica as dependências (on success / on fail).

Explica em 5 bullets o que este pipeline faz, para alguém que nunca o viu.

O resumo devolvido descreve normalmente as fontes, os destinos (Lakehouse, Warehouse, ficheiros) e o encadeamento das atividades. Lê-o com atenção: é um bom ponto de partida, mas continuas a ser tu a validar.

Passo 4: Pedir ao Copilot para explicar um erro

Quando uma execução falha, vai ao separador Output (ou ao Monitor), abre os detalhes da atividade que falhou e copia a mensagem de erro. Cola-a no painel do Copilot com um pedido explícito:

Explica este erro em linguagem simples e indica as causas mais prováveis:

ErrorCode=SqlFailedToConnect ... (cola aqui a mensagem completa)

O Copilot traduz o código de erro, explica o que costuma provocá-lo e sugere onde olhar (credenciais, firewall, nome do servidor, tipo de dados incompatível). É especialmente útil com mensagens longas e ruidosas.

Passo 5: Explicar expressões de conteúdo dinâmico

Os pipelines herdados costumam ter expressões pouco óbvias em parâmetros e nomes de ficheiro. Cola a expressão no Copilot e pede uma explicação:

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

Um pedido do tipo "Explica o que faz esta expressão e dá um exemplo do valor gerado hoje" devolve a leitura passo a passo da função e um exemplo concreto. É uma forma rápida de perceber convenções de nomes sem executar o pipeline.

Passo 6: Guardar o resumo como documentação

Um resumo que fica no painel do Copilot perde-se assim que fechas o separador. Copia o texto e cola-o num sítio permanente: a descrição do item (menu Settings do pipeline), a wiki da equipa, ou um ficheiro Markdown no repositório onde guardas o código. Acrescenta sempre a data e o nome de quem validou.

Verificar o resultado

Compara o resumo com o grafo do pipeline no ecrã: as atividades mencionadas existem mesmo? A ordem está certa? As fontes e destinos têm os nomes reais? Se o Copilot mencionar uma atividade que não vês no canvas, descarta essa frase — modelos de linguagem podem enganar-se e o teu resumo só vale se for verdadeiro. Um bom teste final: dá o resumo a um colega que nunca viu o pipeline e pergunta-lhe o que ele acha que o pipeline faz.

Conclusão

Com o Copilot no Fabric, documentar um Data Pipeline deixa de ser uma tarefa adiada indefinidamente e passa a ser um passo de cinco minutos no fim de cada alteração. O próximo passo natural é aplicar o mesmo método aos Notebooks e aos Dataflows Gen2 do mesmo workspace, até teres a solução inteira descrita. Dica: guarda os teus melhores prompts num ficheiro de equipa — a diferença entre um resumo inútil e um resumo excelente está quase sempre no prompt. Qual é o pipeline da tua equipa que ninguém consegue explicar hoje?