> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/otimizacao-do-agente/insights.md).

# Como usar os Insights do Agente

Os Insights do Agente analisam as conversas do seu agente automaticamente e propõem mudanças específicas para melhorar o desempenho.

Acesse no menu lateral em Agente > Insights.

## Como os Insights funcionam

Após analisar um lote de conversas, os Insights geram uma nova versão proposta do seu agente com uma mudança de comportamento específica. Cada insight mostra:

* O que mudar: a regra ou comportamento exato que o agente deve adotar
* Por quê: o padrão detectado nas conversas que explica o problema
* Raciocínio: as conversas e métricas específicas que apoiam a recomendação

## Como aplicar um insight

1. Abra Agente > Insights.
2. Revise a mudança proposta. Leia as seções Por quê e Raciocínio com cuidado antes de decidir.
3. Se a mudança fizer sentido para o seu negócio, clique em Aplicar Alterações. A Patagon AI cria automaticamente uma nova versão de rascunho com a mudança aplicada.
4. Teste a nova versão em Agente > Playground antes de ativá-la.
5. Acesse Agente > Geral > Versões e ative o rascunho quando estiver confiante de que ele tem melhor desempenho.

Se a mudança proposta não se encaixar no seu contexto, clique em Ignorar para descartá-la.

{% hint style="warning" %}
Sempre teste um insight no Playground antes de ativá-lo. Os insights são sugestões baseadas em dados de muitas conversas, mas o contexto específico do seu negócio pode tornar algumas sugestões irrelevantes.
{% endhint %}

## Como interpretar o raciocínio

Cada insight inclui o número de conversas analisadas, o padrão detectado e com que frequência ocorre, e as mudanças de comportamento propostas. Um bom insight tem grande tamanho de amostra (100+ conversas), um padrão claro com uma porcentagem específica e uma mudança proposta concreta e testável.

## Insights e versões

Toda vez que você aplica um insight, a Patagon AI cria automaticamente uma nova versão de rascunho. Se um insight aplicado não melhorar o desempenho, reverta para a versão anterior instantaneamente.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/otimizacao-do-agente/insights.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.