Como criar um assistente de resumo de incidentes no Microsoft Copilot

João Barros 17 de October de 2026 4 min de leitura

Este tutorial mostra como criar um assistente no Microsoft Copilot que analisa descrições de incidentes (logs, emails, tickets) e gera um resumo técnico e um resumo executivo. É útil para equipas que precisam de relatórios rápidos e consistentes para gestão e auditoria.

Pré-requisitos

Conta com acesso ao Microsoft Copilot / Copilot Studio e permissões para criar agentes.
Exemplos de incidentes: trecho de logs, email de ticket e anotações (ficheiro .txt ou .csv).
Noções básicas de prompts e organização de dados (CSV/JSON simples).

Passo 1: Definir o objetivo e os exemplos de treino

Explique claramente o que o assistente deve fazer: gerar um "Resumo Técnico" (causa, impacto, passos de mitigação) e um "Resumo Executivo" (contexto, impacto no negócio, próximos passos). Reúna 10–20 exemplos reais ou simulados para orientar as respostas (isto melhora a consistência).

# Estrutura de exemplo (CSV)  id,origem,texto  1,email,"Serviço X caiu às 03:12. Erro 503 no endpoint /api/pay." /* Guardar estes exemplos num ficheiro incidents.csv */

Passo 2: Criar um novo agente no Copilot Studio

No Copilot Studio, escolha criar um agente/assistant e dê-lhe um nome como "ResumoIncidentesBot". No resumo do agente, descreva a função: transformar texto de incidentes em dois resumos distintos com tom técnico e executivo. Defina o idioma para Português (pt-PT).

Passo 3: Configurar o prompt principal (system + examples)

Escreva um prompt base que oriente o comportamento: personalidade, formato de saída e regras (comprimento máximo, inclusões obrigatórias). Adicione exemplos de entrada/saída para few-shot learning.

System: És um assistente que resume incidentes.  Regras:  - Produz dois blocos: "Resumo Técnico" e "Resumo Executivo".  - Resumo Técnico: 3 pontos (Causa provável, Impacto técnico, Ação imediata).  - Resumo Executivo: 2 frases (impacto no negócio, próximo passo).  Example Input: "Serviço X caiu às 03:12 com erro 503 no endpoint /api/pay."  Example Output:  Resumo Técnico:  1) Causa provável: Timeout no upstream.  2) Impacto técnico: Erros 503 em pagamentos durante 3 min.  3) Ação imediata: Reiniciar serviço e monitorizar logs.  Resumo Executivo:  O serviço de pagamentos esteve indisponível por ~3 minutos, afetando transações. A equipa reiniciou o serviço e monitoriza para evitar recorrência.

Passo 4: Ligar fontes de dados (opcional) e transformar inputs

Se quiser processar ficheiros, configure uma integração que permita carregar CSV/JSON ou copiar/colar texto. Normalize o texto antes de enviar (remover linhas irrelevantes, combinar timestamp + mensagem).

# Exemplo simples de transformação em Python para preparar uma linha  def preparar_texto(timestamp, origem, mensagem):      return f"[{timestamp}] {origem}: {mensagem}"

# Usar isto para gerar cada 'input' a enviar ao Copilot agent

Passo 5: Testar prompts e ajustar temperatura

Envie alguns exemplos pela interface de teste do agent. Se as saídas forem demasiado verbosas ou criativas, reduza a temperatura ou instrua o modelo a ser conciso. Se faltar detalhe técnico, acrescente campos obrigatórios nos prompts ou mais exemplos.

# Parâmetros típicos a ajustar  temperature = 0.2  # respostas mais determinísticas  max_tokens = 300   # limitar tamanho do resumo

Passo 6: Criar templates de saída e validar formato

Defina um template de saída para facilitar a leitura e integração com ferramentas de ticketing (ex.: JSON simples). Isto torna mais fácil automatizar a ingestão dos resumos.

Saída JSON sugerida:  {
  "id": 1,
  "resumo_tecnico": {
    "causa": "...",
    "impacto_tecnico": "...",
    "acao_imediata": "..."
  },
  "resumo_executivo": "..."
}

# Peça ao agent para responder neste formato.

Passo 7: Integrar com workflow (tickets, email)

Depois de validado, configure uma ação que envie o JSON para a fila de tickets ou como rascunho de email. Use o Power Automate ou um webhook simples para receber a saída do agent e criar um ticket no sistema interno.

# Pseudocódigo de integração webhook  POST /webhook/tickets  Body: {"incident_id":123, "summary_json":{...} }

Verificar o resultado

Para confirmar que está bem: processe 10 incidents de teste e compare os resumos com o que uma pessoa escreveu. Verifique consistência (mesmos campos), precisão técnica e concisão do resumo executivo. Corrija prompts onde faltarem dados ou apareçam erros factuais.

Conclusão

Tem agora um assistente no Microsoft Copilot para gerar resumos técnicos e executivos de incidentes, pronto a integrar em workflows. Próximos passos: automatizar a ingestão de logs, adicionar validação humana e métricas de qualidade. Dica: comece com poucos exemplos e vá iterando os prompts com os erros comuns que encontrar (falsas causas, excesso de detalhe).