# Medindo o sucesso de uma avaliação do GitHub Copilot

Meça o sucesso de um Copilot teste analisando a adoção, o engajamento e os padrões iniciais de uso com base em métricas de uso do Copilot.

Quando você realiza um Copilot teste, a chave para o sucesso é entender como as equipes adotam e usam Copilot.
Combinando insights do Copilot painel de métricas de uso e da API, você pode avaliar os resultados iniciais, identificar as necessidades de habilitação e decidir se deseja expandir a distribuição.

Este tutorial mostra como:

1. Defina metas de avaliação claras e critérios de êxito.
2. Exiba e interprete dados de adoção e envolvimento no painel.
3. Avalie os resultados do teste.
4. Incorpore comentários qualitativos de desenvolvedores.
5. Estenda sua avaliação por meio da Copilot API de métricas de uso.
6. Decida se o lançamento deve ser ampliado.

## Etapa 1: Definir suas metas de avaliação

Antes de analisar as métricas, decida quais resultados definirão uma avaliação bem-sucedida para sua organização. Definir metas claras facilita a interpretação de resultados e a comunicação de valor aos stakeholders.

| Meta de exemplo            | Como é o sucesso                                                            | Métricas relacionadas                                                                   |
| :------------------------- | :-------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------- |
| Adopção                    | A maioria dos desenvolvedores licenciados ativa e usa Copilot regularmente. | Total de usuários ativos, DAU (usuários ativos diários), WAU (usuários ativos semanais) |
| Engajamento                | Os desenvolvedores exploram vários recursos e modos.                        | Solicitações por recurso de chat, adoção de agente                                      |
| Produtividade e satisfação | Os desenvolvedores relatam ganhos de eficiência e confiam em sugestões.     | Taxa de aceitação, comentários internos, pesquisas de satisfação                        |
| Efetividade da capacitação | As equipes entendem como e quando usar Copilot.                             | Amplitude de uso entre idiomas e IDEs                                                   |

## Etapa 2: Exibir métricas de adoção e engajamento no painel

1. Navegue até sua empresa. Por exemplo, na página [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\&ref_type=engagement\&ref_style=text) em GitHub.com.
2. Clique na guia **Insights**.

O painel mostra 28 dias de dados de telemetria IDE agregados para todos os usuários licenciados. Concentre-se nessas **principais métricas** durante a avaliação:

| Métrica                       | O que ele mostra                                                                                | Por que isso importa                                                                         |
| :---------------------------- | :---------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |
| Total de usuários ativos      | Número de desenvolvedores que usaram Copilot pelo menos uma vez durante o período de avaliação. | Indica a ativação da licença e o alcance geral.                                              |
| DAU (usuários ativos diários) | Número de usuários exclusivos ativos todos os dias.                                             | Revela tendências de adoção precoces: se o interesse está crescendo, estável ou em declínio. |
| Adoção do agente              | Percentual de usuários ativos que usaram o Copilot agent.                                       | Mostra a profundidade de engajamento e exploração além das conclusões básicas.               |
| Taxa de aceitação             | Porcentagem de Copilot sugestões aceitas.                                                       | Reflete a relevância e a confiança — indicadores-chave de valor e satisfação do usuário.     |
| Uso de linguagem e modelo     | Distribuição de linguagens de programação e modelos usados.                                     | Ajuda a identificar onde Copilot oferece mais valor entre as equipes.                        |

> \[!NOTE]
> Copilot as métricas de uso refletem principalmente a atividade em IDEs com suporte. A telemetria do lado do servidor complementa a telemetria IDE do lado do cliente para exibir usuários ativos adicionais. O uso em Copilot Chat no GitHub.com, GitHub Mobile, Copilot code review ou Copilot CLI não está incluído nos dados do painel.

> \[!TIP]
> O total de usuários ativos e DAU mostram se os desenvolvedores estão usando Copilot , mas não o quão profundamente. Para ver um indicador que rastreia se o uso de teste está se aprofundando ao longo do tempo, como desenvolvedores passando de compleções para fluxos de trabalho com agente, consulte [Visualizando o painel de impacto do Copilot](/pt/copilot/how-tos/administer-copilot/view-impact-dashboard).

## Etapa 3: Avaliar os resultados do teste

Compare os dados do painel com suas metas de teste. Os indicadores comuns de êxito incluem:

| Goal                   | O que medir                                     | Sinais de sucesso                                                                     |
| :--------------------- | :---------------------------------------------- | :------------------------------------------------------------------------------------ |
| Ativação da licença    | Total de usuários ativos                        | 70 a 90% de licenças de avaliação mostram o uso no primeiro mês.                      |
| Engajamento sustentado | Usuários ativos diários e semanais              | A DAU e a WAU estabilizam ou aumentam ao longo do tempo.                              |
| Amplitude de uso       | Solicitações por recurso de chat, uso de idioma | Os usuários experimentam vários idiomas e recursos.                                   |
| Profundidade de uso    | Adoção de agentes, taxa de aceitação            | Os desenvolvedores estão explorando recursos avançados Copilot .                      |
| Comentários positivos  | Pesquisas de equipe ou comentários internos     | Os desenvolvedores relatam ganhos de produtividade ou melhorias no fluxo de trabalho. |

