> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insights de Sessão

> Analise suas sessões com o Devin e obtenha feedback prático para melhorar futuras interações

<div id="what-is-session-insights">
  ## O que é o Session Insights?
</div>

Session Insights é um recurso de análise que ajuda você a entender o que aconteceu nas suas sessões com o Devin e fornece recomendações práticas para melhorias. Quando você aciona uma análise, o Session Insights examina a sessão para identificar padrões, problemas e oportunidades de melhorar a colaboração.

Session Insights está disponível para todas as sessões concluídas do Devin sem custo adicional. Quando uma sessão termina, o Devin gera automaticamente uma classificação leve (categoria, linguagens e ferramentas). Para sessões grandes (L ou XL), uma análise completa também é gerada automaticamente no encerramento. Para sessões menores, você pode acionar uma análise completa manualmente pela UI ou pela [API](/pt-BR/api-reference/v3/sessions/post-organizations-session-insights-generate).

<div id="how-to-access-session-insights">
  ## Como acessar o Session Insights
</div>

<div id="step-1-complete-a-session">
  ### Etapa 1: Concluir uma sessão
</div>

Inicie uma sessão com o Devin e deixe-a ser concluída. O Session Insights funciona melhor com sessões que têm resultados claros, sejam eles bem-sucedidos ou não. Sessões muito curtas (com menos de uma mensagem do Devin) não gerarão insights.

<div id="step-2-open-the-insights-modal">
  ### Etapa 2: Abrir o modal de Session Insights
</div>

Depois que sua sessão for concluída, procure o botão **Session Insights** na barra superior da sua sessão.

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/UjKpAzVJVjd3ZFg5/images/session-insights-button.png?fit=max&auto=format&n=UjKpAzVJVjd3ZFg5&q=85&s=3b9bbc4da496a6dae6069ae7214433f5" alt="Botão Session Insights" width="982" height="460" data-path="images/session-insights-button.png" />
</Frame>

<div id="step-3-generate-or-view-analysis">
  ### Etapa 3: Gerar ou visualizar a análise
</div>

Clique no botão para abrir o modal Session Insights. Se nenhuma análise tiver sido gerada ainda, clique em **Generate Analysis** para iniciar uma. A geração normalmente leva cerca de um minuto. Se uma análise já existir, você pode clicar em **Regenerate** para criar uma nova análise.

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/UjKpAzVJVjd3ZFg5/images/session-insights-modal.png?fit=max&auto=format&n=UjKpAzVJVjd3ZFg5&q=85&s=052fcd5843ca8fc174b2b9e368163c28" alt="Modal de insights da sessão" width="1510" height="898" data-path="images/session-insights-modal.png" />
</Frame>

<div id="session-overview-metrics">
  ## Métricas de Visão Geral da Sessão
</div>

Na parte superior do modal Session Insights, quatro métricas principais oferecem uma visão rápida da sessão:

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/BzEPrPG0ZPV9ZFyB/images/product-guides/session-insight-cards.png?fit=max&auto=format&n=BzEPrPG0ZPV9ZFyB&q=85&s=133e2891bd6e52e099453fc4faad38fd" alt="Session Insight Cards" width="1510" height="360" data-path="images/product-guides/session-insight-cards.png" />
</Frame>

<div id="acu-usage">
  ### Uso de ACU
</div>

O uso de ACU (Agent Compute Unit) reflete quanto poder computacional o Devin consumiu durante a sessão. Um consumo de ACU menor para uma determinada tarefa geralmente indica uma sessão mais eficiente. Use essa métrica para comparar tarefas semelhantes e identificar sessões em que o Devin possa ter gasto poder computacional excessivo em tentativas repetidas ou caminhos sem saída.

<div id="user-messages">
  ### Mensagens do usuário
</div>

