Configurar um agente do hub FinOps no Microsoft Copilot Studio

Este artigo descreve como configurar um agente Microsoft Copilot Studio que se conecta ao seu hub FinOps Data Explorer banco de dados e responde a perguntas de custo executando consultas KQL. O agente usa o Servidor MCP de Consulta Kusto para executar consultas e arquivos de conhecimento do kit de ferramentas FinOps para construir KQL preciso.


Pré-requisitos

Antes de começar, certifique-se de que tem o seguinte:

  • Uma instância do hub FinOps com Data Explorer executando hubs FinOps v12 ou posterior. As instruções do agente usam a Costs_v1_2() função, que não está disponível em versões anteriores. Saiba como atualizar.
  • Escopos configurados com dados ingeridos com êxito.
  • Visualizador de banco de dados ou maior acesso ao banco de dados Data Explorer Hub. Saiba mais.
  • Uma licença do Copilot Studio ou uma licença de usuário do Microsoft 365 Copilot. Para obter informações sobre licenciamento, consulte Licenciamento do Copilot Studio.

Se você não estiver familiarizado com Copilot Studio, consulte Quickstart: Criar e implantar um agente para saber os conceitos básicos da criação do agente antes de continuar.


Criar e configurar o agente

Criar um agente em branco no Copilot Studio e configurá-lo com as seguintes configurações do hub FinOps.

Detalhes do agente

Defina o nome do agente como FinOps Hub Agent (ou seu nome preferido) e use a seguinte descrição:

O FinOps Hub Agent fornece insights controlados e em tempo real do banco de dados do Hub do FinOps Toolkit. Ele converte questões de linguagem natural em consultas KQL validadas e fornece análise estruturada sobre gastos em nuvem, compromissos, planos de poupança, anomalias e oportunidades de otimização.

Seleção de modelo

As instruções do agente exigem um modelo com recursos de raciocínio profundo para geração de KQL de várias etapas e formatação de relatório estruturada. Modelos de categoria geral podem produzir resultados de baixa qualidade para consultas complexas.

Para ver modelos disponíveis, disponibilidade regional e considerações de residência de dados, consulte Selecionar um modelo de IA primário para seu agente. Se você quiser usar um modelo externo, o administrador do locatário deverá habilitá-lo primeiro; consulte Escolher um modelo externo.

Instruções do agente

  1. Baixe as instruções Copilot Studio para hubs FinOps e extraia o conteúdo.

  2. Abra agent-instructions.md e atualize a seção Ambiente com o URI do cluster:

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

    Note

    Não inclua https:// no URI do cluster. O Copilot Studio remove links HTTP do campo Instruções.

  3. Cole o conteúdo completo do agent-instructions.md campo Instruções do agente e salve.


Adicionar ferramentas

O agente precisa das seguintes ferramentas MCP para funcionar. Para obter etapas gerais sobre como adicionar ferramentas MCP a um agente, consulte Adicionar ferramentas de um servidor MCP.

Servidor MCP de Consultas do Kusto (obrigatório)

Adicione Kusto Query MCP Server (por Azure Data Explorer) com estas configurações:

  • Pergunte ao usuário final antes de executar: Não
  • Credenciais a serem usadas: Credenciais do usuário final

Essa ferramenta permite que o agente execute consultas KQL no banco de dados Data Explorer do hub. O agente usa credenciais de usuário final para que os resultados da consulta respeitem as permissões de banco de dados de cada usuário.

Servidor MCP do Microsoft Learn Docs (opcional)

Adicione Microsoft Learn Docs MCP Server (do Microsoft Learn Docs MCP) para que o agente consulte conceitos de FinOps, detalhes da especificação FOCUS e a documentação dos serviços do Azure ao responder a perguntas.

Depois de adicionar ferramentas, verifique se cada um mostra um status conectado nas configurações de conexão do agente. Se uma conexão for exibida como Não Conectada, selecione Gerenciar para autenticar.


Adicionar arquivos de conhecimento

As instruções do agente fazem referência a arquivos de conhecimento para construir consultas KQL precisas. Esses arquivos são referências de criação de consulta, não fontes de dados. Para obter etapas gerais sobre como adicionar conhecimento a um agente, consulte Adicionar fontes de conhecimento.

Carregue cada arquivo da pasta extraída knowledge/ e defina o campo Descrição para cada arquivo, conforme mostrado:

Arquivo Descrição
schema-reference.md Referência de coluna de Costs_v1_2(), incluindo nomes, tipos de dados, notas de uso e casos extremos. Use para procurar os nomes corretos das colunas antes de escrever consultas.
query-catalog.md Modelos de consulta KQL prontos para uso para detalhamento de custos, tendências mensais, detecção de anomalias, previsão, resumo de economias e utilização de compromissos.
weekly-report-guide.md Fluxo de trabalho passo a passo para produzir relatórios de anomalias de custo semanais estruturados com sete consultas KQL, regras de pós-processamento e a estrutura de relatório final.

As descrições ajudam o agente a decidir quando recuperar cada arquivo. Aguarde que todos os arquivos mostrem um status Pronto antes do teste.


Testar seu agente

Teste o agente no painel de teste para verificar se ele se conecta aos dados do hub corretamente. O agente deve detectar sua moeda de cobrança e solicitar que você selecione um escopo de análise. Experimente estes prompts de exemplo:

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?

Verifique se o agente:

  • Executa consultas KQL no banco de dados do hub, não apenas citando arquivos de conhecimento.
  • Apresenta resultados como tabelas formatadas.
  • Mostra a consulta KQL em um bloco de código separado. Examine a consulta para verificar filtros corretos, intervalos de tempo e lógica de agregação.
  • Inclui nível de confiança, intervalo de tempo e escopo na resposta.

Publique seu agente

Após o teste, publique seu agente e configure canais para disponibilizá-lo para sua equipe. Para obter mais detalhes, consulte Publicar seu agente.


Fornecer comentários

Deixe-nos saber como estamos indo com uma avaliação rápida. Usamos essas revisões para melhorar e expandir ferramentas e recursos do FinOps.

Envie comentários

Se você estiver procurando algo específico, vote em um existente ou crie uma ideia. Compartilhe ideias com outras pessoas para obter mais votos. Nós nos concentramos nas ideias com mais votos.

Votar ou sugerir ideias


Conteúdo relacionado

Artigos de hubs FinOps relacionados:

Artigos de Copilot Studio relacionados:


  • Last updated on