{"meta":{"title":"Medindo o sucesso de uma avaliação do GitHub Copilot","intro":"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.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/tutorials","title":"Tutoriais"},{"href":"/pt/copilot/tutorials/roll-out-at-scale","title":"Distribuir em escala"},{"href":"/pt/copilot/tutorials/roll-out-at-scale/measure-success","title":"Medir o sucesso do teste"}],"documentType":"article"},"body":"# Medindo o sucesso de uma avaliação do GitHub Copilot\n\nMeç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.\n\nQuando você realiza um Copilot teste, a chave para o sucesso é entender como as equipes adotam e usam Copilot.\nCombinando 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.\n\nEste tutorial mostra como:\n\n1. Defina metas de avaliação claras e critérios de êxito.\n2. Exiba e interprete dados de adoção e envolvimento no painel.\n3. Avalie os resultados do teste.\n4. Incorpore comentários qualitativos de desenvolvedores.\n5. Estenda sua avaliação por meio da Copilot API de métricas de uso.\n6. Decida se o lançamento deve ser ampliado.\n\n## Etapa 1: Definir suas metas de avaliação\n\nAntes 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.\n\n| Meta de exemplo            | Como é o sucesso                                                            | Métricas relacionadas                                                                   |\n| :------------------------- | :-------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------- |\n| 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) |\n| Engajamento                | Os desenvolvedores exploram vários recursos e modos.                        | Solicitações por recurso de chat, adoção de agente                                      |\n| 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                        |\n| Efetividade da capacitação | As equipes entendem como e quando usar Copilot.                             | Amplitude de uso entre idiomas e IDEs                                                   |\n\n## Etapa 2: Exibir métricas de adoção e engajamento no painel\n\n1. 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.\n2. Clique na guia **Insights**.\n\nO 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:\n\n| Métrica                       | O que ele mostra                                                                                | Por que isso importa                                                                         |\n| :---------------------------- | :---------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |\n| 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.                                              |\n| 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. |\n| 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.               |\n| 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.     |\n| 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.                        |\n\n> \\[!NOTE]\n> 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.\n\n> \\[!TIP]\n> 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).\n\n## Etapa 3: Avaliar os resultados do teste\n\nCompare os dados do painel com suas metas de teste. Os indicadores comuns de êxito incluem:\n\n| Goal                   | O que medir                                     | Sinais de sucesso                                                                     |\n| :--------------------- | :---------------------------------------------- | :------------------------------------------------------------------------------------ |\n| 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.                      |\n| Engajamento sustentado | Usuários ativos diários e semanais              | A DAU e a WAU estabilizam ou aumentam ao longo do tempo.                              |\n| Amplitude de uso       | Solicitações por recurso de chat, uso de idioma | Os usuários experimentam vários idiomas e recursos.                                   |\n| Profundidade de uso    | Adoção de agentes, taxa de aceitação            | Os desenvolvedores estão explorando recursos avançados Copilot .                      |\n| Comentários positivos  | Pesquisas de equipe ou comentários internos     | Os desenvolvedores relatam ganhos de produtividade ou melhorias no fluxo de trabalho. |\n\nSe 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.\n\n## Etapa 4: Incorporar comentários qualitativos\n\nEmbora 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.\n\n| Source                          | Description                                                                                                             |\n| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------- |\n| Copilot pesquisas de satisfação | Comentários periódicos dos desenvolvedores sobre utilidade, confiança e produtividade.                                  |\n| Canais de comentários internos  | Retrospectivas de equipe ou pesquisas de pulso sobre alterações de fluxo de trabalho e ganhos de velocidade percebidos. |\n| Tendências de suporte           | Menos \"como faço para…\" perguntas ao longo do tempo geralmente indicam maior confiança e satisfação.                    |\n\nCombinar métricas de uso com comentários do desenvolvedor fornece a visão mais completa do Copilotimpacto.\n\n## Etapa 5: estender sua avaliação por meio da Copilot API de métricas de uso\n\nApó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.\n\n### Recuperar dados de toda a empresa\n\nVocê 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.\n\n| Ponto final                                                                      | Description                                                                                                            |\n| :------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------- |\n| `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. |\n| `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.          |\n\nCada 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.\n\nResposta de exemplo:\n\n```json\n{\n  \"download_links\": [\n    \"https://example.com/copilot-usage-report.ndjson\"\n  ],\n  \"report_start_day\": \"2025-07-18\",\n  \"report_end_day\": \"2025-08-14\"\n}\n```\n\nPara obter definições de campo completas, consulte [GitHub métricas de uso do Copilot](/pt/copilot/reference/copilot-usage-metrics).\n\n### Automatizar seus relatórios\n\nPara 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.\n\n## Etapa 6: Decidir se deseja expandir a distribuição\n\nUse as informações obtidas no painel e nos dados da API para tomar uma decisão bem informada sobre expandir o uso de Copilot.\n\n| Área de decisão             | Perguntas a fazer                                                                                 | Métricas de suporte                                             |\n| :-------------------------- | :------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------- |\n| Adopção                     | A maioria dos usuários de avaliação está ativa? Eles continuaram usando Copilot consistentemente? | Total de usuários ativos, DAU, WAU                              |\n| Necessidades de habilitação | As equipes precisam de mais diretrizes ou recursos?                                               | Uso baixo ou inconsistente entre idiomas ou modelos             |\n| 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 |\n| Satisfação                  | As equipes consideram o Copilot valioso?                                                          | Taxa de aceitação, comentários de pesquisas                     |\n\nDocumente suas descobertas e compartilhe-as com os stakeholders para informar a próxima fase da sua distribuição.\n\n## Próximas etapas\n\nAgora 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)."}