O número total de mensagens que você enviou durante a sessão. Um número alto de mensagens pode indicar que o Devin precisou de ajustes frequentes, sugerindo que o prompt inicial poderia ser mais detalhado. Idealmente, forneça todo o contexto importante desde o início para minimizar idas e vindas.

<div id="session-size">
  ### Tamanho da sessão
</div>

O tamanho da sessão é uma classificação combinada (XS, S, M, L, XL) com base tanto no uso de ACU quanto na quantidade de mensagens do usuário. Um uso maior de ACU ou um número maior de mensagens do usuário pode aumentar o tamanho da sessão.

Os limites para cada categoria de tamanho são:

| Tamanho | Limite de ACU | Limite de mensagens do usuário |
| ------- | ------------- | ------------------------------ |
| **XS**  | ≤ 2 ACUs      | ≤ 2 mensagens                  |
| **S**   | ≤ 5 ACUs      | ≤ 5 mensagens                  |
| **M**   | ≤ 10 ACUs     | ≤ 10 mensagens                 |
| **L**   | ≤ 20 ACUs     | ≤ 20 mensagens                 |
| **XL**  | > 20 ACUs     | > 20 mensagens                 |

<Note>Para clientes Enterprise, os limites de ACU são multiplicados por um fator de 10 (por exemplo, XS ≤ 20 ACUs, S ≤ 50, M ≤ 100, L ≤ 200, XL > 200). Os limites de mensagens do usuário permanecem os mesmos.</Note>

O tamanho geral da sessão é o **maior** entre o tamanho com base em ACU e o tamanho com base em mensagens. Sessões classificadas como **L** ou **XL** são sinalizadas como problemáticas, o que significa que o Devin provavelmente encontrou problemas significativos ou que o escopo da tarefa era amplo demais para uma única sessão. Considere dividir tarefas grandes em sessões menores e mais focadas.

<Tip>
  Para manter as sessões pequenas e eficientes, forneça todas as informações importantes já no prompt inicial.
</Tip>

<div id="category">
  ### Categoria
</div>

O Devin classifica automaticamente as sessões em categorias de tarefa com base no trabalho realizado. A classificação também inclui metadados, como as **ferramentas e os frameworks** usados e as **linguagens de programação** envolvidas.

As categorias de tarefa disponíveis são:

* **Desenvolvimento de Recursos** — criação de novos recursos, componentes, serviços ou implementação de novas funcionalidades
* **Correção de Bugs** — investigação e resolução de bugs, erros ou comportamentos inesperados
* **Revisão de Código** — revisão, explicação ou análise de código e arquitetura existentes
* **Refatoração e Otimização** — melhoria da estrutura, do desempenho ou da legibilidade do código sem alterar seu comportamento
* **Geração de Testes** — escrita, correção ou melhoria de testes (unitários, de integração, e2e, QA) e da infraestrutura de testes
* **Migrações e Upgrades** — atualização de dependências, migração entre frameworks ou versões
* **CI/CD e DevOps** — trabalho em pipelines de CI/CD, deployment, monitoramento, alertas e tarefas de infraestrutura
* **Segurança** — correção de vulnerabilidades de segurança, tratamento de CVEs e melhoria da postura de segurança
* **Dados e Automação** — análise de dados, pipelines, scripts, dashboards e tarefas de automação
* **Documentação e Conteúdo** — escrita ou atualização de documentação, READMEs, changelogs, documentação de API e traduções
* **Pesquisa e Exploração** — avaliação de viabilidade, pesquisa de soluções, definição de arquitetura, escrita de RFCs e prototipagem

Essa classificação ajuda você a entender como o Devin interpretou sua tarefa e pode revelar desalinhamentos entre o que você pretendia e o que o Devin realmente realizou.

<div id="analysis-tabs">
  ## Abas de análise
</div>

O modal Session Insights contém três abas, cada uma voltada a um aspecto diferente da análise.

<div id="issue-timeline">
  ### Linha do tempo de issues
