Cómo crear un asistente de resumen de incidentes en Microsoft Copilot
Este tutorial muestra cómo crear un asistente en Microsoft Copilot que analiza descripciones de incidentes (logs, correos electrónicos, tickets) y genera un resumen técnico y un resumen ejecutivo. Es útil para equipos que necesitan informes rápidos y consistentes para gestión y auditoría.
Requisitos previos
- Cuenta con acceso a Microsoft Copilot / Copilot Studio y permisos para crear agentes.
- Ejemplos de incidentes: fragmentos de logs, correo de ticket y anotaciones (archivo .txt o .csv).
- Conocimientos básicos de prompts y organización de datos (CSV/JSON simples).
Paso 1: Definir el objetivo y los ejemplos de entrenamiento
Explique claramente qué debe hacer el asistente: generar un "Resumen Técnico" (causa, impacto, pasos de mitigación) y un "Resumen Ejecutivo" (contexto, impacto en el negocio, próximos pasos). Reúna 10–20 ejemplos reales o simulados para orientar las respuestas (esto mejora la consistencia).
# 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 */
Paso 2: Crear un nuevo agente en Copilot Studio
En Copilot Studio, elija crear un agente/assistant y asígnele un nombre como "ResumoIncidentesBot". En el resumen del agente, describa la función: transformar texto de incidentes en dos resúmenes distintos con tono técnico y ejecutivo. Defina el idioma en Portugués (pt-PT).
Paso 3: Configurar el prompt principal (system + examples)
Redacte un prompt base que oriente el comportamiento: personalidad, formato de salida y reglas (longitud máxima, inclusiones obligatorias). Añada ejemplos de entrada/salida 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.
Paso 4: Conectar fuentes de datos (opcional) y transformar inputs
Si desea procesar archivos, configure una integración que permita cargar CSV/JSON o copiar/pegar texto. Normalice el texto antes de enviarlo (eliminar líneas irrelevantes, combinar timestamp + mensaje).
# 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
Paso 5: Probar prompts y ajustar la temperatura
Envíe algunos ejemplos por la interfaz de prueba del agent. Si las salidas son demasiado verbosas o creativas, reduzca la temperatura o indique al modelo que sea conciso. Si falta detalle técnico, añada campos obligatorios en los prompts o más ejemplos.
# Parâmetros típicos a ajustar temperature = 0.2 # respostas mais determinísticas max_tokens = 300 # limitar tamanho do resumo
Paso 6: Crear plantillas de salida y validar formato
Defina una plantilla de salida para facilitar la lectura e integración con herramientas de ticketing (ej.: JSON simple). Esto facilita automatizar la ingestión de los resúmenes.
Saída JSON sugerida: {
"id": 1,
"resumo_tecnico": {
"causa": "...",
"impacto_tecnico": "...",
"acao_imediata": "..."
},
"resumo_executivo": "..."
}
# Peça ao agent para responder neste formato.
Paso 7: Integrar con el workflow (tickets, correo)
Tras la validación, configure una acción que envíe el JSON a la cola de tickets o como borrador de correo. Use Power Automate o un webhook simple para recibir la salida del agent y crear un ticket en el sistema interno.
# Pseudocódigo de integración webhook POST /webhook/tickets Body: {"incident_id":123, "summary_json":{...} }
Verificar el resultado
Para confirmar que está correcto: procese 10 incidents de prueba y compare los resúmenes con lo que una persona habría escrito. Verifique consistencia (mismos campos), precisión técnica y concisión del resumen ejecutivo. Corrija prompts donde falten datos o aparezcan errores factuales.
Conclusión
Ahora tiene un asistente en Microsoft Copilot para generar resúmenes técnicos y ejecutivos de incidentes, listo para integrar en workflows. Próximos pasos: automatizar la ingestión de logs, añadir validación humana y métricas de calidad. Consejo: comience con pocos ejemplos e itere los prompts con los errores comunes que encuentre (causas falsas, exceso de detalle).