Como Exportar Dados de Uso do Microsoft 365 Copilot para Finanças

As equipes financeiras precisam acompanhar a adoção e o uso do Copilot para gerenciar custos de licenciamento e medir o retorno sobre o investimento. Sem dados exportáveis, você não pode analisar a atividade por usuário ou identificar licenças não utilizadas. A Microsoft fornece dois métodos oficiais para exportar dados de uso do Copilot: os relatórios do centro de administração do Microsoft 365 e a API do Microsoft Graph. Este artigo explica como usar ambos os métodos para obter os dados brutos que seu departamento financeiro precisa.

O Que o Departamento Financeiro Precisa dos Dados de Uso do Copilot

Os dados de uso do Copilot para finanças incluem o número de usuários ativos, o total de ações do Copilot realizadas e a distribuição das ações por aplicativo do Microsoft 365. Esses dados ajudam as equipes financeiras a calcular o custo por usuário ativo, identificar licenças subutilizadas e prever necessidades futuras de licenciamento. Os dados estão disponíveis em duas fontes: o relatório pré-construído do centro de administração e a telemetria bruta acessível via API do Graph. Ambas as fontes cobrem o Copilot no Word, Excel, PowerPoint, Outlook, Teams e Loop. O relatório do centro de administração é adequado para revisões mensais rápidas. A API do Graph é necessária para integração personalizada com sistemas financeiros como Power BI ou plataformas de ERP.

Campos de Dados Disponíveis no Relatório de Uso do Copilot

O CSV exportado do centro de administração inclui estes campos: Data de Atualização do Relatório, Nome Principal do Usuário, Data da Última Atividade, Total de Ações do Copilot, Ações no Word, Ações no Excel, Ações no PowerPoint, Ações no Outlook, Ações no Teams e Ações no Loop. A API do Graph retorna os mesmos campos, além do nome de exibição do usuário e do SKU da licença. As equipes financeiras podem usar o campo Total de Ações do Copilot para calcular a média de ações por usuário por mês.

Como Exportar Dados de Uso do Copilot do Centro de Administração

O método do centro de administração não requer codificação. Você seleciona um intervalo de datas, visualiza o relatório e baixa um arquivo CSV. Siga estas etapas exatamente.

1. Entre no centro de administração do Microsoft 365
   Acesse admin.microsoft.com e faça login com uma conta que tenha a função de Administrador Global ou Leitor de Relatórios.
2. Navegue até os relatórios de Uso
   No painel de navegação esquerdo, selecione Relatórios e depois selecione Uso.
3. Selecione o relatório do Copilot
   Role a lista de relatórios e clique em Copilot para Microsoft 365. O relatório carrega uma tabela mostrando a atividade do usuário nos últimos 7 dias por padrão.
4. Defina o intervalo de datas
   Clique no filtro de intervalo de datas na parte superior do relatório. Escolha um intervalo personalizado que corresponda ao seu período de relatório financeiro, como os últimos 30 dias ou um mês calendário específico.
5. Exporte os dados
   Clique no botão Exportar localizado acima da tabela. O navegador baixa um arquivo CSV chamado CopilotUsageDetail.csv.
6. Abra o arquivo CSV
   Abra o arquivo baixado no Excel ou em um editor de texto. O arquivo contém uma linha por usuário com todos os campos de dados descritos anteriormente.

Como Exportar Dados de Uso do Copilot Usando a API do Microsoft Graph

O método da API do Graph é necessário se você precisar automatizar exportações, combinar dados de vários locatários ou importar diretamente para um dashboard financeiro. Você deve ter um registro de aplicativo no Azure AD com as permissões corretas. As etapas abaixo pressupõem que você tenha familiaridade básica com PowerShell e registros de aplicativo do Azure AD.

Pré-requisitos para o Método da API do Graph

Antes de executar o script, prepare estes itens:

• Um registro de aplicativo do Azure AD com a permissão de aplicativo Reports.Read.All concedida e consentimento do administrador fornecido.
• Um segredo do cliente ou certificado para autenticação.
• PowerShell 7 ou posterior com o SDK do Microsoft Graph PowerShell instalado. Instale-o executando Install-Module Microsoft.Graph -Scope CurrentUser.