</div>

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/BzEPrPG0ZPV9ZFyB/images/product-guides/session-insights-timeline.png?fit=max&auto=format&n=BzEPrPG0ZPV9ZFyB&q=85&s=c45a8b1c0f8daf870f424bbb7d10598a" alt="Session Insights Timeline" width="1510" height="1870" data-path="images/product-guides/session-insights-timeline.png" />
</Frame>

A aba Linha do tempo de issues contém duas seções:

**Issues detectadas** lista problemas que Devin encontrou durante a sessão. Cada issue inclui:

* Um **rótulo** descrevendo a categoria da issue
* Uma classificação de **impacto** (alto, médio ou baixo)
* Uma **descrição** explicando o que deu errado

As issues são agrupadas por rótulo e nível de impacto, o que facilita a identificação de padrões. Tipos comuns de issues incluem falhas de build, problemas de configuração de ambiente, suposições incorretas sobre a base de código e ambiguidade de escopo.

**Linha do tempo** fornece uma visualização cronológica e com código de cores dos principais eventos durante a sessão:

| Color      | Meaning                |
| ---------- | ---------------------- |
| Red        | Issue de alto impacto  |
| Yellow     | Issue de impacto médio |
| White/Gray | Evento significativo   |
| Green      | Valor gerado           |

Cada evento na linha do tempo tem um título e uma descrição. Eventos vinculados a issues específicas aparecem em negrito. Use a linha do tempo para entender o fluxo da sessão — onde Devin fez progresso, onde encontrou obstáculos e como se recuperou.

<div id="actionable-feedback">
  ### Feedback acionável
</div>

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/BzEPrPG0ZPV9ZFyB/images/product-guides/session-insights-feedback.png?fit=max&auto=format&n=BzEPrPG0ZPV9ZFyB&q=85&s=805bcbf50bf8b313e6023c9f0d2d616b" alt="Session Insights Actionable Feedback" width="1474" height="1622" data-path="images/product-guides/session-insights-feedback.png" />
</Frame>

A aba Feedback acionável ajuda você a melhorar sessões futuras de duas maneiras:

**Prompt aprimorado** mostra uma versão reescrita do seu prompt original com melhorias específicas. O prompt sugerido é exibido com realce interativo: passe o cursor sobre uma seção sublinhada para ver o que mudou e por quê. Uma lista numerada de **Alterações feitas** abaixo do prompt explica cada modificação:

* Adicionar contexto ou restrições que estavam ausentes do original
* Esclarecer instruções ambíguas
* Incluir critérios de sucesso ou requisitos específicos
* Antecipar informações importantes de que o Devin precisava mais cedo

Clique em **Start new session** para iniciar uma nova sessão do Devin já preenchida com o prompt aprimorado.

**Action Items** lista alterações de configuração recomendadas para melhorar sessões futuras. Estas são ações concretas que você pode realizar na sua [configuração de ambiente](/pt-BR/onboard-devin/environment) ou no seu setup de [Knowledge](/pt-BR/product-guides/knowledge):

* **Configuração da Máquina** — alterações de ambiente ou ferramentas (por exemplo, instalar dependências ausentes, configurar acesso)
* **Repo config** — alterações em nível de repositório (por exemplo, adicionar scripts de build, atualizar arquivos de configuração)

Clique em **Go to machine** para ir diretamente à configuração da sua máquina e aplicar as alterações sugeridas.

<div id="knowledge-usage">
  ### Uso do Knowledge
</div>

<Frame>
  <img src="https://mintcdn.com/cognitionai-enterprise/BzEPrPG0ZPV9ZFyB/images/product-guides/session-insights-knowledge.png?fit=max&auto=format&n=BzEPrPG0ZPV9ZFyB&q=85&s=5acce6173a7bc33078e15c284f873ea6" alt="Session Insights Knowledge Usage" width="1456" height="674" data-path="images/product-guides/session-insights-knowledge.png" />
</Frame>