Se uma ou mais metas não forem atendidas, considere se a habilitação, a comunicação ou a configuração do IDE adicionais podem ser necessárias antes de expandir a distribuição.

## Etapa 4: Incorporar comentários qualitativos

Embora a adoção e o engajamento sejam quantitativos, as métricas de satisfação ajudam você a entender o valor percebido e o sentimento do desenvolvedor. Considere incorporar à sua análise as seguintes fontes de feedback, de fora de GitHub.

| Source                          | Description                                                                                                             |
| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------- |
| Copilot pesquisas de satisfação | Comentários periódicos dos desenvolvedores sobre utilidade, confiança e produtividade.                                  |
| Canais de comentários internos  | Retrospectivas de equipe ou pesquisas de pulso sobre alterações de fluxo de trabalho e ganhos de velocidade percebidos. |
| Tendências de suporte           | Menos "como faço para…" perguntas ao longo do tempo geralmente indicam maior confiança e satisfação.                    |

Combinar métricas de uso com comentários do desenvolvedor fornece a visão mais completa do Copilotimpacto.

## Etapa 5: estender sua avaliação por meio da Copilot API de métricas de uso

Após a avaliação, você pode continuar monitorando a adoção e o envolvimento por meio da Copilot API de métricas de uso. A API oferece mais controle sobre quais dados você coleta e com que frequência os analisa.

### Recuperar dados de toda a empresa

Você pode usar os pontos de extremidade de métricas de uso do Copilot para baixar relatórios de uso de 28 dias da sua empresa. Esses relatórios incluem o mesmo conjunto de dados mostrado no Copilot painel de métricas de uso. A API fornece dois endpoints.

| Ponto final                                                                      | Description                                                                                                            |
| :------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------- |
| `GET /enterprises/{enterprise}/copilot/metrics/reports/enterprise-28-day/latest` | Retorna um link de download assinado para o relatório de uso de nível empresarial com duração de 28 dias mais recente. |
| `GET /enterprises/{enterprise}/copilot/metrics/reports/users-28-day/latest`      | Retorna um link de download assinado para o relatório de uso de **nível de usuário** mais recente de 28 dias.          |

Cada resposta de ponto de extremidade inclui URLs assinadas com tempo limitado para baixar os relatórios do Armazenamento de Blobs do Azure, juntamente com o período de relatório coberto pelo arquivo.

Resposta de exemplo:

```json
{
  "download_links": [
    "https://example.com/copilot-usage-report.ndjson"
  ],
  "report_start_day": "2025-07-18",
  "report_end_day": "2025-08-14"
}
```

Para obter definições de campo completas, consulte [GitHub métricas de uso do Copilot](/pt/copilot/reference/copilot-usage-metrics).

### Automatizar seus relatórios

Para automatizar seus relatórios, você pode configurar um trabalho agendado para chamar a API em intervalos regulares (por exemplo, diário ou semanal) e armazenar os resultados em um banco de dados ou data warehouse para análise posterior. Isso permite que você acompanhe as tendências ao longo do tempo e gere relatórios personalizados conforme necessário.

## Etapa 6: Decidir se deseja expandir a distribuição

Use as informações obtidas no painel e nos dados da API para tomar uma decisão bem informada sobre expandir o uso de Copilot.

| Área de decisão             | Perguntas a fazer                                                                                 | Métricas de suporte                                             |
| :-------------------------- | :------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------- |
| Adopção                     | A maioria dos usuários de avaliação está ativa? Eles continuaram usando Copilot consistentemente? | Total de usuários ativos, DAU, WAU                              |
| Necessidades de habilitação | As equipes precisam de mais diretrizes ou recursos?                                               | Uso baixo ou inconsistente entre idiomas ou modelos             |
| Engajamento                 | Os desenvolvedores estão explorando recursos além dos preenchimentos automáticos básicos?         | Adoção e uso do agente, solicitações de chat por funcionalidade |
| Satisfação                  | As equipes consideram o Copilot valioso?                                                          | Taxa de aceitação, comentários de pesquisas                     |

Documente suas descobertas e compartilhe-as com os stakeholders para informar a próxima fase da sua distribuição.

## Próximas etapas

Agora que você sabe como medir o sucesso do seu teste Copilot, você pode continuar a monitorar a adoção e o engajamento à medida que expande o uso. Para saber mais sobre como impulsionar a adoção e habilitar desenvolvedores, consulte [Promovendo a adoção do GitHub Copilot em sua empresa](/pt/copilot/tutorials/roll-out-at-scale/enable-developers/drive-adoption). Para acompanhar o nível de adoção e relacionar os gastos à produção de pull requests à medida que você escala além do período de avaliação, consulte [Visualizando o painel de impacto do Copilot](/pt/copilot/how-tos/administer-copilot/view-impact-dashboard).