Execute o Script de Exportação do PowerShell

1. Abra o PowerShell como administrador
   Pressione a tecla Windows, digite PowerShell, clique com o botão direito em Windows PowerShell e selecione Executar como administrador.
2. Conecte-se ao Microsoft Graph
   Execute o comando a seguir, substituindo YOUR_TENANT_ID, YOUR_CLIENT_ID e YOUR_CLIENT_SECRET pelos seus valores reais:

   Connect-MgGraph -TenantId "YOUR_TENANT_ID" -ClientId "YOUR_CLIENT_ID" -ClientSecret (ConvertTo-SecureString "YOUR_CLIENT_SECRET" -AsPlainText -Force) -NoWelcome

3. Solicite os dados de uso do Copilot
   Execute o comando a seguir para obter os dados de uso dos últimos 30 dias:

   $report = Get-MgReportCopilotUsageDetail -Period "D30"

   O parâmetro D30 solicita dados dos últimos 30 dias. Você também pode usar D7 ou D90.

4. Exporte os dados para um arquivo CSV
   Execute o comando a seguir para salvar os dados em um arquivo na sua área de trabalho:

   $report | Export-Csv -Path "$env:USERPROFILE\Desktop\CopilotUsageGraph.csv" -NoTypeInformation

5. Verifique o arquivo exportado
   Abra o arquivo CopilotUsageGraph.csv na sua área de trabalho. Ele contém os mesmos campos da exportação do centro de administração, além do nome de exibição e do SKU da licença.

Problemas Comuns ao Exportar Dados de Uso do Copilot

O Botão Exportar Está Esmaecido ou Ausente

Isso acontece quando a conta conectada não tem a função de Leitor de Relatórios ou a função de Relatórios de Resumo de Uso. Peça ao seu Administrador Global para atribuir a função Leitor de Relatórios à sua conta no centro de administração do Microsoft 365 em Funções > Atribuições de função.

A API do Graph Retorna um Erro de Acesso Negado

O registro do aplicativo deve ter a permissão de aplicativo Reports.Read.All, não a permissão delegada. A permissão delegada requer um usuário conectado e frequentemente falha em scripts automatizados. Vá para o registro do aplicativo do Azure AD, selecione Permissões de API, adicione Reports.Read.All em Permissões de aplicativo e clique em Conceder consentimento do administrador.

O Arquivo CSV Contém Zero Linhas

Zero linhas indicam que nenhum usuário estava ativo no intervalo de datas selecionado. Verifique se pelo menos um usuário no seu locatário tem uma licença do Copilot para Microsoft 365 atribuída e usou o Copilot dentro do intervalo de datas. Confirme também se o intervalo de datas usa o formato correto. Para o centro de administração, use o seletor de datas. Para a API do Graph, use D7, D30 ou D90.

Exportação do Centro de Administração vs Exportação da API do Graph: Principais Diferenças

Item	Exportação do Centro de Administração	Exportação da API do Graph
Nível de habilidade necessário	Nenhum	PowerShell e registro de aplicativo do Azure AD
Campos de dados	11 campos, incluindo nome principal do usuário e ações por aplicativo	Mesmos 11 campos, mais nome de exibição e SKU da licença
Automação possível	Não	Sim, por meio de scripts agendados
Opções de intervalo de datas	Seletor de datas personalizado	Apenas D7, D30, D90
Melhor para	Exportações manuais únicas ou mensais para revisão financeira	Exportações recorrentes para dashboards do Power BI ou integração com ERP

Agora você pode exportar dados de uso do Copilot usando o relatório do centro de administração ou a API do Graph. Comece com a exportação do centro de administração para uma revisão financeira mensal rápida. Se precisar de exportações automatizadas recorrentes, configure o script da API do Graph e agende-o com o Agendador de Tarefas do Windows. Para análises avançadas, importe o CSV para o Power BI e use o campo SKU da licença para calcular o custo por usuário ativo por aplicativo.