A aba Knowledge Usage mostra como seus itens de [Knowledge](/pt-BR/product-guides/knowledge) foram usados durante a sessão:

**Useful Knowledge** lista itens de Knowledge que ajudaram Devin a concluir a tarefa com sucesso, com uma explicação de como cada item foi aplicado.

**Misleading Knowledge** lista itens de Knowledge que levaram Devin a erros ou continham informações desatualizadas ou incorretas. Cada entrada explica por que aquele Knowledge foi prejudicial, ajudando você a identificar itens que precisam ser atualizados ou removidos.

Clique em qualquer item de Knowledge para ir diretamente até ele e editá-lo. Revisar essa aba regularmente ajuda você a manter uma base de conhecimento de alta qualidade.

<div id="interpreting-common-insight-patterns">
  ## Como interpretar padrões comuns de insights
</div>

<div id="high-acu-usage-with-few-user-messages">
  ### Alto uso de ACU com poucas mensagens de usuário
</div>

Isso geralmente significa que o Devin trabalhou de forma autônoma, mas teve dificuldades com a tarefa. Verifique o Issue Timeline em busca de erros recorrentes ou novas tentativas. Causas comuns:

* Configuração de ambiente ausente (dependências, chaves de API, credenciais de acesso)
* Requisitos ambíguos que levaram a abordagens de tentativa e erro
* Tarefas complexas que se beneficiariam de serem divididas em subtarefas

**O que fazer:** Revise o Improved Prompt em busca de sugestões sobre como adicionar contexto. Verifique os Action Items para mudanças de configuração de máquina ou repositório.

<div id="many-user-messages-with-low-acu-usage">
  ### Muitas mensagens do usuário com baixo consumo de ACU
</div>

Isso sugere interrupções frequentes ou correções de rota. Devin consumiu pouca computação, mas precisou de orientação constante. Causas comuns:

* Prompt inicial mal definido
* Devin interpretou incorretamente o escopo ou os requisitos da tarefa
* A tarefa exigia conhecimento específico de domínio não disponível para Devin

**O que fazer:** Use o Prompt aprimorado como modelo para futuras tarefas semelhantes. Adicione detalhes relevantes ao seu [Knowledge](/pt-BR/product-guides/knowledge) para que Devin possa acessá-los automaticamente.

<div id="misleading-knowledge-flagged">
  ### Knowledge Enganoso Sinalizado
</div>

Quando a aba Knowledge Usage mostra itens de Knowledge enganosos, esses itens podem conter instruções desatualizadas ou orientações genéricas demais que entram em conflito com sua base de código atual. Causas comuns:

* Knowledge foi escrito para uma versão anterior da sua base de código
* Knowledge é genérico demais e é recuperado em contextos irrelevantes
* Knowledge entra em conflito com outros itens de Knowledge

**O que fazer:** Atualize ou exclua os itens de Knowledge sinalizados. Torne as descrições de gatilho do Knowledge mais específicas para evitar recuperações irrelevantes.

<div id="session-classified-as-wrong-category">
  ### Sessão classificada na categoria errada
</div>

Se a categoria exibida na visão geral não corresponder ao que você tinha em mente, provavelmente significa que o Devin interpretou sua solicitação de forma diferente. Causas comuns:

* O prompt estava ambíguo em relação ao objetivo
* A descrição da tarefa focava em um aspecto, mas a intenção era outra (por exemplo, descrever um bug quando você queria uma funcionalidade)

**O que fazer:** Compare a categoria com a sua intenção. Use o Improved Prompt para ver como a análise recomenda esclarecer o objetivo da tarefa.

<div id="timeline-shows-repeated-issues">
  ### Linha do tempo mostra problemas repetidos
</div>

Quando o mesmo tipo de problema aparece várias vezes na linha do tempo, é provável que o Devin tenha ficado preso em um loop de tentativas. Causas comuns:

* Uma falha persistente de build ou teste que o Devin não conseguiu resolver
* Um problema de ambiente (ferramenta ausente, versão incorreta, erro de permissão)
* Um equívoco fundamental quanto à abordagem necessária

**O que fazer:** Verifique os Action Items em busca de correções de ambiente. Considere adicionar um item no [Knowledge](/pt-BR/product-guides/knowledge) que explique a abordagem correta para esse tipo de tarefa.

<div id="best-practices">
  ## Melhores práticas
</div>

<div id="review-insights-after-complex-sessions">
  ### Revise os Insights após sessões complexas
</div>

Crie o hábito de revisar o Session Insights após sessões importantes ou complexas. Os padrões que você identificar vão ajudá-lo a se tornar mais eficiente ao longo do tempo.

<div id="apply-prompt-improvements-iteratively">
  ### Aplique melhorias nos prompts de forma iterativa
</div>

Use os prompts aprimorados sugeridos como ponto de partida para tarefas semelhantes no futuro. Com o tempo, você desenvolverá uma biblioteca de padrões de prompts eficazes. Salve seus melhores prompts como [Playbooks](/pt-BR/product-guides/creating-playbooks) para fluxos de trabalho repetíveis.

<div id="maintain-your-knowledge-base">
  ### Mantenha sua base de conhecimento
</div>

Revise regularmente a guia Knowledge Usage para manter seus itens de Knowledge precisos e relevantes. Remova ou atualize rapidamente itens de Knowledge enganosos — um único item de Knowledge desatualizado pode comprometer a qualidade das sessões para toda a sua equipe.

<div id="address-recurring-issues-via-machine-setup">
  ### Resolva Problemas Recorrentes por Meio da Configuração da Máquina
</div>

Se os Itens de Ação estiverem sempre recomendando as mesmas alterações de ambiente ou configuração, resolva-as de forma proativa. Configurar corretamente a [configuração do seu ambiente](/pt-BR/onboard-devin/environment) evita que os mesmos problemas se repitam em todas as sessões futuras.

<div id="share-insights-with-your-team">
  ### Compartilhe insights com sua equipe
</div>

Session Insights pode revelar padrões que beneficiam toda a sua organização. Adicione aprendizados importantes como [Knowledge](/pt-BR/product-guides/knowledge) para que sua equipe também possa se beneficiar.

<div id="keep-sessions-focused">
  ### Mantenha as sessões focadas
</div>

Se suas sessões forem constantemente classificadas como L ou XL, divida tarefas grandes em sessões menores e mais focadas. Sessões menores tendem a produzir resultados melhores e são mais fáceis de analisar e iterar sobre elas.

<div id="troubleshooting">
  ## Solução de problemas
</div>

<div id="no-insights-available">
  ### Nenhum Insight Disponível
</div>

Se o Session Insights não estiver disponível para uma sessão, isso pode ser porque:

* A análise ainda não foi acionada — clique em **Generate Analysis** no modal Session Insights ou use o [endpoint da API para generate](/pt-BR/api-reference/v3/sessions/post-organizations-session-insights-generate)
* A sessão ainda está em andamento
* A sessão foi curta demais para gerar uma análise significativa (menos de uma mensagem do Devin)
* Ocorreu um erro durante o processo de análise — tente clicar em **Regenerate**

<div id="analysis-takes-too-long">
  ### A análise está demorando muito
</div>

A geração da análise normalmente é concluída em até um minuto. Se estiver em execução por mais de cinco minutos, o processo pode ter excedido o tempo limite. Feche e reabra o modal Session Insights e clique em **Regenerate**.

<div id="investigate-with-devin">
  ### Investigar com Devin
</div>

O botão **Investigate with Devin** no modal Session Insights abre uma nova sessão do Devin, pré-configurada para analisar em profundidade a sessão original. Use essa opção para sessões em que a análise automatizada por si só não explica totalmente o que aconteceu.