Configuración de un agente de FinOps Hub en Microsoft Copilot Studio

En este artículo se describe cómo configurar un agente de Microsoft Copilot Studio que se conecta a la base de datos Data Explorer de FinOps Hub y responde a preguntas de costos mediante la ejecución de consultas KQL. El agente usa el servidor MCP de consulta de Kusto para ejecutar consultas y archivos de conocimiento desde el kit de herramientas de FinOps para construir KQL preciso.


Prerequisites

Antes de empezar, asegúrese de que tiene lo siguiente:

  • Una instancia del centro de FinOps con Data Explorer que ejecuta FinOps hubs v12 o posterior. Las instrucciones del agente usan la Costs_v1_2() función , que no está disponible en versiones anteriores. Obtenga información sobre cómo actualizar.
  • Ámbitos configurados con datos ingeridos correctamente.
  • Visor de base de datos o acceso mayor a la base de datos Data Explorer Hub. Aprende más.
  • Una licencia de Copilot Studio o una licencia de usuario Microsoft 365 Copilot. Para obtener más información sobre las licencias, consulte Copilot Studio licencias.

Si no está familiarizado con Copilot Studio, consulte Quickstart: Creación e implementación de un agente para obtener información sobre los aspectos básicos de la creación del agente antes de continuar.


Creación y configuración del agente

Crear un agente en blanco en Copilot Studio, configúrelo con las siguientes opciones de FinOps Hub.

Detalles del agente

Establezca el nombre del agente en FinOps Hub Agent (o su nombre preferido) y use la descripción siguiente:

El agente de FinOps Hub proporciona información en tiempo real controlada de la base de datos de FinOps Toolkit Hub. Traduce preguntas de lenguaje natural en consultas KQL validadas y ofrece análisis estructurados sobre el gasto en la nube, los compromisos, los planes de ahorro, las anomalías y las oportunidades de optimización.

Selección de modelos

Las instrucciones del agente requieren un modelo con funcionalidades de razonamiento profundo para la generación de KQL de varios pasos y el formato de informe estructurado. Los modelos de categoría general pueden generar resultados de menor calidad para consultas complejas.

Para conocer los modelos disponibles, la disponibilidad regional y las consideraciones de residencia de datos, consulte Selección de un modelo de IA principal para el agente. Si desea usar un modelo externo, el administrador de inquilinos debe habilitarlo primero; consulte Elegir un modelo externo.

Instrucciones del agente

  1. Descargue las instrucciones Copilot Studio para FinOps Hubs y extraiga el contenido.

  2. Abra agent-instructions.md y actualice la sección Entorno con el URI del clúster:

    Cluster URI: <your-cluster>.kusto.windows.net
    Database: Hub
    

    Nota:

    No incluya https:// en el URI del clúster. Copilot Studio quita vínculos HTTP del campo Instrucciones.

  3. Pegue el contenido completo de agent-instructions.md en el campo Instrucciones del agente y guárdelo.


Agregar herramientas

El agente necesita las siguientes herramientas de MCP para funcionar. Para conocer los pasos generales sobre cómo agregar herramientas de MCP a un agente, consulte Incorporación de herramientas desde un servidor MCP.

Servidor MCP para consultas de Kusto (obligatorio)

Agregue Kusto Query MCP Server (by Azure Data Explorer) con estos valores:

  • Pregunte al usuario final antes de ejecutar: No
  • Credenciales que se van a usar: Credenciales de usuario final

Esta herramienta permite al agente ejecutar consultas KQL en la base de datos Data Explorer del centro. El agente usa credenciales de usuario final para que los resultados de la consulta respeten los permisos de base de datos de cada usuario.

Microsoft Learn Docs MCP Server (opcional)

Agregue Microsoft Learn Docs MCP Server (por Microsoft Learn Docs MCP) para permitir que el agente busque conceptos de FinOps, detalles de especificación FOCUS y documentación del servicio Azure al responder a preguntas.

Después de agregar herramientas, compruebe que cada una muestra un estado Conectado en la configuración de conexión del agente. Si una conexión se muestra como No conectado, seleccione Administrar para autenticarse.


Agregar archivos de conocimiento

Las instrucciones del agente hacen referencia a los archivos de conocimiento para construir consultas KQL precisas. Estos archivos son referencias de creación de consultas, no orígenes de datos. Para conocer los pasos generales sobre cómo agregar conocimientos a un agente, consulte Incorporación de orígenes de conocimiento.

Cargue cada archivo de la carpeta extraída knowledge/ y establezca el campo Descripción para cada archivo, como se muestra:

Archivo Descripción
schema-reference.md Referencia de columnas para Costs_v1_2(), que incluye nombres, tipos de datos, notas de uso y casos límite. Use para buscar nombres de columna correctos antes de escribir consultas.
query-catalog.md Plantillas de consulta KQL listas para usar para desgloses de costos, tendencias mensuales, detección de anomalías, previsión, resumen de ahorros y uso del compromiso.
weekly-report-guide.md Flujo de trabajo paso a paso para generar informes de anomalías de costos semanales estructurados con siete consultas KQL, reglas posteriores al procesamiento y la estructura final del informe.

Las descripciones ayudan al agente a decidir cuándo recuperar cada archivo. Espere a que todos los archivos muestren un estado Listo antes de las pruebas.


Probar el agente

Pruebe el agente en el panel Prueba para comprobar que se conecta correctamente a los datos del centro. El agente debe detectar la moneda de facturación y pedirle que seleccione un ámbito de análisis. Pruebe estos mensajes de ejemplo:

What are my top 5 subscriptions by cost?
Create a week over week summary
Are there any unusual spikes in cost over the last 3 months?
What was my savings rate last month?

Compruebe que el agente:

  • Ejecuta consultas KQL en la base de datos del hub, no se limita a citar archivos de conocimiento.
  • Presenta los resultados como tablas con formato.
  • Muestra la consulta KQL en un bloque de código independiente. Revise la consulta para comprobar los filtros, los intervalos de tiempo y la lógica de agregación correctos.
  • Incluye el nivel de confianza, el intervalo de tiempo y el ámbito de la respuesta.

Publica tu agente

Después de realizar las pruebas, publique el agente y configure los canales para que esté disponible para su equipo. Para obtener más información, consulte Publique su agente.


Proporcionar comentarios

Déjanos saber cómo lo estamos haciendo con una breve revisión. Usamos estas revisiones para mejorar y expandir herramientas y recursos de FinOps.

Si busca algo específico, vote por una idea existente o cree una idea nueva. Comparta ideas con otros usuarios para obtener más votos. Nos centramos en las ideas con la mayoría de los votos.


Artículos relacionados de FinOps Hubs:

Artículos relacionados Copilot Studio: